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 phía 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 dùng nữa kể từ ngày 13 tháng 10 năm 2015 và cả hai chế độ này hiện không còn được hỗ trợ. Hiện 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 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 khác nhau của hộp cát, nhưng hiện không có tác dụng. Để 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 quy định hạn chế hơn nhiều 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>