เพื่อปกป้องผู้ใช้จากการถูกแสดง HTML หรือ JavaScript ที่เป็นอันตราย Apps Script ใช้ iframe กับเว็บแอปที่ให้บริการ HTML ของแซนด์บ็อกซ์หรืออินเทอร์เฟซผู้ใช้ที่กำหนดเองสำหรับ Google เอกสาร ชีต และฟอร์ม (บริการ HTML ไม่ใช้แซนด์บ็อกซ์ในสถานการณ์อื่นๆ เช่น การสร้างเนื้อความของอีเมล) แซนด์บ็อกซ์มีข้อจำกัดในโค้ดฝั่งไคลเอ็นต์
โหมดแซนด์บ็อกซ์
เราเลิกใช้โหมดแซนด์บ็อกซ์ทั้งหมดแล้ว ยกเว้น IFRAME
ตอนนี้แอปที่ใช้โหมดแซนด์บ็อกซ์รุ่นเก่าจะใช้โหมด IFRAME
ที่ใหม่กว่าโดยอัตโนมัติ หากคุณมีสคริปต์ที่พัฒนาขึ้นโดยใช้โหมดเก่า (NATIVE
และ EMULATED
) คุณควรทำตามวิธีการย้ายข้อมูลเพื่อให้มั่นใจว่าสคริปต์ทำงานอย่างถูกต้องภายใต้โหมด IFRAME
ตอนนี้เมธอด setSandboxMode
จะไม่มีผลเมื่อเรียกใช้
ข้อจำกัดในโหมด iframe
โหมดแซนด์บ็อกซ์ IFRAME
อิงตามฟีเจอร์แซนด์บ็อกซ์ของ iframe ใน HTML5 โดยใช้คีย์เวิร์ดต่อไปนี้
allow-same-origin
allow-forms
allow-scripts
allow-popups
allow-downloads
allow-modals
allow-popups-to-escape-sandbox
allow-top-navigation-by-user-activation
- แอตทริบิวต์นี้ตั้งค่าไว้สำหรับโปรเจ็กต์สคริปต์แบบสแตนด์อโลนเท่านั้น
คีย์เวิร์ด allow-top-navigation
ที่ช่วยให้เนื้อหาไปยังส่วนต่างๆ ของบริบทการท่องเว็บระดับบนสุดจะถูกจำกัดและไม่ได้ตั้งเป็นแอตทริบิวต์ในแซนด์บ็อกซ์ หากต้องการเปลี่ยนเส้นทางสคริปต์ ให้เพิ่มลิงก์หรือปุ่มให้ผู้ใช้ดำเนินการแทน
การตั้งค่าแอตทริบิวต์เป้าหมายของลิงก์
ในโหมด IFRAME
คุณต้องตั้งค่าแอตทริบิวต์เป้าหมายลิงก์เป็น _top
หรือ _blank
Code.js
function doGet() {
var template = HtmlService.createTemplateFromFile('top');
return template.evaluate().setSandboxMode(HtmlService.SandboxMode.IFRAME);
}
top.html
<!DOCTYPE html>
<html>
<body>
<div>
<a href="http://google.com" target="_top">Click Me!</a>
</div>
</body>
</html>
นอกจากนี้ คุณยังลบล้างแอตทริบิวต์นี้ได้โดยใช้แท็ก <base>
ภายในส่วนหัวของหน้าเว็บที่ล้อมรอบอยู่ ดังนี้
<!DOCTYPE html>
<html>
<head>
<base target="_top">
</head>
<body>
<div>
<a href="http://google.com">Click Me!</a>
</div>
</body>
</html>
ต้องใช้ HTTPS สำหรับเนื้อหาที่ใช้งานอยู่
เนื้อหาที่"ใช้งานอยู่" เช่น สคริปต์ สไตล์ชีตภายนอก และ XmlHttpRequests ต้องโหลดผ่าน HTTPS ไม่ใช่ HTTP