Wartość wyliczająca tryby piaskownicy, które mogą być używane dla skryptów HtmlService po stronie klienta. Dostęp do tych wartości możesz uzyskać za pomocą atrybutu HtmlService.SandboxMode i ustawić je, wywołując metodę HtmlOutput.setSandboxMode(mode).
Od 13 października 2015 r. wycofaliśmy tryby NATIVE i EMULATED. Teraz obsługiwany jest tylko tryb IFRAME.
Aby chronić użytkowników przed złośliwym kodem HTML lub JavaScript, kod po stronie klienta wyświetlany z usługi HTML jest uruchamiany w bezpiecznej piaskownicy, która nakłada ograniczenia na kod. Metoda HtmlOutput.setSandboxMode(mode) wcześniej zezwalała autorom skryptów na wybieranie różnych wersji piaskownicy, ale teraz nie ma to wpływu. Więcej informacji znajdziesz w przewodniku po ograniczeniach dotyczących usługi HTML.
Tryb IFRAME narzuca znacznie mniej ograniczeń niż pozostałe tryby piaskownicy i działa szybciej, ale nie działa w niektórych starszych przeglądarkach, w tym Internet Explorera 9. Tryb piaskownicy można też odczytać w skrypcie po stronie klienta, sprawdzając parametr google.script.sandbox.mode. Ta właściwość zwraca tryb rzeczywisty klienta, który może różnić się od trybu żądanego na serwerze, jeśli żądany tryb nie jest obsługiwany w przeglądarce użytkownika.
<!-- Read the sandbox mode (in a client-side script). --> <script> alert(google.script.sandbox.mode); </script>
Właściwości
| Właściwość | Typ | Opis |
|---|---|---|
EMULATED | Enum | Starszy tryb piaskownicy, który emuluje ścisły tryb ECMAscript 5 przy użyciu tylko funkcji dostępnych w ECMAScript 3. Przed lutym 2014 roku był to tryb domyślny.
|
IFRAME | Enum | Tryb piaskownicy, który używa piaskownicy piaskownicy iframe zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE. Od 12 listopada 2015 r. tryb domyślny jest stosowany w przypadku nowych skryptów.
Ten tryb narzuca znacznie mniej ograniczeń niż pozostałe tryby piaskownicy i działa szybciej, ale nie działa w niektórych starszych przeglądarkach, w tym Internet Explorer 9. |
NATIVE | Enum | Tryb piaskownicy oparty na ścisłym trybie ECMAScript 5. Tryb piaskownicy oparty na ścisłym trybie ECMAScript 5. Tryb ten został wyłączony 6 lipca 2016 r. Wszystkie skrypty korzystają teraz z trybu IFRAME. |