Enum SandboxMode

クライアントサイドの HtmlService スクリプトで使用できるサンドボックス モードを表す列挙型。これらの値には HtmlService.SandboxMode からアクセスでき、HtmlOutput.setSandboxMode(mode) を呼び出すことで設定できます。

列挙型を呼び出すには、親クラス、名前、プロパティを呼び出します。たとえば、 HtmlService.SandboxMode.IFRAME です。

NATIVE モードと EMULATED モードは 2015 年 10 月 13 日に非推奨となり、現在は両方とも提供を終了しています。現在サポートされているのは IFRAME モードのみです。

悪意のある HTML や JavaScript がユーザーに配信されるのを防ぐため、HTML サービスから配信されるクライアントサイド コードは、コードに制限を課すセキュリティ サンドボックスで実行されます。メソッド HtmlOutput.setSandboxMode(mode) では、以前はスクリプト作成者がさまざまなバージョンのサンドボックスを選択できましたが、現在は効果がありません。詳しくは、HTML サービスの制限に関するガイドをご覧ください。

IFRAME モードは、他のサンドボックス モードよりも制限が少なく、最も高速に動作しますが、Internet Explorer 9 など、一部の古いブラウザではまったく動作しません。サンドボックス モードは、google.script.sandbox.mode を調べることでクライアントサイド スクリプトで読み取ることもできます。このプロパティはクライアントの実際のモードを返します。リクエストされたモードがユーザーのブラウザでサポートされていない場合、サーバーでリクエストされたモードと異なることがあります。

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>