Enum SandboxMode

샌드박스 모드

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

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

사용자에게 악성 HTML 또는 자바스크립트가 게재되지 않도록 보호하기 위해 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월 이전 기본값이었습니다.

EMULATED 2015년 12월 10일부로 일몰되었습니다. 이제 EMULATED를 사용하려는 모든 스크립트가 IFRAME를 대신 사용합니다.

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

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

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