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

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

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

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

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

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

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

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

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

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

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

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

على سبيل المثال، بدءًا من الإصدار 85 من Chrome ، لم يعُد AppCache متاحًا في Chrome تلقائيًا. تحتاج المواقع الإلكترونية إلى وقت إضافي لنقل البيانات خارج Appcache يمكنها التسجيل في الفترة التجريبية للإيقاف النهائي لمواصلة استخدام Appcache حتى Chrome 93.

المشاركة في مرحلة التجربة والتقييم

  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 تعرض أزرار &quot;تجديد&quot;

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

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

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

معلومات عن الفترة التجريبية للمنشأ
   لموقع إلكتروني معروض في طريقة عرض تفاصيل إطار اللوحة **التطبيق** في Chrome DevTools.

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

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

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

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