Enum SandboxMode

SandboxMode

Una enumeración que representa los modos de la zona de pruebas que se pueden usar para HtmlService del cliente secuencias de comandos. Se puede acceder a estos valores desde HtmlService.SandboxMode y configurarlos llamando HtmlOutput.setSandboxMode(mode)

Para llamar a una enumeración, debes llamar a su clase superior, nombre y propiedad. Por ejemplo,  HtmlService.SandboxMode.IFRAME.

Los modos NATIVE y EMULATED dejaron de estar disponibles el 13 de octubre de 2015 y ambos se descontinuaron. Solo Ahora se admite el modo IFRAME.

Para proteger a los usuarios de códigos HTML o JavaScript maliciosos, el código del cliente que se publica El servicio HTML se ejecuta en una zona de pruebas de seguridad que impone restricciones al código. El método Anteriormente, HtmlOutput.setSandboxMode(mode) permitía elegir a los autores de secuencias de comandos entre las diferentes versiones de la zona de pruebas, pero ahora no tiene efecto. Para obtener más información, consulta la guía sobre restricciones en el servicio HTML.

El modo IFRAME impone muchas menos restricciones que los otros modos de zona de pruebas y se ejecuta. más rápido, pero no funciona en absoluto en ciertos navegadores más antiguos, como Internet Explorer 9. El El modo de zona de pruebas también se puede leer en una secuencia de comandos del cliente mediante la inspección de google.script.sandbox.mode. Ten en cuenta que esta propiedad muestra el modo real en el cliente, puede diferir del modo solicitado en el servidor si el modo solicitado no se admite en la navegador del usuario.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Propiedades

PropiedadTipoDescripción
EMULATEDEnumUn modo de zona de pruebas heredado que emula el modo estricto de ECMAScript 5 usando solo las funciones disponibles en ECMAScript 3. Este modo era el predeterminado antes de febrero de 2014.

EMULATED se atardó el 10 de diciembre, 2015. Todas las secuencias de comandos que intentan usar EMULATED ahora usarán IFRAME en su lugar.

IFRAMEEnumUn modo de zona de pruebas que utiliza la zona de pruebas de iframe en lugar de la tecnología de espacio aislado de Caja Modos EMULATED y NATIVE. Este es el modo predeterminado para nuevas secuencias de comandos a partir de 12 de noviembre de 2015 y para todos los guiones a partir del 6 de julio de 2016.

Este modo impone muchas menos restricciones que los otros modos de zona de pruebas y se ejecuta más rápido, pero No funciona en absoluto en algunos navegadores más antiguos, como Internet Explorer 9.

NATIVEEnumEs un modo de zona de pruebas creado sobre el modo estricto de ECMAScript 5. Un modo de zona de pruebas construido sobre Modo estricto de ECMAScript 5. Este modo se desactivó como del 6 de julio de 2016. Todas las secuencias de comandos ahora usan el modo IFRAME.