Enum SandboxMode

샌드박스모드

클라이언트 측 HtmlService 스크립트에 사용할 수 있는 샌드박스 모드를 나타내는 enum입니다. 이러한 값은 HtmlService.SandboxMode에서 액세스할 수 있으며 HtmlOutput.setSandboxMode(mode)를 호출하여 설정할 수 있습니다.

enum을 호출하려면 상위 클래스, 이름, 속성을 호출합니다. 예를 들면 HtmlService.SandboxMode.IFRAME입니다.

NATIVEEMULATED 모드는 2015년 10월 13일에 지원 중단되었으며 이제 모두 지원 종료되었습니다. 이제 IFRAME 모드만 지원됩니다.

악성 HTML 또는 JavaScript가 사용자에게 게재되지 않도록 하기 위해 HTML 서비스에서 제공되는 클라이언트 측 코드는 코드에 제한사항을 적용하는 보안 샌드박스에서 실행됩니다. 이전에는 HtmlOutput.setSandboxMode(mode) 메서드를 통해 스크립트 작성자가 여러 버전의 샌드박스 중에서 선택할 수 있었지만 이제는 영향을 미치지 않습니다. 자세한 내용은 HTML 서비스 제한 가이드를 참고하세요.

IFRAME 모드는 다른 샌드박스 모드보다 훨씬 적은 제한을 적용하고 가장 빠르게 실행되지만 Internet Explorer 9를 비롯한 특정 이전 브라우저에서는 전혀 작동하지 않습니다. google.script.sandbox.mode를 검사하여 클라이언트 측 스크립트에서 샌드박스 모드를 읽을 수도 있습니다. 이 속성은 클라이언트의 실제 모드를 반환하며, 요청된 모드가 사용자의 브라우저에서 지원되지 않는 경우 서버에서 요청된 모드와 다를 수 있습니다.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

속성

속성유형설명
EMULATEDEnumECMAScript 3에서 사용할 수 있는 기능만 사용하여 ECMAScript 5 엄격 모드를 에뮬레이션하는 기존 샌드박스 모드입니다. 이 모드는 2014년 2월 이전의 기본 모드였습니다.

EMULATED2015년 12월 10일부로 지원 중단되었습니다. 이제 EMULATED를 사용하려는 모든 스크립트에서 IFRAME를 대신 사용합니다.

IFRAMEEnumEMULATEDNATIVE 모드에서 사용하는 Caja 샌드박스 기술 대신 iframe 샌드박스를 사용하는 샌드박스 모드입니다. 이 모드는 2015년 11월 12일부터 새 스크립트의 기본 모드이며 2016년 7월 6일부터 모든 스크립트의 기본 모드입니다.

이 모드는 다른 샌드박스 모드보다 훨씬 적은 제한을 적용하고 가장 빠르게 실행되지만 Internet Explorer 9을 비롯한 특정 이전 브라우저에서는 전혀 작동하지 않습니다.

NATIVEEnumECMAScript 5 엄격 모드를 기반으로 빌드된 샌드박스 모드입니다. ECMAScript 5 엄격 모드 위에 빌드된 샌드박스 모드입니다. 이 모드는 2016년 7월 6일부터 지원 중단되었습니다. 이제 모든 스크립트가 IFRAME 모드를 사용합니다.