Enum SandboxMode

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>

属性

媒体资源类型说明
EMULATEDEnum旧版沙盒模式，仅使用 ECMAScript 3 中提供的功能模拟 ECMAScript 5 严格模式。此模式在 2014 年 2 月之前是默认模式。

EMULATED 自 2015 年 12 月 10 日起停用。所有尝试使用 EMULATED 的脚本现在都将改用 IFRAME。
IFRAMEEnum一种沙盒模式，使用 iframe 沙盒（而非 EMULATED 和 NATIVE 模式所用的 Caja 沙盒技术）。自 2015 年 11 月 12 日起，新脚本以及 2016 年 7 月 6 日起的所有脚本均默认使用此模式。

与其他沙盒模式相比，此模式施加的限制要少得多，并且运行速度最快，但在某些旧版浏览器（包括 Internet Explorer 9）中根本不起作用。
NATIVEEnum基于 ECMAScript 5 严格模式构建的沙盒模式。基于 ECMAScript 5 严格模式构建的沙盒模式。此模式已于 2016 年 7 月 6 日停用。所有脚本现在都使用 IFRAME 模式。