Enum SandboxMode

SandboxMode

Un'enum che rappresenta le modalità sandbox che possono essere utilizzate per gli script HtmlService lato client. Questi valori sono accessibili da HtmlService.SandboxMode e impostati chiamando HtmlOutput.setSandboxMode(mode).

Per chiamare un'enumerazione, devi chiamare la classe, il nome e la proprietà principali. Ad esempio, HtmlService.SandboxMode.IFRAME.

Le modalità NATIVE e EMULATED sono state ritirate il 13 ottobre 2015 ed entrambe sono state ritirate. Ora è supportata solo la modalità IFRAME.

Per proteggere gli utenti dalla pubblicazione di codice HTML o JavaScript dannoso, il codice lato client pubblicato dal servizio HTML viene eseguito in una sandbox per la sicurezza che impone limitazioni al codice. In precedenza, il metodo HtmlOutput.setSandboxMode(mode) consentiva agli autori di script di scegliere tra diverse versioni della sandbox, ma ora non ha alcun effetto. Per ulteriori informazioni, consulta la guida alle limitazioni nel servizio HTML.

La modalità IFRAME impone molte meno restrizioni rispetto alle altre modalità sandbox ed è più veloce, ma non funziona affatto in alcuni browser meno recenti, tra cui Internet Explorer 9. La modalità sandbox può essere letta anche in uno script lato client ispezionando google.script.sandbox.mode. Tieni presente che questa proprietà restituisce la modalità effettiva sul client, che potrebbe differire da quella richiesta sul server se la modalità richiesta non è supportata nel browser dell'utente.

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

Proprietà

ProprietàTipoDescrizione
EMULATEDEnumUna modalità sandbox precedente che emula la modalità restrittiva di ECMAScript 5 utilizzando solo le funzionalità disponibili in ECMAScript 3. Questa modalità era quella predefinita prima di febbraio 2014.

EMULATED era trasmesso il 10 dicembre 2015. Tutti gli script che tentano di utilizzare EMULATED useranno invece IFRAME.

IFRAMEEnumUna modalità sandbox che utilizza il sandboxing iframe anziché la tecnologia sandbox Caja utilizzata dalle modalità EMULATED e NATIVE. Questa modalità è quella predefinita per i nuovi script a partire dal 12 novembre 2015 e per tutti gli script a partire dal 6 luglio 2016.

Questa modalità impone molte meno restrizioni rispetto alle altre modalità sandbox ed è più veloce, ma non funziona affatto in alcuni browser meno recenti, tra cui Internet Explorer 9.

NATIVEEnumUna modalità sandbox basata su quella restrittiva di ECMAScript 5. Una modalità sandbox basata sulla modalità restrittiva di ECMAScript 5. Questa modalità era disattivata il 6 luglio 2016. Tutti gli script ora utilizzano la modalità IFRAME.