enum ที่แสดงถึงโหมดแซนด์บ็อกซ์ที่สามารถใช้สำหรับสคริปต์ HtmlService
ฝั่งไคลเอ็นต์ ค่าเหล่านี้เข้าถึงได้จาก HtmlService.SandboxMode
และตั้งค่าด้วยการเรียกใช้ HtmlOutput.setSandboxMode(mode)
หากต้องการเรียก enum คุณจะต้องเรียกคลาส ชื่อ และพร็อพเพอร์ตี้ระดับบนสุด เช่น
HtmlService.SandboxMode.IFRAME
เราได้เลิกใช้งานโหมด NATIVE
และ EMULATED
ในวันที่ 13 ตุลาคม 2015 และทั้งสองโหมดหยุดให้บริการแล้ว รองรับเฉพาะโหมด IFRAME
เท่านั้น
เพื่อปกป้องผู้ใช้จากการถูกแสดง HTML หรือ JavaScript ที่เป็นอันตราย โค้ดฝั่งไคลเอ็นต์ที่เรียกใช้จากบริการ HTML จะทำงานในแซนด์บ็อกซ์ความปลอดภัยซึ่งกำหนดข้อจํากัดกับโค้ด เมธอด HtmlOutput.setSandboxMode(mode)
ก่อนหน้านี้อนุญาตให้ผู้เขียนสคริปต์เลือกแซนด์บ็อกซ์เวอร์ชันต่างๆ ได้ แต่ขณะนี้ไม่มีผลใดๆ ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำเกี่ยวกับข้อจำกัดของบริการ HTML
โหมด IFRAME
สร้างข้อจำกัดน้อยกว่าโหมดแซนด์บ็อกซ์อื่นๆ มากและทำงานได้เร็วที่สุด แต่ไม่ทำงานเลยในเบราว์เซอร์รุ่นเก่าบางรุ่น รวมถึง Internet Explorer 9 อ่านโหมดแซนด์บ็อกซ์ในสคริปต์ฝั่งไคลเอ็นต์ได้โดยตรวจสอบ google.script.sandbox.mode
โปรดทราบว่าพร็อพเพอร์ตี้นี้แสดงโหมดจริงในไคลเอ็นต์ ซึ่งอาจต่างจากโหมดที่ขอบนเซิร์ฟเวอร์หากเบราว์เซอร์ของผู้ใช้ไม่รองรับโหมดที่ขอ
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | Type | คำอธิบาย |
---|---|---|
EMULATED | Enum | โหมดแซนด์บ็อกซ์เดิมที่จำลองโหมดเข้มงวดของ ECMAScript 5 โดยใช้เฉพาะฟีเจอร์ที่มีอยู่ใน ECMAScript 3 โหมดนี้เป็นค่าเริ่มต้นในช่วงก่อนเดือนกุมภาพันธ์ 2014
|
IFRAME | Enum | โหมดแซนด์บ็อกซ์ที่ใช้แซนด์บ็อกซ์ iframe แทนเทคโนโลยีแซนด์บ็อกซ์ Caja ที่โหมด EMULATED และ NATIVE ใช้งาน โหมดนี้เป็นค่าเริ่มต้นสำหรับสคริปต์ใหม่ตั้งแต่วันที่ 12 พฤศจิกายน 2015 และสำหรับสคริปต์ทั้งหมดตั้งแต่วันที่ 6 กรกฎาคม 2016
โหมดนี้กำหนดข้อจำกัดน้อยกว่าโหมดแซนด์บ็อกซ์อื่นๆ มากและทำงานได้เร็วที่สุด แต่จะไม่ทำงานเลยในเบราว์เซอร์รุ่นเก่าบางเบราว์เซอร์ รวมทั้ง Internet Explorer 9 |
NATIVE | Enum | โหมดแซนด์บ็อกซ์ที่สร้างขึ้นจากโหมดเข้มงวดของ ECMAScript 5 โหมดแซนด์บ็อกซ์ที่สร้างบน
โหมดเข้มงวดของ ECMAScript 5 โหมดนี้พระอาทิตย์ตกเมื่อวันที่ 6 กรกฎาคม 2016 ขณะนี้สคริปต์ทั้งหมดใช้โหมด IFRAME |