表示可用于客户端 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 3 中提供的功能模拟 ECMAScript 5 严格模式。此模式在 2014 年 2 月之前是默认模式。
|
IFRAME | Enum | 一种沙盒模式,使用 iframe 沙盒(而非 EMULATED 和 NATIVE 模式所用的 Caja 沙盒技术)。自 2015 年 11 月 12 日起,新脚本以及 2016 年 7 月 6 日起的所有脚本均默认使用此模式。
与其他沙盒模式相比,此模式施加的限制要少得多,并且运行速度最快,但在某些旧版浏览器(包括 Internet Explorer 9)中根本不起作用。 |
NATIVE | Enum | 基于 ECMAScript 5 严格模式构建的沙盒模式。基于 ECMAScript 5 严格模式构建的沙盒模式。此模式已于 2016 年 7 月 6 日停用。所有脚本现在都使用 IFRAME 模式。 |