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

اختبِر ميزة جديدة أو تجريبية لنظام أساسي للويب.

Sam Dutton

تتيح لك مراحل التجربة والتقييم استخدام ميزة جديدة أو تجريبية من أجل إنشاء وظائف يمكن للمستخدمين تجربتها لفترة محدودة قبل إتاحة الميزة للجميع.

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

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

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

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

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

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

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

الفترات التجريبية للإيقاف النهائي

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

على سبيل المثال، بدءًا من الإصدار 85 من Chrome ، لم يعُد AppCache متاحًا في Chrome تلقائيًا. يمكن للمواقع الإلكترونية التي تحتاج إلى وقت إضافي لنقل بياناتها من AppCache التسجيل في الفترة التجريبية للإيقاف النهائي لمواصلة استخدام AppCache حتى توفّر الإصدار 93 من 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 في البيان، أضِف رمز التفويض إلى الصفحة إما عن طريق إدراج عنوان باستخدام declarativeNetRequest أو برمجيًا مباشرةً في نص المحتوى. تذكَّر أنّ الرموز المميّزة مرتبطة بنطاقات معيّنة، لذا عليك تسجيل رمز مميّز للنطاق الذي يتم تشغيل نصّ المحتوى عليه، وليس رقم تعريف الإضافة.

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

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

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

  1. انتقِل إلى صفحة تسجيلاتي.

  2. لكل مصدر مسجَّل في الفترة التجريبية الممتدة، انقر على الزر تجديد . لقطة شاشة لصفحة &quot;تسجيلاتي&quot; في إصدار Chrome التجريبي الأصلي، تعرض أزرار تجديد التسجيل

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

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

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

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

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

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

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

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