Enum SandboxMode

SandboxMode

Wyliczenie reprezentujące tryby piaskownicy, które mogą być używane na potrzeby funkcji HtmlService po stronie klienta skryptów. Dostęp do tych wartości można uzyskać w aplikacji HtmlService.SandboxMode, a ustawienie ich można ustawić przez wywołanie metody HtmlOutput.setSandboxMode(mode)

Aby wywołać wyliczenie, musisz wywołać 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. Tylko Tryb IFRAME jest teraz obsługiwany.

Aby chronić użytkowników przed złośliwym kodem HTML lub JavaScript, kod po stronie klienta udostępniany Usługa HTML działa w bezpiecznej piaskownicy, która nakłada ograniczenia na kod. Metoda Liczba wcześniej dozwolonych autorów skryptów: HtmlOutput.setSandboxMode(mode) między różnymi wersjami piaskownicy, ale teraz nie ma żadnego efektu. Więcej informacji: ograniczenia w usłudze HTML.

Tryb IFRAME nakłada o wiele mniej ograniczeń niż inne tryby piaskownicy i działa najszybciej, ale nie działa w ogóle w niektórych starszych przeglądarkach, w tym Internet Explorer 9. trybu piaskownicy można też odczytać w skrypcie po stronie klienta, sprawdzając google.script.sandbox.mode. Zwróć uwagę, że ta właściwość zwraca rzeczywisty tryb klienta, który może różnić się od trybu żądanego przez serwer, jeśli żądany tryb nie jest obsługiwany przeglądarki 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 z użyciem tylko dostępnych funkcji w ECMAScript 3. Ten tryb był domyślny do lutego 2014 roku.

10 grudnia EMULATED zostało wyłączone, 2015 r. Wszystkie skrypty próbujące użyć parametru EMULATED będą teraz używać zamiast niego IFRAME.
IFRAMEEnumTryb piaskownicy, w którym zamiast technologii piaskownicy Caja używana jest piaskownica iframe EMULATED i NATIVE. Ten tryb jest domyślny dla nowych skryptów od 12 listopada 2015 r. w przypadku wszystkich skryptów na dzień 6 lipca 2016 r.

Ten tryb 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 Internet Explorer 9.
NATIVEEnumTryb piaskownicy oparty na trybie ścisłym ECMAScript 5. Tryb piaskownicy oparty na Tryb rygorystyczny ECMAScript 5. Ten tryb został wyłączony jako 6 lipca 2016 r. Wszystkie skrypty korzystają teraz z trybu IFRAME.