تعداد يمثل أوضاع وضع الحماية التي يمكن استخدامها في نصوص 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>
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
EMULATED | Enum | وضع قديم لوضع الحماية يحاكي وضع ECMAscript 5 الصارم باستخدام الميزات المتاحة فقط
في ECMAScript 3. كان هذا الوضع هو الإعداد التلقائي قبل شباط (فبراير) 2014.
|
IFRAME | Enum | وضع الحماية الذي يستخدم وضع الحماية في إطار iframe بدلاً من تقنية وضع حماية Caja التي يستخدمها الوضعان EMULATED وNATIVE . هذا الوضع هو الإعداد التلقائي للنصوص البرمجية الجديدة اعتبارًا من
12 تشرين الثاني (نوفمبر) 2015 ولجميع النصوص البرمجية اعتبارًا من 6 تموز (يوليو) 2016.
يفرض هذا الوضع قيودًا أقل بكثير من أوضاع وضع الحماية الأخرى ويعمل بشكل أسرع، ولكنه لا يعمل على الإطلاق في متصفحات قديمة معينة، بما في ذلك Internet Explorer 9. |
NATIVE | Enum | وضع الحماية تم تصميمه في أعلى وضع ECMAScript 5 الصارم. وضع الحماية تم تصميمه في أعلى
وضع ECMAScript 5 الصارم. تم إيقاف هذا الوضع في 6 تموز (يوليو) 2016. تستخدم جميع النصوص البرمجية الآن وضع IFRAME . |