Enum SandboxMode

SandboxMode

فهرس يمثّل أوضاع وضع الحماية التي يمكن استخدامها HtmlService للنصوص البرمجية من جهة العميل يمكن الوصول إلى هذه القيم من HtmlService.SandboxMode، وضبطها من خلال استدعاء HtmlOutput.setSandboxMode(mode).

لاستدعاء قائمة أرقام صحيحة، يمكنك استدعاء الصف الرئيسي والاسم والخاصية. مثلاً: HtmlService.SandboxMode.IFRAME

تم إيقاف الوضعَين NATIVE وEMULATED نهائيًا في 13 تشرين الأول (أكتوبر) 2015. أصبح الآن يمكن استخدام وضع 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>

الخصائص

الموقعالنوعالوصف
EMULATEDEnumوضع Sandbox قديم يحاكي وضع ECMAScript 5 الصارم باستخدام الميزات المتاحة فقط في ECMAScript 3 كان هذا الوضع هو التلقائي قبل شباط (فبراير) 2014.

تم إيقاف EMULATED نهائيًا اعتبارًا من 10 كانون الأول (ديسمبر) 2015. ستستخدم الآن جميع النصوص البرمجية التي تحاول استخدام EMULATED القيمة IFRAME بدلاً من ذلك.
IFRAMEEnumوضع حماية يستخدم وضع حماية إطارات iframe بدلاً من تقنية وضع حماية Caja المستخدَمة في وضعَي EMULATED وNATIVE أصبح هذا الوضع هو الإعداد التلقائي للنصوص البرمجية الجديدة اعتبارًا من 12 تشرين الثاني (نوفمبر) 2015 ولجميع النصوص البرمجية اعتبارًا من 6 تموز (يوليو) 2016.

يفرض هذا الوضع قيودًا أقل بكثير من أوضاع وضع الحماية الأخرى ويتم تشغيله بشكل أسرع، ولكنه لا يعمل على الإطلاق في بعض المتصفحات القديمة، بما في ذلك Internet Explorer 9.
NATIVEEnumوضع الحماية الذي تم إنشاؤه على وضع ECMAScript 5 الصارم وضع الحماية الذي تم إنشاؤه على أساس وضع ECMAScript 5 الصارم تم إيقاف هذا الوضع نهائيًا اعتبارًا من 6 تموز (يوليو) 2016. تستخدم جميع النصوص البرمجية الآن وضع IFRAME.