Enum SandboxMode

Modalità sandbox

Un'enumerazione che rappresenta le modalità sandbox che possono essere utilizzate per gli script HtmlService lato client. È possibile accedere a questi valori da HtmlService.SandboxMode e impostarli chiamando HtmlOutput.setSandboxMode(mode).

Per chiamare un'enumerazione, chiama la relativa classe padre, il nome e la proprietà. Ad esempio, HtmlService.SandboxMode.IFRAME.

Le modalità NATIVE e EMULATED sono state ritirate il 13 ottobre 2015 e ora non sono più disponibili. Ora è supportata solo la modalità IFRAME.

Per proteggere gli utenti dalla pubblicazione di HTML o JavaScript dannosi, il codice lato client pubblicato dal servizio HTML viene eseguito in una sandbox di sicurezza che impone restrizioni al codice. Il metodo HtmlOutput.setSandboxMode(mode) in precedenza 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 limitazioni rispetto alle altre modalità sandbox e viene eseguita più velocemente, 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 esaminando google.script.sandbox.mode. Tieni presente che questa proprietà restituisce la modalità effettiva sul client, che potrebbe differire dalla modalità 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 legacy che emula la modalità Strict di ECMAScript 5 utilizzando solo le funzionalità disponibili in ECMAScript 3. Questa modalità era l'impostazione predefinita prima di febbraio 2014.

EMULATED è stato ritirato a partire dal 10 dicembre 2015. Tutti gli script che tentano di utilizzare EMULATED ora utilizzeranno IFRAME.
IFRAMEEnumUna modalità sandbox che utilizza la sandbox 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 e viene eseguita più velocemente, ma non funziona affatto in alcuni browser meno recenti, tra cui Internet Explorer 9.
NATIVEEnumUna modalità sandbox basata sulla modalità rigida ECMAScript 5. Una modalità sandbox basata sulla modalità StrictMode di ECMAScript 5. Questa modalità è stata ritirata il 6 luglio 2016. Ora tutti gli script utilizzano la modalità IFRAME.