Enum SandboxMode

Một enum đại diện cho các chế độ hộp cát có thể dùng cho tập lệnh HtmlService bên máy khách. Bạn có thể truy cập vào các giá trị này từ HtmlService.SandboxMode và đặt bằng cách gọi HtmlOutput.setSandboxMode(mode).

Để gọi một enum, bạn gọi lớp mẹ, tên và thuộc tính của enum đó. Ví dụ: HtmlService.SandboxMode.IFRAME.

Các chế độ NATIVE và EMULATED không còn được dùng nữa kể từ ngày 13 tháng 10 năm 2015 và hiện đã ngừng hoạt động. Hiện tại, chúng tôi chỉ hỗ trợ chế độ IFRAME.

Để bảo vệ người dùng khỏi việc 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 sẽ thực thi trong một hộp cát bảo mật áp đặt các quy tắc hạn chế đối với mã. Phương thức HtmlOutput.setSandboxMode(mode) trước đây cho phép tác giả tập lệnh chọn giữa các phiên bản 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 quy định 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 trong một số trình duyệt cũ, bao gồm cả Internet Explorer 9. 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, có thể khác với chế độ được yêu cầu trên máy chủ nếu chế độ được 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>