Enum SandboxMode

SandboxMode

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

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

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월 이전에는 기본값이었습니다.

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 모드를 사용합니다.