تحديد وحلّ المشاكل في تجارب المصادر في Chrome

يمكنك حلّ المشاكل الشائعة المتعلّقة بالرموز التجريبية التجريبية في العلامات الوصفية والعناوين والنصوص البرمجية.

قائمة التحقق

لتحديد وحلّ المشاكل في مرحلة التجربة والتقييم، يمكنك حلّ كل مشكلة أدناه باستخدام الروابط المتوفّرة.

ننصحك بتجربتها.

توضِّح الإصدارات التجريبية الواردة أدناه كل طريقة من طرق تقديم رمز مميّز لإصدار تجريبي والوصول إلى ميزة تجريبية:

• 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. وفي ما يلي مثال على استخدام الإعداد Express في 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);
}

يتطابق أصل الرمز المميّز للطرف الأول مع أصل الصفحة.

تأكَّد من أنّ قيمة Web Origin (مصدر الويب) المحدّدة عند التسجيل للحصول على فترة تجريبية تتطابق مع مصدر الصفحة التي تحتوي على العلامة الوصفية أو العنوان الذي يوفّر الرمز المميّز.

على سبيل المثال، في حال اختيار https://example.com باعتباره مصدر الويب:

قد تحصل على قيمة رمز مميز على النحو التالي:

تحقَّق من أنّ هذه القيمة تتطابق مع الرمز المميّز المستخدَم في الصفحة التي تحلّ مشاكلها وحلّها.

بالنسبة إلى الرمز المميز المتوفر في العلامة الوصفية، تحقق من ملف HTML:

  <meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

بالنسبة إلى رمز مميّز مذكور في أحد العناوين، يمكنك التحقّق من قيمة الرمز المميّز من لوحة شبكة Chrome DevTools ضمن عناوين الاستجابة:

يتم عرض الرمز المميّز للطرف الأول من المصدر الذي يستخدمه.

لإتاحة الوصول إلى ميزة مرحلة التجربة والتقييم للرمز البرمجي المضمّن في صفحة يتم عرضها من المصدر، عليك تقديم رمز مميز للتجربة في علامة وصفية أو عنوان أو عبر 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 Origin Trials:

تعرض "أدوات مطوري البرامج في 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 DevTools، والاطّلاع على القائمة الكاملة للميزات المسموح بها في لوحة التطبيق.

ماذا عن العمال؟

يمكن إتاحة ميزات الفترات التجريبية المصدر للعاملين في مجال تقديم الخدمات والعاملين المشتركين والعاملين المتخصصين. ومع ذلك، فإنّ الطريقة الوحيدة لإتاحة وصول مشغِّلي الخدمات والعاملين المشتركين في الخدمة هي من خلال توفير رمز مميّز في عنوان Origin-Trial.

يكتسب العاملون المتخصصون إمكانية الوصول إلى الميزات التي تم تفعيلها في المستند الرئيسي.

يتم توفير الرمز المميز قبل الوصول إلى الميزة.

احرص على توفير الرمز المميّز لمرحلة التجربة والتقييم قبل الوصول إلى الميزة التجريبية. على سبيل المثال، إذا قدمت إحدى الصفحات رمزًا مميزًا عبر JavaScript، فتأكد من تشغيل الرمز المقدم قبل الرمز الذي يحاول الوصول إلى الميزة التجريبية.

الإصدارات التجريبية لمرحلة التجربة والتقييم

• الرمز المميّز في العلامة الوصفية
• رمز مميّز في العنوان
• ميزة يتم الوصول إليها في إطار iframe
• تم إدخال الرمز المميّز من خلال نص برمجي تابع لجهة خارجية
• ot-iframe-3p.glitch.me: أمثلة على إطارات iframe من مصادر متعددة

التعرف على المزيد

• بدء استخدام تجارب المصدر في Chrome
• مراحل التجربة والتقييم التابعة لجهات خارجية
• دليل التجارب الأصلية لمطوّري البرامج على الويب
• شرح التجربة الأصلية
• إجراء مرحلة تجريبية للتقييم
• عملية إطلاق ميزات جديدة في Chromium
• الهدف من التوضيح: شرح عملية الشحن في Blink
• استخدام الإصدارات التجريبية من Origin في Microsoft Edge
• مراحل التجربة والتقييم في Firefox