Enum SandboxMode

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
وضع الحماية

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

تم إيقاف الوضعَين 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وضع قديم لوضع الحماية يحاكي وضع 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.