Enum SandboxMode

โหมดแซนด์บ็อกซ์

การแจงนับที่แสดงโหมดแซนด์บ็อกซ์ที่ใช้กับสคริปต์ฝั่งไคลเอ็นต์ HtmlService ได้ เข้าถึงค่าเหล่านี้ได้จาก HtmlService.SandboxMode และตั้งค่าได้โดยการเรียกใช้ HtmlOutput.setSandboxMode(mode)

หากต้องการเรียกใช้ Enum ให้เรียกใช้คลาสหลัก ชื่อ และพร็อพเพอร์ตี้ของ Enum เช่น HtmlService.SandboxMode.IFRAME

โหมด NATIVE และ EMULATED เลิกใช้งานเมื่อวันที่ 13 ตุลาคม 2015 และทั้ง 2 โหมดนี้ปิดตัวลงแล้ว ตอนนี้ระบบรองรับเฉพาะโหมด IFRAME

โค้ดฝั่งไคลเอ็นต์ที่แสดงจาก บริการ HTML จะทำงานในแซนด์บ็อกซ์ด้านความปลอดภัยที่กำหนดข้อจำกัดในโค้ด เพื่อปกป้องผู้ใช้จากการแสดง HTML หรือ JavaScript ที่เป็นอันตราย เมธอด 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>

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ประเภทคำอธิบาย
EMULATEDEnumโหมดแซนด์บ็อกซ์เดิมที่จำลองโหมดเข้มงวดของ ECMAScript 5 โดยใช้เฉพาะฟีเจอร์ที่มีใน ECMAScript 3 โหมดนี้เป็นค่าเริ่มต้นก่อนเดือนกุมภาพันธ์ 2014

EMULATEDหยุดให้บริการตั้งแต่วันที่ 10 ธันวาคม 2015 ตอนนี้สคริปต์ทั้งหมดที่พยายามใช้ EMULATED จะใช้ IFRAME แทน
IFRAMEEnumโหมดแซนด์บ็อกซ์ที่ใช้แซนด์บ็อกซ์ iframe แทนเทคโนโลยีแซนด์บ็อกซ์ Caja ที่ใช้ในโหมด EMULATED และ NATIVE โหมดนี้เป็นค่าเริ่มต้นสำหรับสคริปต์ใหม่ตั้งแต่วันที่ 12 พฤศจิกายน 2015 และสำหรับสคริปต์ทั้งหมดตั้งแต่วันที่ 6 กรกฎาคม 2016

โหมดนี้มีข้อจำกัดน้อยกว่าโหมดแซนด์บ็อกซ์อื่นๆ มากและทำงานได้เร็วที่สุด แต่ ไม่ทำงานเลยในเบราว์เซอร์รุ่นเก่าบางรุ่น รวมถึง Internet Explorer 9
NATIVEEnumโหมดแซนด์บ็อกซ์ที่สร้างขึ้นบนโหมดเข้มงวดของ ECMAScript 5 โหมดแซนด์บ็อกซ์ที่สร้างขึ้นบน โหมดเข้มงวดของ ECMAScript 5 เราได้หยุดให้บริการโหมดนี้ ตั้งแต่วันที่ 6 กรกฎาคม 2016 ตอนนี้สคริปต์ทั้งหมดใช้โหมด IFRAME