تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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>

أماكن إقامة

الموقع	النوع	الوصف
`EMULATED`	`Enum`	وضع Sandbox قديم يحاكي وضع ECMAScript 5 الصارم باستخدام الميزات المتاحة فقط في ECMAScript 3 كان هذا الوضع هو التلقائي قبل شباط (فبراير) 2014. تم إيقاف `EMULATED` نهائيًا اعتبارًا من 10 كانون الأول (ديسمبر) 2015. ستستخدم الآن جميع النصوص البرمجية التي تحاول استخدام `EMULATED` الرمز `IFRAME` بدلاً من ذلك.
`IFRAME`	`Enum`	وضع حماية يستخدم وضع حماية إطارات iframe بدلاً من تقنية وضع حماية Caja المستخدَمة في وضعَي `EMULATED` و`NATIVE` أصبح هذا الوضع هو الإعداد التلقائي للنصوص البرمجية الجديدة اعتبارًا من 12 تشرين الثاني (نوفمبر) 2015 ولجميع النصوص البرمجية اعتبارًا من 6 تموز (يوليو) 2016. يفرض هذا الوضع قيودًا أقل بكثير من أوضاع وضع الحماية الأخرى ويتم تشغيله بشكل أسرع، ولكنه لا يعمل على الإطلاق في بعض المتصفحات القديمة، بما في ذلك Internet Explorer 9.
`NATIVE`	`Enum`	وضع الحماية الذي تم إنشاؤه على وضع ECMAScript 5 الصارم وضع الحماية الذي تم إنشاؤه على أساس وضع ECMAScript 5 الصارم تم إيقاف هذا الوضع نهائيًا بتاريخ 6 تموز (يوليو) 2016. تستخدم جميع النصوص البرمجية الآن وضع `IFRAME`.