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ść | Typ | Opis |
---|---|---|
EMULATED | Enum | Starszy 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.
|
IFRAME | Enum | Tryb 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. |
NATIVE | Enum | Tryb 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 . |