تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنّ لغة JavaScript "وضع الحماية" هي مجموعة فرعية مبسّطة من لغة JavaScript
توفّر طريقة آمنة لتنفيذ منطق JavaScript عشوائي من علامة Google.
النماذج المخصصة للمدير. لتوفير بيئة تنفيذ آمنة، تتضمن بعض
حظر ميزات JavaScript أو إزالتها. يعتمد تطبيق JavaScript الذي تم وضع الحماية عليه
في الإصدار ECMAScript 5.1. تتضمن بعض ميزات ECMAScript 6 مثل دوال السهم
يتوفّر const من إجمالي let بيان.
بيئة التنفيذ العامة
لا يتم تنفيذ JavaScript في وضع الحماية في التنفيذ العام العادي
مثل JavaScript العادي، وبالتالي فإن الكائن window وخصائصه
غير متوفرة. يتضمن هذا الطرق المحددة في النطاق العمومي مثل
encodeURI أو setTimeout، وقيم عمومية مثل location أو document،
القيم العامة التي تحددها النصوص البرمجية التي تم تحميلها. وبدلاً من ذلك، تم وضع require
لجميع ملفات JavaScript التي تم وضع الحماية لها والتي توفر العديد من هذه
الأخرى. يمكن قراءة القيم من النافذة التي تحتوي على
copyFromWindow.
نظام الكتابة المبسّط
يتوافق JavaScript مع وضع الحماية مع الأنواع التالية: null وundefinedstring وnumber وboolean وarray وobject وfunction الصفائف
باستخدام البنية الحرفية ( [] {} )، ونظرًا لعدم وجود
إلى بيئة التنفيذ العامة القياسية، وأدوات الإنشاء العامة مثل
String() وNumber() غير متاحين. لا توجد كلمة رئيسية new في
وJavaScript في وضع الحماية، والدوال ليس لديها إمكانية الوصول إلى الكلمة الرئيسية this.
وتمت أيضًا إزالة بعض طرق الكتابة المدمجة مع المحتوى. يمكنك الانتقال إلى المكتبة العادية للاطّلاع على
قائمة شاملة بالطرق المتوافقة مع الأنواع المدمجة مع المحتوى.
تنسيق رمز النموذج المخصّص
ويمثّل الرمز البرمجي المكتوب لتنفيذ نموذج مخصّص نصّ
الدالة التي سيتم تنفيذها كلما تم تنشيط علامتك أو كان المتغير
التقييم. تتضمن هذه الدالة معلمة بيانات واحدة (data) تحتوي على جميع
القيم التي تم تكوينها في واجهة المستخدم لهذه العلامة أو لمثيل المتغير، باستخدام مجموعة المفاتيح
إلى أسماء مَعلمات النموذج المحدّدة في النموذج المخصّص
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSandboxed JavaScript in Google Tag Manager offers a secure environment to execute custom code with limited features for safety.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes a simplified type system and lacks access to the standard JavaScript global execution environment, relying on a \u003ccode\u003erequire\u003c/code\u003e function for functionalities like \u003ccode\u003eencodeURI\u003c/code\u003e or \u003ccode\u003esetTimeout\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eCustom template code acts as a function executed upon tag firing or variable evaluation, receiving configured data through a \u003ccode\u003edata\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe provided sample demonstrates building a beacon tag using \u003ccode\u003erequire\u003c/code\u003e for functionalities and accessing configuration data via \u003ccode\u003edata\u003c/code\u003e.\u003c/p\u003e\n"]]],["Sandboxed JavaScript, used in Google Tag Manager's custom templates, provides a safe execution environment with restricted features. It uses a simplified type system and lacks the standard `window` object, instead relying on a `require` function for globals. It supports basic types and literal array/object creation. Template code represents a function body with a `data` parameter containing UI-configured values. Code example uses functions `sendPixel`, `encodeUri`, `encodeUriComponent` for building a URL and appending cache buster parameter, then send the pixel with `sendPixel`.\n"],null,[]]