Enum 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وضع تجريبي قديم يحاكي الوضع الصارم في 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.