Enum SandboxMode

SandboxMode

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

Aby wywołać wyliczenie, wywołaj jej 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 obecnie są niedostępne. Obecnie obsługiwany jest tylko tryb IFRAME.

Aby chronić użytkowników przed wyświetlaniem złośliwego kodu HTML lub JavaScript, kod udostępniany po stronie klienta 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 wybór różnych wersji piaskownicy, ale teraz nie działa. 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 ogóle nie działa w niektórych starszych przeglądarkach, w tym w Internet Explorerze 9. Tryb piaskownicy można też odczytać w skrypcie po stronie klienta, sprawdzając google.script.sandbox.mode. Pamiętaj, że ta właściwość zwraca rzeczywisty tryb klienta, który może się różnić od trybu żądanego przez serwer, jeśli żądany tryb nie jest obsługiwany przez przeglądarkę 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, używając tylko funkcji dostępnych w ECMAScript 3. Przed lutym 2014 roku był to tryb domyślny.

EMULATED został wycofany 10 grudnia 2015 r. Wszystkie skrypty, które próbują użyć elementu EMULATED, będą teraz używać parametru IFRAME.

IFRAMEEnumTryb piaskownicy, w którym używa się piaskownicy iframe zamiast technologii piaskownicy Caja używanej w trybach EMULATED i NATIVE. Od 12 listopada 2015 r. jest on domyślnie włączony w przypadku nowych skryptów, a od 6 lipca 2016 r. w przypadku wszystkich skryptów.

Ten tryb ma znacznie mniej ograniczeń niż pozostałe tryby piaskownicy i działa szybciej, ale nie działa w ogóle w niektórych starszych przeglądarkach, w tym w Internet Explorerze 9.

NATIVEEnumTryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Tryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Ten tryb został wyłączony 6 lipca 2016 roku. Wszystkie skrypty używają teraz trybu IFRAME.