Một enum đại diện cho các chế độ hộp cát có thể dùng cho HtmlService
phía máy khách
các tập lệnh. Bạn có thể truy cập vào các giá trị này từ HtmlService.SandboxMode
và thiết lập bằng cách gọi
HtmlOutput.setSandboxMode(mode)
Để gọi một enum, bạn phải gọi lớp, tên và thuộc tính mẹ của lớp đó. Ví dụ:
HtmlService.SandboxMode.IFRAME
.
Chế độ NATIVE
và EMULATED
đã không được dùng nữa từ ngày 13 tháng 10 năm 2015 và cả hai chế độ này hiện đều đã ngừng hoạt động. Chỉ
Chế độ IFRAME
hiện đã được hỗ trợ.
Để bảo vệ người dùng khỏi bị phân phát HTML hoặc JavaScript độc hại, mã phía máy khách được phân phát từ
Dịch vụ HTML thực thi trong một hộp cát bảo mật có áp dụng các hạn chế đối với mã. Phương thức
HtmlOutput.setSandboxMode(mode)
tác giả tập lệnh đã được cho phép trước đây để chọn
giữa các phiên bản khác nhau của hộp cát nhưng hiện không có hiệu lực. Để biết thêm thông tin, hãy xem
hướng dẫn về các hạn chế trong dịch vụ HTML.
Chế độ IFRAME
áp dụng ít hạn chế hơn so với các chế độ hộp cát khác và chạy
nhanh nhất, nhưng hoàn toàn không hoạt động ở một số trình duyệt cũ hơn, bao gồm cả Internet Explorer 9. Chiến lược phát hành đĩa đơn
Bạn cũng có thể đọc chế độ hộp cát trong tập lệnh phía máy khách bằng cách kiểm tra google.script.sandbox.mode
. Xin lưu ý rằng thuộc tính này trả về chế độ thực tế trên ứng dụng khách
có thể khác với chế độ được yêu cầu trên máy chủ nếu chế độ bạn yêu cầu không được hỗ trợ trong
trình duyệt của người dùng.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Thuộc tính
Thuộc tính | Loại | Mô tả |
---|---|---|
EMULATED | Enum | Chế độ hộp cát cũ mô phỏng chế độ nghiêm ngặt ECMAScript 5 chỉ bằng các tính năng có sẵn
trong ECMAScript 3. Đây là chế độ mặc định trước tháng 2 năm 2014.
|
IFRAME | Enum | Chế độ hộp cát sử dụng hộp cát iframe thay vì công nghệ hộp cát Caja mà
Chế độ EMULATED và NATIVE . Đây là chế độ mặc định cho các tập lệnh mới kể từ
Ngày 12 tháng 11 năm 2015 và đối với tất cả các tập lệnh tính đến ngày 6 tháng 7 năm 2016.
Chế độ này áp dụng ít hạn chế hơn so với các chế độ hộp cát khác và chạy nhanh nhất, nhưng không hoạt động trên một số trình duyệt cũ hơn, bao gồm cả Internet Explorer 9. |
NATIVE | Enum | Chế độ hộp cát được xây dựng dựa trên chế độ nghiêm ngặt ECMAScript 5. Một chế độ hộp cát được xây dựng dựa trên
Chế độ nghiêm ngặt ECMAScript 5. Chế độ này đã ngừng hoạt động
kể từ ngày 6 tháng 7 năm 2016. Tất cả tập lệnh hiện đều sử dụng chế độ IFRAME . |