تعداد يمثّل أوضاع وضع الحماية التي يمكن استخدامها للنصوص البرمجية 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>
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
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 . |