حل المشاكل الشائعة باستخدام الرموز المميّزة التجريبية في العلامات الوصفية والعناوين والنصوص البرمجية
قائمة التحقق
لتحديد مشاكل مرحلة التجربة والتقييم وحلّها، عليك حلّ كل مشكلة من المشاكل أدناه باستخدام الروابط المقدَّمة.
.
ننصحكم بتجربتها.
تعرض العروض التوضيحية أدناه كل طريقة من طرق توفير رمز مميّز للتجربة المصدر والوصول إلى ميزة تجريبية:
- ot-meta.glitch.me: رمز مميّز في العلامة الوصفية
origin-trial
- ot-header.glitch.me: رمز مميّز في عنوان الاستجابة
Origin-Trial
- ot-3p.glitch.me: رمز مميّز تم إدخاله من خلال نص برمجي تابع لجهة خارجية
- ot-iframe.glitch.me: ميزة التجربة والتقييم التي يتم الوصول إليها في إطار iframe
- ot-iframe-3p.glitch.me: أمثلة على إطارات iframe من مصادر متعددة
استخدام "أدوات مطوري البرامج في Chrome" للتحقّق من الرموز المميّزة
من الإصدار Chrome 93، توفّر "أدوات مطوري البرامج" معلومات عن الفترة التجريبية للمصدر في لوحة التطبيق للإطار المحدّد.
يمكنك توسيع الإطار العلوي لفحص الرموز المميّزة الخاصة بمراحل التجربة والتقييم المتوفّرة لإطار فرعي. على سبيل المثال، بالنسبة إلى على ot-iframe.glitch.me، يمكنك رؤية أنّ الصفحة في يوفر iframe رمزًا مميزًا.
- حالة الرمز المميّز: ما إذا كانت الصفحة تحتوي على رمز مميّز صالح. يُرجى العِلم أنّه في بعض مراحل التجربة والتقييم على عوامل أخرى، مثل القيود الجغرافية، ما يعني أن ميزة مرحلة التجربة والتقييم ليست على الرغم من وجود رمز مميّز صالح. رموز حالة "أدوات مطوري البرامج في Chrome" تشرح معنى كل رمز من الرموز الخاصة بمراحل التجربة والتقييم.
- المصدر: مصدر الويب المسجَّل للموقع الرمز المميز.
- وقت انتهاء الصلاحية: أقصى (أحدث) تاريخ/وقت انتهاء صلاحية للرمز المميز، والذي عادةً ما تطابق نهاية الفترة التجريبية. ويختلف هذا التاريخ عن تاريخ "صالحة حتى" للرمز المميّز المعروض. في تسجيلاتي، ، الذي يعرض مدة صلاحية الرمز المميّز حاليًا يمكن تمديدها
- قيود الاستخدام: حدود الاستخدام، والتي يمكن ضبطها لبعض الفترات التجريبية.
- الطرف الثالث: ما إذا كانت مطابقة الجهة الخارجية تم تفعيله للرمز المميّز. تتوفّر هذه الميزة لبعض مراحل التجربة والتقييم التي تحتاج فيها الميزة التجريبية إلى يمكن الوصول إليه على مواقع متعددة من خلال نصوص برمجية تابعة لجهات خارجية.
- مطابقة النطاقات الفرعية: سواء مطابقة النطاق الفرعي تم تفعيله للرمز المميّز. يتيح ذلك اختبار ميزة التجربة والتقييم على عدة نطاقات النطاقات الفرعية التابعة للمصدر، بدون طلب رمز مميّز مختلف لكل نطاق فرعي.
سيعرض "أدوات مطوري البرامج في Chrome" تحذيرًا بجانب اسم الفترة التجريبية في حال عدم توفّرها. للمستخدم الحالي، أو انتهت صلاحية الرمز، أو إذا كانت هناك قيود أخرى.
رموز حالة "أدوات مطوري البرامج في Chrome"
منتهي الصلاحية: تجاوز الرمز المميّز تاريخ انتهاء صلاحيته. يجب تجديد الرمز المميّز إنشاء رمز مميز جديد بتاريخ انتهاء صلاحية جديد.
رمز المصدرFeatureDisabled: الفترة التجريبية غير مفعّلة حاليًا للاستخدام.
رمز المصدرFeatureDisabledForUser: تم ضبط هذا الرمز المميّز على أنّه غير مفعَّل للمستخدم الحالي من خلال قيد الاستخدام البديل اطّلِع على "استبعادات المجموعات الفرعية للمستخدمين" في مستند التصميم.
رمز المصدر 1
رمز المصدر 2غير آمن: مصدر الطلب غير آمن ولم يتم تفعيل الفترة التجريبية للمصادر غير الآمنة. كما هو موضّح في رمز التحقّق من الرمز المميّز للتجربة المصدر: "بالنسبة إلى الرموز المميّزة التابعة لجهات خارجية، يجب أن يكون المصدر الحالي وأصل النص البرمجي آمنَين. بسبب تطابق النطاق الفرعي، فقد لا يكون مصدر الرمز المميز مطابقًا تمامًا لأحد النصوص البرمجية المقدمة والأصول، ولا تشير النتيجة إلى المصدر المحدّد الذي تمت مطابقته. هذا يعني أنها ليست البحث المباشر للعثور على مصدر النص البرمجي المناسب. لتجنُّب إعادة إجراء جميع مقارنات المصادر، هناك اختصارات تعتمد على عدد أصول النص البرمجي التي تم توفيرها. يجب أن يكون هناك ما لا يقل عن الأولى، وإلا فلن يتم التحقق من صحة الرمز المميز للجهة الخارجية بنجاح".
رمز المصدرInvalidSignature: يحتوي الرمز المميّز على توقيع غير صالح أو مكتوب بشكلٍ غير صحيح.
رمز المصدرتشكيلة غير صحيحة: صياغة الرمز المميّز غير صحيحة ويتعذّر تحليله.
رمز المصدر
NotSupported: مرحلة التجربة والتقييم التي تم تحديدها من خلال الرمز المميّز غير متاحة في Chromium. "التضمين": متصفّح مثل Chrome أو Edge أو WebView أو وكيل مستخدم آخر
رمز المصدرتمت العملية بنجاح: الرمز المميّز منسّق بشكل صحيح ولم تنتهِ صلاحيته ويتطابق مع ميزة في مرحلة التجربة والتقييم تم طلبها من مصدر متوقع.
رمز المصدرTokenDisabled: تم وضع علامة على الرمز المميّز على أنّه غير مفعَّل ولا يمكن استخدامه.
رمز المصدرTrialNotAllowed: مرحلة التجربة والتقييم غير متاحة للمستخدم الحالي.
رمز المصدرUnknownTrial: يحدد الرمز المميز اسم ميزة لا يطابق أي نسخة تجريبية معروفة.
رمز المصدرWrongOrigin: لا يتطابق أصل الطلب مع المصدر المحدّد في الرمز المميّز. يمكن أن المخطط أو اسم المضيف أو المنفذ. سيتم عرض هذه الحالة أيضًا في حال كان الرمز المميّز تابعًا لجهة خارجية. يتم تقديمها في عنوان HTTP أو علامة وصفية أو نص برمجي مضمّن، بدلاً من ملف JavaScript خارجي.
رمز المصدرWrongVersion: إصدار الرمز المميّز غير صحيح: لا يتوافق سوى الإصدارين 2 و3 من الرمز المميّز حاليًا.
رمز المصدر
الميزة لا تعمل. 🤔
إذا كانت مرحلة التجربة والتقييم لا تعمل على النحو المتوقّع، تأكَّد من استيفاء الشروط التالية.
أنت تختبره في Chrome، وليس في Chromium أو متصفّح آخر
تم تصميم مراحل التجربة والتقييم في Chrome لتعمل لمستخدمي Chrome. عدم الاعتماد على الرموز المميزة الخاصة بمراحل التجربة والتقييم في Chrome لتفعيل الميزات التجريبية في المتصفّحات الأخرى، بما في ذلك Chromium والمتصفحات الأخرى المستندة إلى Chromium. يرجع السبب في ذلك إلى أنّ مرحلة التجربة والتقييم في Chrome مخصّصة للميزات المتاحة في Chrome. التجارب.
تتوفّر أيضًا مراحل التجربة الأصلية لمتصفّح Firefox وMicrosoft Edge. لن يؤدّي التسجيل في مرحلة التجربة والتقييم في Firefox أو Edge إلى تفعيل ميزة في Chrome.
تم تفعيل مرحلة التجربة والتقييم لإصدارات Chrome التي يمكنها الوصول إلى موقعك الإلكتروني.
تقتصر إمكانية الوصول إلى الفترات التجريبية على إصدارات معيّنة من Chrome. وفي بعض الحالات، قد يعني ذلك تجربة لا تتوفّر هذه الميزة إلا لقنوات Chrome الثابتة مسبقًا: إصدار Canary وDev والإصدار التجريبي.
يمكنك التحقّق من توفّر الإصدار من صفحة التسجيل. الفترة التجريبية:
يمكنك التحقق من إصدار Chrome الذي تستخدمه من chrome://version.
لم يتم إيقاف مرحلة التجربة والتقييم من خلال إعدادات Chrome.
إذا أبلغ مستخدم فردي عن عدم عمل ميزة معيّنة معه، تأكَّد من أنّ الميزة لا تعمل.
في إعدادات Chrome. على سبيل المثال، مبادرة حماية الخصوصية
يمكن إيقاف هذه الميزات من صفحة chrome://settings/privacySandbox
.
الكلمات الرئيسية والبنية صحيحة
يجب التأكّد من استخدام كلمات رئيسية وبنية مناسبة للرموز المميّزة الخاصة بمراحل التجربة والتقييم.
لاستخدام الطرف الأول، يمكن تقديم رمز مميّز في العلامة الوصفية origin-trial
:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
يمكنك بدلاً من ذلك توفير رمز مميّز في عنوان الاستجابة Origin-Trial
. إليك مثال باستخدام
سريع في Node.js:
app.use(function(req, res, next) {
res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
next();
});
يمكن أيضًا توفير الرموز المميّزة باستخدام JavaScript:
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
يتطابق أصل الرمز المميّز للطرف الأول مع مصدر الصفحة.
تأكّد من أن قيمة مصدر الويب المحدّدة عند التسجيل للحصول على فترة تجريبية تتطابق مع أصل تحتوي على العلامة الوصفية أو العنوان الذي يوفر الرمز المميز.
على سبيل المثال، في حال اختيار https://example.com
على أنّه مصدر الويب:
قد تحصل على قيمة رمز مميّز مثل هذه:
تأكَّد من أنّ هذه القيمة تتطابق مع الرمز المميّز المستخدَم في الصفحة التي تتّخذها لتحديد المشاكل وحلّها.
بالنسبة إلى الرمز المميّز المقدَّم في علامة وصفية، تحقَّق من HTML:
<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">
بالنسبة إلى الرمز المميّز المقدَّم في العنوان، يمكنك التحقّق من قيمة الرمز المميّز من خلال لوحة الشبكة في "أدوات مطوري البرامج في Chrome" ضمن عناوين الاستجابة:
يتم عرض الرمز المميّز للطرف الأول من المصدر الذي يستخدمه.
لإتاحة الوصول إلى ميزة التجربة والتقييم للرمز البرمجي المضمّن في صفحة يتم عرضها من المصدر: توفير رمز مميز تجريبي في علامة وصفية أو عنوان أو من خلال JavaScript من المصدر نفسه.
يجب أن يتطابق المصدر المسجَّل للرمز المميّز مع المصدر الذي يعرضه.
يتطابق أصل الرمز المميّز التابع لجهة خارجية مع مصدر النص البرمجي.
يمكنك التسجيل للمشاركة في مرحلة التجربة والتقييم للنصوص البرمجية التي يتم إدخالها في مصادر أخرى.
على سبيل المثال، إذا أردت أن تشارك النصوص البرمجية المعروضة من خلال javascript-library.example
في
في مرحلة التجربة والتقييم، عليك تسجيل رمز مميّز باستخدام مطابقة الجهة الخارجية javascript-library.example
.
يجب أن تتطابق قيمة المصدر للرمز المميّز التابع لجهة خارجية مع مصدر النص البرمجي الذي يُدخله.
يستخدم النص البرمجي التابع لجهة خارجية رمزًا مميزًا تابعًا لجهة خارجية.
لا يمكنك تفعيل نص برمجي تابع لجهة خارجية من أجل المشاركة في مرحلة تجريبية للمصدر على موقعك الإلكتروني من خلال لتسجيل رمز مميّز للمصدر، وليس للنص البرمجي.
يجب أن تستخدم النصوص البرمجية التابعة لجهات خارجية رموزًا مميّزة مع تفعيل مطابقة الجهات الخارجية التي تم إدخالها عبر النص البرمجي. نفسه (غير مضمّنة في علامة وصفية أو عنوان على موقعك الإلكتروني) باستخدام رمز مثل ما يلي:
function addTrialToken(tokenContents) {
const tokenElement = document.createElement('meta');
tokenElement.httpEquiv = 'origin-trial';
tokenElement.content = tokenContents;
document.head.appendChild(tokenElement);
}
يتم توفير الرمز المميّز التابع لجهة خارجية من خلال نص برمجي خارجي، وليس علامة وصفية أو عنوان HTTP أو نص برمجي مضمّن.
يتم التحقّق من الرموز المميّزة التابعة لجهات خارجية استنادًا إلى مصدر النص البرمجي الذي أدخلها، ولكنها مضمّنة.
النصوص البرمجية وعلامات <meta>
في الترميز الثابت ليس لها مصدر (أي عنوان URL المصدر).
يعني هذا أنّه يجب تقديم رمز مميّز تابع لجهة خارجية من خلال نص برمجي خارجي، وليس في علامة <meta>
.
أو نص برمجي مضمَّن. ولا يهم إذا كان النص البرمجي الخارجي الذي يقوم بإدخال الرمز المميز يأتي من ملف
المصدر نفسه للصفحة التي تحتوي على الصورة أو مصدر مختلف، ما دام مصدر النص البرمجي متطابقًا
مصدر مسجَّل في الفترة التجريبية
يمكنك مشاهدة عرض توضيحي لذلك على ot-iframe-3p.glitch.me.
إنّ إمكانية استخدام ميزات الإصدار التجريبي من المصدر متاحة للطريقة المستخدَمة لتقديم رمز مميّز تجريبي.
تتطلّب بعض أنواع الوصول إلى ميزات التجربة والتقييم تقديم رمز مميّز تجريبي بطريقة معيّنة.
على سبيل المثال، الطريقة الوحيدة لتفعيل الوصول إلى الإصدار التجريبي من المصدر لموظفي الخدمة والعاملين المشترَكين هي من خلال:
عليك تقديم رمز مميّز في عنوان Origin-Trial
.
تم تفعيل مطابقة النطاق الفرعي لرمز مميّز مُستخدَم في نطاق فرعي.
إذا بدا أنّ إحدى ميزات التجربة والتقييم لا تعمل مع بعض الصفحات على موقعك الإلكتروني، تأكَّد من أن يتم إعداد الرموز المميزة بشكل صحيح للنطاقات الفرعية التي تعرضها.
عند التسجيل في مرحلة التجربة والتقييم، يمكنك اختيار مطابقة جميع النطاقات الفرعية المصدر:
يمكنك أيضًا مطابقة النطاقات الفرعية للرموز المميزة التابعة لجهات خارجية:
لن يتم إصدار الرموز المميّزة للنطاق الفرعي للأصول في قائمة اللواحق العامة. على سبيل المثال، لا يمكنك التسجيل مصدر مثل https://appspot.com أو https://github.io، على الرغم من أنّه يمكنك التسجيل للحصول على نطاقات. ضمن هذا المصدر، مثل https://example.appspot.com أو https://example.github.io.
لا يزال الرمز المميّز صالحًا
تكون الرموز المميزة صالحة لمدة ستة أسابيع بعد إنشائها. علاوة على ذلك، يجب عليك إرسال ملاحظات لتمديد تاريخ "صالح حتى". يوضّح دليل مراحل التجربة والتقييم لمطوّري البرامج على الويب كيفية التأكّد من يكون رمزك المميّز صالحًا خلال مرحلة التجربة والتقييم بأكملها.
يمكنك التحقّق من الرموز المميّزة النشطة في صفحة "عمليات التسجيل الخاصة بي" التجريبية من Chrome:
تعرض "أدوات مطوري البرامج في Chrome" الحالة "Success
" إذا كان الرمز المميّز لا يزال صالحًا:
إذا انتهت صلاحية الرمز المميّز، ستعرض "أدوات مطوري البرامج" الحالة Expired
ستعرض صفحة "عمليات التسجيل" قسم الرموز المميّزة منتهية الصلاحية.
لم تنتهِ مرحلة التجربة والتقييم
يمكنك التحقّق من تاريخ انتهاء فترة التجربة والتقييم من خلال صفحة التسجيل:
بالنسبة إلى الفترات التجريبية المنتهية، ستعرض "أدوات مطوري البرامج" على النحو التالي:
ومع ذلك، ستصلك رسائل إلكترونية مبرمَجة عندما تكون الملاحظات مطلوبة أو عندما توشك صلاحية رمز مميّز على الانتهاء. وليس عند انتهاء التجربة.
تتوفّر مرحلة التجربة والتقييم للمستخدم الحالي.
لا تتوفّر بعض مراحل التجربة والتقييم لمستخدمين معيّنين، حتى في حال تقديم رمز مميّز صالح.
إذا لم تكن فترة تجريبية متاحة للمستخدم الحالي، ستعرض "أدوات مطوري البرامج في Chrome" تحذير TrialNotAllowed
:
سيتم توفير معلومات حول قيود الاستخدام ومدى التوفّر في كل مرحلة من مراحل التجربة والتقييم.
كما هو الحال مع أي ميزة من ميزات النظام الأساسي للويب، يجب استخدام ميزة رصد الميزات للتأكد من توفّر ميزة التجربة والتقييم قبل استخدامها
لم يتم تجاوز قيود الاستخدام التجريبي لنقطة الشحن.
سيتم تلقائيًا تفعيل ميزة مرحلة التجربة والتقييم على أي صفحة تحتوي على رمز مميّز صالح خلال الفترة التجريبية.
يُرجى العِلم أنّ استخدام مرحلة التجربة والتقييم يقتصر على% 0.5 كحدّ أقصى من جميع عمليات تحميل صفحات Chrome، باستثناء حالات نادرة. سيتم إيقاف ميزة التجربة والتقييم في حال تجاوز إجمالي عدد مستخدمي Chrome هذا الحد. وستعرض "أدوات مطوري البرامج" حالة الرمز المميّز على أنّه غير مفعّل.
لا توجد حدود لاستخدام الفترات التجريبية للإيقاف النهائي، نظرًا لأنها لا تقدم ميزات جديدة، وبالتالي لا تشكل خطرًا بإحراز نسبة كبيرة الويب يعتمد على ميزة تجريبية
توفّر بعض الفترات التجريبية أيضًا خيارًا لتقييد الاستخدام، ما يعني أنّه سيتم إيقاف ميزات الإصدار التجريبي. لبعض المستخدمين. يتوفّر هذا الخيار في صفحة التسجيل الخاصة بالمصدر. فترة تجريبية تتيح له:
إذا لاحظت أنّ مستوى وصول المستخدمين إلى إحدى ميزات التجربة والتقييم أقل من المتوقع، تأكد من أن 'الحد القياسي' .
توفّر إطارات iframe الرموز المميزة الخاصة بها
للسماح بالوصول إلى ميزة التجربة والتقييم، يجب أن يوفّر إطار iframe رمزًا مميزًا في علامة وصفية، أي HTTP. أو آليًا. لا تكتسب إطارات iframe إمكانية الوصول إلى الميزات التي تم تفعيلها في الصفحات التي تحتوي عليها.
يوضّح ot-iframe.glitch.me إمكانية الوصول إلى ميزة في مرحلة التجربة والتقييم. من iframe. ot-iframe-3p.glitch.me يوفّر العديد من أمثلة على إطارات iframe متعددة المصادر
تم ضبط سياسات الأذونات بشكل صحيح
قد تتأثر بعض ميزات مرحلة التجربة والتقييم بواسطة Permissions-Policy
رأس الصفحة (كان هذا المقياس يُعرف سابقًا باسم عنوان Feature-Policy
). يمكنك التحقّق من ذلك في
نية إجراء تجربة
أو في مستندات المطوّرين الخاصة بهذه الميزة على web.dev
أو developer.chrome.com/blog.
تأكد من عدم حظر الميزة التي تحاول الوصول إليها بواسطة Permissions-Policy
التوجيه. يمكنك التحقق من عناوين الاستجابة في لوحة شبكة أدوات مطوري البرامج في Chrome وعرض
القائمة الكاملة للميزات المسموح بها في لوحة التطبيقات.
ماذا عن العمال؟
يمكن توفير ميزات مراحل التجربة والتقييم للعاملين في الخدمات والعاملين المشتركين والمستخدمين المخصّصين
العمال. ومع ذلك، فإن الطريقة الوحيدة لتمكين عاملي الخدمة والعاملين المشتركين في الوصول هي تقديم
رمز مميّز في عنوان Origin-Trial
.
يكتسب العاملون المخصصون إمكانية الوصول إلى الميزات التي تم تفعيلها من خلال مستندهم الرئيسي.
يتم تقديم الرمز قبل الوصول إلى الميزة
احرص على تقديم رمز مميَّز خاص بالتجربة قبل الوصول إلى ميزة في الإصدار التجريبي. على سبيل المثال، إذا كانت الصفحة توفّر رمزًا مميزًا من خلال JavaScript، احرص على توفير الرمز المميّز في هذا الرمز. يتم تشغيله قبل الرمز الذي يحاول الوصول إلى الميزة التجريبية.
الإصدارات التجريبية الخاصة بمرحلة التجربة والتقييم
- الرمز المميّز في علامة وصفية
- الرمز المميّز في العنوان
- ميزة يتم الوصول إليها في إطار iframe
- تم إدخال الرمز المميّز من خلال نص برمجي تابع لجهة خارجية
- ot-iframe-3p.glitch.me: أمثلة على إطارات iframe من مصادر متعددة
التعرف على المزيد
- بدء استخدام مراحل التجربة والتقييم في Chrome
- مرحلة التجربة والتقييم التابعة لجهات خارجية
- دليل مراحل التجربة والتقييم لمطوّري البرامج على الويب
- شرح عن الفترة التجريبية لنقطة الشحن
- تنفيذ مرحلة تجريبية للمصدر
- عملية إطلاق ميزات جديدة في Chromium
- نقصد التوضيح: إزالة الغموض عن عملية الشحن في Blink
- استخدام مراحل التجربة والتقييم في Microsoft Edge
- مراحل التجربة والتقييم في Firefox