Enum SandboxMode

SandboxMode

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ế độ NATIVEEMULATED đã 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ínhLoạiMô tả
EMULATEDEnumChế độ 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.

EMULATED đã ngừng hoạt động kể từ ngày 10 tháng 12 2015. Giờ đây, tất cả tập lệnh cố gắng sử dụng EMULATED sẽ sử dụng IFRAME.

IFRAMEEnumChế độ hộp cát sử dụng hộp cát iframe thay vì công nghệ hộp cát Caja mà Chế độ EMULATEDNATIVE. Đâ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.

NATIVEEnumChế độ 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.