Enum SandboxMode

SandboxMode

Un'enumerazione che rappresenta le modalità sandbox che possono essere utilizzate per HtmlService lato client script. È possibile accedere a questi valori da HtmlService.SandboxMode e impostarli 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. Solo La modalità IFRAME è ora supportata.

Per impedire agli utenti di ricevere codici HTML o JavaScript dannosi, è stato pubblicato codice lato client Il servizio HTML viene eseguito in una sandbox per la sicurezza che impone restrizioni al codice. Il metodo HtmlOutput.setSandboxMode(mode) autori di script autorizzati in precedenza da scegliere tra diverse versioni della sandbox, ma ora non ha alcun effetto. Per ulteriori informazioni, consulta guida alle limitazioni del servizio HTML.

La modalità IFRAME impone molte meno limitazioni e le altre modalità della sandbox più veloce, ma non funziona affatto con alcuni browser meno recenti, tra cui Internet Explorer 9. La La modalità sandbox può essere letta anche in uno script lato client controllando google.script.sandbox.mode. Tieni presente che questa proprietà restituisce la modalità effettiva sul client, che può essere diversa da quella richiesta sul server se la modalità richiesta non è supportata nel 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 quella predefinita prima di febbraio 2014.

La funzionalità EMULATED è stata disattivata il 10 dicembre 2015, Tutti gli script che tentano di utilizzare EMULATED ora utilizzeranno IFRAME.

IFRAMEEnumUna modalità sandbox che utilizza la sandbox iframe al posto della tecnologia sandbox Caja utilizzata Modalità EMULATED e NATIVE. Questa modalità è l'impostazione 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 funziona più velocemente, ma non funziona affatto con alcuni browser meno recenti, tra cui Internet Explorer 9.

NATIVEEnumUna modalità sandbox basata sulla modalità Strict di ECMAScript 5. Una modalità sandbox basata su modalità con restrizioni ECMAScript 5. Questa modalità è stata disattivata come del 6 luglio 2016. Tutti gli script ora utilizzano la modalità IFRAME.