Enum yang merepresentasikan mode sandbox yang dapat digunakan untuk skrip sisi klien HtmlService
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 telah
dihentikan pada 13 Oktober 2015 dan keduanya kini tidak digunakan lagi. Sekarang hanya mode IFRAME yang didukung.
Untuk melindungi pengguna dari HTML atau JavaScript berbahaya, kode sisi klien yang ditayangkan dari layanan HTML dijalankan di sandbox keamanan yang memberlakukan batasan pada kode. Metode
HtmlOutput.setSandboxMode(mode) sebelumnya memungkinkan penulis skrip memilih
antara berbagai versi sandbox, tetapi kini tidak berpengaruh. Untuk mengetahui informasi selengkapnya, lihat
panduan tentang batasan 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 dari 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
| Properti | Jenis | Deskripsi |
|---|---|---|
EMULATED | Enum | Mode sandbox lama yang meniru mode ketat ECMAScript 5 hanya menggunakan fitur yang tersedia
di ECMAScript 3. Mode ini adalah default sebelum Februari 2014.
|
IFRAME | Enum | Mode sandbox yang menggunakan sandboxing 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. |
NATIVE | Enum | Mode sandbox yang dibangun di atas mode ketat ECMAScript 5. Mode sandbox yang dibangun di atas mode ketat ECMAScript 5. Mode ini dihentikan sejak
6 Juli 2016. Semua skrip kini menggunakan mode IFRAME. |