Enum SandboxMode

حالت Sandbox

یک فهرست نشان دهنده حالت های جعبه ایمنی است که می تواند برای اسکریپت های HtmlService سمت سرویس گیرنده استفاده شود. این مقادیر از HtmlService.SandboxMode قابل دسترسی هستند و با فراخوانی HtmlOutput.setSandboxMode(mode) تنظیم می شوند.

برای فراخوانی یک enum، کلاس والد، نام و ویژگی آن را فراخوانی می کنید. به عنوان مثال، HtmlService.SandboxMode.IFRAME .

حالت‌های NATIVE و EMULATED در 13 اکتبر 2015 منسوخ شدند و هر دو اکنون غروب هستند. اکنون فقط حالت IFRAME پشتیبانی می شود.

برای محافظت از کاربران در برابر ارائه HTML یا جاوا اسکریپت مخرب، کد سمت سرویس گیرنده ارائه شده از سرویس HTML در یک جعبه ایمنی امنیتی اجرا می شود که محدودیت هایی بر روی کد اعمال می کند. روش HtmlOutput.setSandboxMode(mode) قبلاً به نویسندگان اسکریپت اجازه می داد از بین نسخه های مختلف جعبه ایمنی یکی را انتخاب کنند، اما اکنون هیچ تأثیری ندارد. برای اطلاعات بیشتر، راهنمای محدودیت ها در سرویس HTML را ببینید.

حالت IFRAME محدودیت‌های کمتری نسبت به سایر حالت‌های جعبه ایمنی اعمال می‌کند و سریع‌ترین اجرا را دارد، اما در برخی google.script.sandbox.mode مرورگرهای قدیمی‌تر، از جمله Internet Explorer 9، اصلاً کار نمی‌کند. google.script.sandbox.mode . توجه داشته باشید که این ویژگی حالت واقعی را بر روی کلاینت برمی گرداند، که اگر حالت درخواستی در مرورگر کاربر پشتیبانی نشود، ممکن است با حالت درخواست شده در سرور متفاوت باشد.

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

خواص

ویژگی	تایپ کنید	شرح
EMULATED	Enum	یک حالت سندباکس قدیمی که حالت سختگیرانه ECMAScript 5 را فقط با استفاده از ویژگی‌های موجود در ECMAScript 3 تقلید می‌کند. این حالت پیش‌فرض قبل از فوریه 2014 بود. EMULATED در 10 دسامبر 2015 غروب شد. همه اسکریپت هایی که سعی در استفاده از EMULATED دارند، اکنون به جای آن از IFRAME استفاده می کنند.
IFRAME	Enum	حالت Sandbox که از sandboxing iframe به جای فناوری Caja sandbox استفاده می‌کند که توسط حالت‌های EMULATED و NATIVE استفاده می‌شود. این حالت برای اسکریپت های جدید از 12 نوامبر 2015 و برای همه اسکریپت ها از 6 ژوئیه 2016 پیش فرض است. این حالت محدودیت‌های بسیار کمتری نسبت به سایر حالت‌های جعبه ایمنی اعمال می‌کند و سریع‌ترین اجرا را دارد، اما در برخی از مرورگرهای قدیمی‌تر، از جمله Internet Explorer 9، اصلاً کار نمی‌کند.
NATIVE	Enum	حالت sandbox که بر روی حالت سخت ECMAScript 5 ساخته شده است. حالت جعبه ایمنی که در بالای حالت سخت ECMAScript 5 ساخته شده است. این حالت در تاریخ 6 ژوئیه 2016 غروب شد. اکنون همه اسکریپت ها از حالت IFRAME استفاده می کنند.