Enum SandboxMode

SandboxMode

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

Untuk memanggil enum, Anda memanggil class, nama, dan properti induknya. Misalnya, HtmlService.SandboxMode.IFRAME.

Mode NATIVE dan EMULATED tidak digunakan lagi mulai 13 Oktober 2015 dan keduanya kini dihentikan. Hanya Mode IFRAME kini didukung.

Untuk melindungi pengguna agar tidak melihat HTML atau JavaScript berbahaya, kode sisi klien disajikan dari Layanan HTML dijalankan di sandbox keamanan yang memberlakukan pembatasan pada kode. Metode HtmlOutput.setSandboxMode(mode) sebelumnya mengizinkan pilihan penulis skrip di antara berbagai versi {i>sandbox<i}, tetapi sekarang tidak berpengaruh. Untuk informasi selengkapnya, lihat panduan batasan dalam layanan HTML.

Mode IFRAME menerapkan batasan yang jauh lebih sedikit daripada mode sandbox lainnya dan menjalankan tercepat, tetapi tidak berfungsi sama sekali di browser lama tertentu, termasuk Internet Explorer 9. Tujuan mode sandbox juga dapat dibaca dalam skrip sisi klien dengan memeriksa google.script.sandbox.mode. Perhatikan bahwa properti ini menampilkan mode aktual pada klien, yang mungkin berbeda dari mode yang diminta pada server jika mode yang diminta tidak didukung di pada 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 dengan hanya menggunakan fitur yang tersedia di ECMAScript 3. Mode ini adalah mode default sebelum Februari 2014.

EMULATED terbenam per 10 Desember, 2015. Semua skrip yang mencoba menggunakan EMULATED sekarang akan menggunakan IFRAME.

IFRAMEEnumMode sandbox yang menggunakan sandbox iframe bukan teknologi sandbox Caja yang digunakan oleh Mode EMULATED dan NATIVE. Mode ini adalah {i>default<i} untuk skrip baru mulai 12 November 2015 dan untuk semua skrip per 6 Juli 2016.

Mode ini menerapkan batasan yang jauh lebih sedikit daripada mode {i>sandbox<i} lainnya dan berjalan paling cepat, tetapi tidak berfungsi sama sekali di beberapa browser lama tertentu, termasuk Internet Explorer 9.

NATIVEEnumMode sandbox yang dibuat berdasarkan mode ketat ECMAScript 5. Mode {i>sandbox<i} yang dibangun di atas Mode ketat ECMAScript 5. Mode ini terbenam sebagai 6 Juli 2016. Semua skrip kini menggunakan mode IFRAME.