Ta strona została przetłumaczona przez Cloud Translation API.

Enum SandboxMode

Typ enumeracji reprezentujący tryby piaskownicy, które można stosować w przypadku skryptów po stronie klienta HtmlService Do tych wartości można uzyskać dostęp za pomocą funkcji HtmlService.SandboxMode i ustawić je, wywołując funkcję HtmlOutput.setSandboxMode(mode).

Aby wywołać enum, 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 wyświetlaniem złośliwego kodu HTML lub JavaScript, kod po stronie klienta obsługiwany przez usługę HTML jest wykonywany w piaskownicy bezpieczeństwa, która nakłada na niego ograniczenia. Metoda HtmlOutput.setSandboxMode(mode) wcześniej umożliwiała autorom skryptów wybór różnych wersji piaskownicy, ale teraz nie ma żadnego wpływu. 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 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 na kliencie, 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 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żyć `EMULATED`, będą teraz używać `IFRAME`.
`IFRAME`	`Enum`	Tryb piaskownicy, który wykorzystuje piaskownicę iframe zamiast technologii piaskownicy Caja używanej w trybach `EMULATED` i `NATIVE`. Od 12 listopada 2015 r. jest to domyślny tryb dla nowych skryptów, a od 6 lipca 2016 r. – dla wszystkich skryptów. W tym trybie obowiązuje znacznie mniej ograniczeń niż w innych trybach piaskownicy, a dodatkowo działa on najszybciej. Nie działa jednak w niektórych starszych przeglądarkach, w tym w Internet Explorerze 9.
`NATIVE`	`Enum`	Tryb piaskownicy oparty na ECMAScript 5 w trybie ścisłym. Tryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Ten tryb został wycofany 6 lipca 2016 roku. Wszystkie skrypty używają teraz trybu `IFRAME`.