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>