クライアント側の 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>
プロパティ
プロパティ | タイプ | 説明 |
---|---|---|
EMULATED | Enum | 利用可能な機能のみを使用して ECMAScript 5 の厳格モードをエミュレートする従来のサンドボックス モード
ECMAScript 3 で記述します。2014 年 2 月以前は、このモードがデフォルトでした。
|
IFRAME | Enum | サンドボックス モードを使用すると、
EMULATED モードと NATIVE モード。以降は、このモードが新しいスクリプトの
2015 年 11 月 12 日、およびすべてのスクリプトが 2016 年 7 月 6 日時点のものです。
このモードは、他のサンドボックス モードよりも制限が少なく、最も高速に実行されますが、 は、Internet Explorer 9 など、一部の古いブラウザではまったく機能しません。 |
NATIVE | Enum | ECMAScript 5 の厳格モードの上に構築されたサンドボックス モード。Google Kubernetes Engine を基盤として構築された
ECMAScript 5 の厳格モード。このモードは廃止日:
(2016 年 7 月 6 日)をご覧ください。すべてのスクリプトで IFRAME モードが使用されるようになりました。 |