بدء استخدام تجارب المصدر

اختبار ميزة جديدة أو تجريبية لمنصّة الويب

تتيح لك مراحل التجربة والتقييم استخدام ميزة جديدة أو تجريبية، حتى تتمكّن من اختبار هذه الميزة وتقديمها للمستخدمين لفترة محدودة. بعد اكتمال الإصدار التمهيدي وتقييم الملاحظات، يقرر فريق Chrome ما إذا كان يجب إتاحة الميزة للجميع.

يمكنك التسجيل في إصدار تجريبي من الإصدار الأصلي لتفعيل ميزة لجميع المستخدمين على الإصدار الأصلي، بدون مطالبتهم بإيقاف أو تفعيل أي علامات أو التبديل إلى إصدار بديل من Chrome (مع أنّه قد يحتاجون إلى الترقية). وبعد التسجيل، يمكن للمطوّرين إنشاء نماذج أولية و إصدارات تجريبية باستخدام الميزات الجديدة. تساعد الإصدارات التجريبية أيضًا مهندسي Chrome في فهم كيفية استخدام الميزات الجديدة وكيفية تفاعلها مع تكنولوجيات الويب الأخرى.

مدى التوفّر

تكون تجارب Origin علنية ومفتوحة لجميع المطوّرين. وهي محدودة في المدة والاستخدام. إنّ المشاركة هي عملية ذاتية الإدارة مع مستندات ودعم محدودَين. يجب أن يكون المشاركون على استعداد وقادرين على العمل بشكل مستقل نسبيًا باستخدام المستندات المتاحة، والتي من المحتمل أن تقتصر في هذه المرحلة على مواصفات واجهة برمجة التطبيقات وشرحها. نحاول تقديم إرشادات كلما أمكن ذلك.

في حال التسجيل في فترة تجريبية، سيطلب منك فريق Chrome بشكل دوري تقديم ملاحظات محددة حول استخدامك لميزة الفترة التجريبية. قد تخضع بعض الميزات لتجارب متعددة من مصادر مختلفة، وذلك عند دمج الملاحظات وإجراء التعديلات.

تتوفّر مراحل التجربة والتقييم أيضًا لمتصفّحَي Firefox وMicrosoft Edge.

عمليات التجربة والتقييم التابعة لجهات خارجية

لا تتوفّر ميزة الفترة التجريبية للمصدر تلقائيًا إلا على المصدر المسجَّل في الفترة التجريبية. توفّر بعض الفترات التجريبية خيار مطابقة بيانات جهة خارجية عند التسجيل. يتيح ذلك لصنّاع المحتوى أو الخدمات المضمّنة تجربة ميزة جديدة على عدة مواقع إلكترونية بدون الحاجة إلى الحصول على رمز مميّز لكل مصدر.

مزيد من المعلومات: ما هي التجارب التي تبدأ من مصدر تابع لجهة خارجية؟

فترات تجريبية للميزات التي سيتم إيقافها نهائيًا

تتيح لك بعض مراحل التجربة والتقييم إعادة تفعيل ميزة متوقّفة نهائيًا مؤقتًا. وتُعرف هذه باسم فترات التوقف النهائي عن استخدام الميزة. وفي بعض السياقات، يُشار إليها بأنّها تجارب مصدر "عكسي".

على سبيل المثال، تمت إزالة أحداث الطفرة، بدءًا من الإصدار 127 من Chrome. بالنسبة إلى المواقع الإلكترونية التي احتاجت إلى وقت إضافي قبل إزالة هذه الأحداث، يمكنها التسجيل في فترة تجريبية لإيقاف الميزة نهائيًا لإعادة تفعيل الأحداث مؤقتًا على مواقع إلكترونية محدّدة.

المشاركة في فترة تجريبية لنقطة انطلاق

  1. اختَر تجربة مصدر من قائمة التجارب النشطة.
  2. اطلب رمزًا مميّزًا من خلال النقر على الزر تسجيل وملء الجدول.
  3. قدِّم الرمز المميّز في كل صفحة ويب تريد تفعيل ميزة الفترة التجريبية فيها:
    • كعلامة وصفية في <head>: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • كعنوان HTTP: Origin-Trial: TOKEN_GOES_HERE
    • من خلال تقديم رمز مميّز آليًا
  4. جرِّب الميزة الجديدة.
  5. إرسال ملاحظات يمكنك إجراء ذلك من خلال موقع الإصدار التجريبي الأصلي. هذه الملاحظات ليست علنية ولا تتوفّر إلا لمجموعة محدودة من موظفي فريق Chrome. توفّر كل فترة تجريبية أيضًا رابطًا لملاحظات المنتدى العفوية. يشير هذا عادةً إلى الميزة على GitHub أو قناة عامة أخرى.
  6. عند انتهاء صلاحية الرمز المميّز، ستصلك رسالة إلكترونية تتضمّن رابطًا للتجديد. لإجراء ذلك، يُطلب منك مرة أخرى إرسال ملاحظاتك.

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

يبحث إطار عمل الفترات التجريبية للإصدارات الأصلية عن أول رمز مميّز صالح، ثم يتجاهل كل العلامات المميّزة الأخرى. يمكنك التحقّق من ذلك باستخدام "أدوات مطوري البرامج في Chrome".

تقديم رمز مميّز آليًا

بدلاً من تقديم رمز مميّز كعنوان HTTP أو كعلامة وصفية في ملف HTML الخاص بصفحتك، كما هو موضّح سابقًا، يمكنك إدخال رمز مميّز باستخدام JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

استخدِم هذه الطريقة إذا كنت مشاركًا في فترة تجريبية تابعة لجهة خارجية.

الرموز المميّزة وإطارات iframe

للوصول إلى ميزة تجريبية من إطار iframe، يمكنك تقديم رمز مميّز للإصدار التجريبي في علامة ملف شخصي أو عنوان HTTP أو برمجيًا.

بالنسبة إلى جميع حالات استخدام الرمز المميّز، يجب أن يتطابق المصدر المسجَّل للرمز المميّز مع سياق JavaScript الذي يصل إلى ميزة الفترة التجريبية: إما مصدر الصفحة التي تتضمّن نصًا برمجيًا مضمّنًا، أو src عنصر <script> لملف JavaScript مضمّن من ملف خارجي.

الرموز المميّزة والإضافات

لاستخدام ميزة تجريبية داخل ملف نص برمجي في الخلفية أو نافذة منبثقة أو لوحة جانبية أو مستند خارج الشاشة، استخدِم ملف مفتاح trial_tokens في ملف manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

يتم التعامل مع النصوص البرمجية للمحتوى بشكل مختلف. قد يؤدي عرض ميزة في أحد الأماكن إلى التباس وعدم الوضوح. بدلاً من استخدام trial_token في ملف البيان، أضِف الرمز المميّز إلى الصفحة بإحدى الطريقتَين التاليتَين:

تذكَّر أنّ الرموز المميّزة مرتبطة بنطاقات معيّنة، لذا عليك التسجيل من أجل النطاق الذي يتم تشغيل نصّ المحتوى عليه، وليس رقم تعريف الإضافة.

لتسجيل إضافة لتجربة، استخدِم عنوان URL chrome-extension://YOUR_EXTENSION_ID، على سبيل المثال chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

تجديد التسجيل في مرحلة التجربة والتقييم

في حال تم تمديد فترة التجربة لجهة مصدر، سيصلك تحذير عبر البريد الإلكتروني يفيد بأنّه عليك تجديد التسجيل وتقديم رمز مميّز جديد لكل جهة مصدر مسجّلة في فترة التجربة.

  1. انتقِل إلى تسجيلاتي.
  2. انقر على تجديد لكل مصدر مسجَّل في الفترة التجريبية الإضافية. مثال لصفحة &quot;عمليات التسجيل&quot; التي تتضمّن أزرار تجديد
  3. انسخ الرمز المميّز الجديد واجعله متاحًا لكل صفحة يجب أن تظل مسجّلة في الفترة التجريبية. يمكنك تقديم عدة رموز مميّزة إذا لزم الأمر.

يتجاهل Chrome الرموز المميّزة غير الصالحة أو المنتهية الصلاحية.

عرض معلومات مرحلة التجربة والتقييم

يمكنك الاطّلاع على معلومات عن مراحل تجربة وتقييم المصدر المتاحة لموقع إلكتروني من لوحة التطبيق في أدوات مطوّري البرامج في Chrome.

عرض تفاصيل إطار لوحة التطبيق في &quot;أدوات مطوّري البرامج في Chrome&quot;

يمكنك أيضًا استخدام أداة فك ترميز الرمز المميّز لإصدار الإصدار التجريبي من المنتج لاطلاع على البيانات المشفّرة في الرمز المميّز.

أداة فك ترميز مرحلة التجربة والتقييم، تعرض قيم مرحلة التجربة والتقييم التي تم فك ترميزها

إصدارات تجريبية

تعرض المواقع الإلكترونية التالية أمثلة على عمليات نشر الرموز المميّزة.

كيفية تقديم رمز مميّز لمرحلة التجربة والتقييم

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

الميزات المتوفّرة في مرحلة التجربة والتقييم

في ما يلي نماذج توضيحية لواجهات برمجة التطبيقات في التجارب التجريبية الجارية.

الموارد

يمكنك مواصلة قراءة مستندات مفاهيم Chrome:

مزيد من المعلومات عن تجارب المصدر في Chrome:

المتصفحات الأخرى

العثور على إصدارات الإصدارات التجريبية الأصلية في متصفّحات أخرى: