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)
.
Mode NATIVE
dan EMULATED
tidak digunakan lagi pada 13 Oktober 2015 dan keduanya kini akan dihentikan. Hanya
mode IFRAME
yang kini didukung.
Agar pengguna tidak menerima HTML atau JavaScript berbahaya, kode sisi klien yang ditayangkan dari layanan HTML dieksekusi di sandbox keamanan yang memberlakukan batasan pada kode tersebut. Metode
HtmlOutput.setSandboxMode(mode)
sebelumnya mengizinkan penulis skrip untuk memilih
antara versi sandbox yang berbeda, tetapi sekarang tidak berpengaruh. Untuk informasi selengkapnya, lihat
panduan pembatasan dalam layanan HTML.
Mode IFRAME
menerapkan lebih sedikit pembatasan 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 pada klien, yang mungkin berbeda dari mode yang diminta pada server jika mode yang diminta tidak didukung dalam 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 mengemulasi mode ketat ECMAScript 5 hanya menggunakan fitur yang tersedia
di ECMAScript 3. Mode ini merupakan setelan default sebelum Februari 2014.
|
IFRAME | Enum | Mode sandbox yang menggunakan sandbox iframe, bukan teknologi sandbox Caja, yang digunakan oleh mode
EMULATED dan NATIVE . Mode ini merupakan setelan default untuk skrip baru mulai
12 November 2015 dan untuk semua skrip mulai 6 Juli 2016.
Mode ini memberlakukan lebih sedikit pembatasan 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 dibuat di atas mode ketat ECMAScript 5. Mode sandbox yang dibuat berdasarkan mode ketat ECMAScript 5. Mode ini dihentikan
mulai 6 Juli 2016. Semua skrip sekarang menggunakan mode IFRAME . |