تمت ترجمة هذه الصفحة بواسطة 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`	وضع الحماية القديم الذي يحاكي الوضع المتشدد في 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`.