Enum SandboxMode

SandboxMode

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คำอธิบาย
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