Enum SandboxMode

Trybpiaskownicy

Wyliczenie reprezentujące tryby piaskownicy, których można używać w przypadku skryptów HtmlService po stronie klienta. Dostęp do tych wartości można uzyskać za pomocą HtmlService.SandboxMode, a ustawić je, wywołując HtmlOutput.setSandboxMode(mode).

Aby wywołać wyliczenie, wywołaj jego klasę nadrzędną, nazwę i właściwość. Na przykład: HtmlService.SandboxMode.IFRAME.

Tryby NATIVE i EMULATED zostały wycofane 13 października 2015 r. i nie są już dostępne. Obecnie 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 wykonywany w piaskownicy zabezpieczeń, która nakłada na niego ograniczenia. Metoda HtmlOutput.setSandboxMode(mode) wcześniej umożliwiała autorom skryptów wybór między różnymi wersjami piaskownicy, ale teraz nie ma już wpływu na działanie skryptu. Więcej informacji znajdziesz w przewodniku po ograniczeniach w usłudze HTML.

Tryb IFRAME nakłada znacznie mniej ograniczeń niż inne tryby piaskownicy i działa najszybciej, ale w niektórych starszych przeglądarkach, w tym w Internet Explorerze 9, nie działa wcale. Tryb piaskownicy można też odczytać w skrypcie po stronie klienta, sprawdzając wartość google.script.sandbox.mode. Pamiętaj, że ta właściwość zwraca rzeczywisty tryb na kliencie, który może się różnić 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śćTypOpis
EMULATEDEnumStarszy tryb piaskownicy, który emuluje tryb ścisły ECMAScript 5, korzystając tylko z funkcji dostępnych w ECMAScript 3. Przed lutym 2014 r. był to tryb domyślny.

EMULATED został wycofany 10 grudnia 2015 r. Wszystkie skrypty, które próbują używać EMULATED, będą teraz używać IFRAME.
IFRAMEEnumTryb piaskownicy, który zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE korzysta z piaskownicy iframe. Od 12 listopada 2015 r. ten tryb jest domyślny w przypadku nowych skryptów, a od 6 lipca 2016 r. – w przypadku wszystkich skryptów.

Ten tryb nakłada znacznie mniej ograniczeń niż inne tryby piaskownicy i działa najszybciej, ale w niektórych starszych przeglądarkach, w tym w Internet Explorerze 9, nie działa wcale.
NATIVEEnumTryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Tryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Ten tryb został wycofany 6 lipca 2016 roku. Wszystkie skrypty używają teraz trybu IFRAME.