Enum SandboxMode

ModeSandbox

Enum yang mewakili mode sandbox yang dapat digunakan untuk skrip HtmlService sisi klien. Nilai ini dapat diakses dari HtmlService.SandboxMode, dan ditetapkan dengan memanggil HtmlOutput.setSandboxMode(mode).

Untuk memanggil enum, Anda memanggil class induk, nama, dan propertinya. Misalnya, HtmlService.SandboxMode.IFRAME.

Mode NATIVE dan EMULATED tidak digunakan lagi pada 13 Oktober 2015 dan keduanya kini tidak digunakan lagi. Hanya mode IFRAME yang sekarang didukung.

Untuk melindungi pengguna agar tidak menerima HTML atau JavaScript berbahaya, kode sisi klien yang ditayangkan dari layanan HTML akan dijalankan di sandbox keamanan yang memberlakukan batasan pada kode. Metode HtmlOutput.setSandboxMode(mode) sebelumnya memungkinkan penulis skrip memilih antara berbagai versi sandbox, tetapi sekarang tidak berpengaruh. Untuk mengetahui informasi selengkapnya, lihat panduan pembatasan dalam layanan HTML.

Mode IFRAME menerapkan lebih sedikit batasan daripada mode sandbox lainnya dan berjalan paling cepat, tetapi tidak berfungsi sama sekali di browser lama tertentu, termasuk Internet Explorer 9. Mode sandbox juga dapat dibaca dalam skrip sisi klien dengan memeriksa google.script.sandbox.mode. Perhatikan bahwa properti ini menampilkan mode sebenarnya di klien, yang mungkin berbeda dengan mode yang diminta di server jika mode yang diminta tidak didukung di browser pengguna. 

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

Properti

PropertiJenisDeskripsi
EMULATEDEnumMode sandbox lama yang mengemulasi mode ketat ECMAScript 5 hanya menggunakan fitur yang tersedia di ECMAScript 3. Mode ini adalah setelan default sebelum Februari 2014.

EMULATED dihentikan mulai 10 Desember 2015. Semua skrip yang mencoba menggunakan EMULATED kini akan menggunakan IFRAME.
IFRAMEEnumMode sandbox yang menggunakan sandbox iframe, bukan teknologi sandbox Caja yang digunakan oleh mode EMULATED dan NATIVE. Mode ini adalah mode default untuk skrip baru mulai 12 November 2015 dan untuk semua skrip mulai 6 Juli 2016.

Mode ini menerapkan lebih sedikit batasan daripada mode sandbox lainnya dan berjalan paling cepat, tetapi tidak berfungsi sama sekali di browser lama tertentu, termasuk Internet Explorer 9.
NATIVEEnumMode sandbox yang dibuat di atas mode ketat ECMAScript 5. Mode sandbox yang dibuat di atas mode ketat ECMAScript 5. Mode ini dihentikan pada 6 Juli 2016. Semua skrip kini menggunakan mode IFRAME.