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>