Enum SandboxMode

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>

أماكن إقامة

الموقعTypeالوصف
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.