مرجع الميزات

Sofia Emelianova

Jecelyn Yeen

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

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

التعرّف على الاختصارات وتخصيصها

استخدِم الاختصارات للتنقّل في المسجِّلة بشكل أسرع. للحصول على قائمة بالاختصارات التلقائية، يُرجى الاطّلاع على اختصارات لوحة التسجيل.

لفتح تلميح يسرد جميع الاختصارات مباشرةً في المسجِّل، انقر على مساعدة عرض الاختصارات في أعلى يسار الشاشة.

لتخصيص اختصارات المسجِّل:

1. افتح الإعدادات > الاختصارات.
2. انتقِل للأسفل إلى قسم المسجِّل.
3. اتّبِع الخطوات الواردة في تخصيص الاختصارات.

تعديل مسارات المستخدِمين

في أعلى لوحة المسجِّل، تتوفّر لك خيارات لإجراء ما يلي:

1. إضافة تسجيل جديد انقر على رمز + لإضافة تسجيل جديد.
2. عرض كل التسجيلات تعرض القائمة المنسدلة قائمة التسجيلات المحفوظة. اختَر الخيار N تسجيل لتوسيع قائمة التسجيلات المحفوظة وإدارتها.

3. تصدير تسجيل لتخصيص النص البرمجي بشكل أكبر أو لمشاركته لأغراض الإبلاغ عن الأخطاء، يمكنك تصدير مسار المستخدِم بأحد التنسيقَين التاليَين:

   • ملف JSON
   • نص @puppeteer/replay
   • نص Puppeteer
   • نص Puppeteer (لمتصفح Firefox)
   • Puppeteer (بما في ذلك تحليل Lighthouse)

   لمزيد من المعلومات عن التنسيقات، يُرجى الاطّلاع على تصدير مسار مستخدِم.

4. استيراد تسجيل بتنسيق JSON فقط

5. حذف تسجيل حذف التسجيل المحدّد

يمكنك أيضًا تعديل اسم التسجيل من خلال النقر على زر التعديل بجانبه.

مشاركة مسارات المستخدِمين

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

تصدير مسار مستخدِم

لتصدير مسار مستخدِم:

1. افتح مسار المستخدِم الذي تريد تصديره.

2. انقر على تنزيل تصدير في أعلى لوحة المسجِّل.

   

3. اختَر أحد التنسيقات التالية من القائمة المنسدلة:

   • ملف JSON نزِّل التسجيل كملف JSON.
   • @puppeteer/replay. نزِّل التسجيل كنص برمجي لإعادة تشغيل Puppeteer.
   • Puppeteer نزِّل التسجيل كنص برمجي Puppeteer.
   • Puppeteer (لمتصفح Firefox) نزِّل التسجيل كنص برمجي Puppeteer for Firefox.
   • Puppeteer (بما في ذلك تحليل Lighthouse) نزِّل التسجيل كنص برمجي Puppeteer يتضمّن تحليل Lighthouse مضمّنًا.
   • خيار واحد أو أكثر يوفّره تصدير الإضافات في "المسجّل"

4. احفظ الملف.

يمكنك تنفيذ ما يلي مع كل خيار تصدير تلقائي:

• JSON: عدِّل عنصر JSON القابل للقراءة وimport ملف JSON مرة أخرى إلى المسجِّل.
• @puppeteer/replay. أعِد تشغيل النص البرمجي باستخدام مكتبة Puppeteer Replay. عند التصدير كملف نصي من النوع @puppeteer/replay، تظل الخطوات كائنًا بتنسيق JSON. هذا الخيار مثالي إذا كنت تريد الدمج مع مسار التكامل/النشر المبرمَج (CI/CD) مع الحفاظ على المرونة في تعديل الخطوات بتنسيق JSON، ثم تحويلها واستيرادها مرة أخرى إلى المسجِّل.
• نص Puppeteer أعِد تشغيل النص البرمجي باستخدام Puppeteer. وبما أنّه يتم تحويل الخطوات إلى JavaScript، يمكنك إجراء المزيد من عمليات التخصيص الدقيقة، مثل تكرار الخطوات. يُرجى العِلم أنّه لا يمكنك استيراد هذا النص البرمجي مرة أخرى إلى المسجِّل.
• Puppeteer (لمتصفح Firefox) كجزء من WebDriver BiDi، يمكنك تشغيل نص Puppeteer البرمجي هذا على كلّ من Chrome وFirefox.

• Puppeteer (بما في ذلك تحليل Lighthouse) خيار التصدير هذا هو نفسه الخيار السابق، ولكنه يتضمّن رمزًا برمجيًا ينشئ تحليل Lighthouse.

  شغِّل النص البرمجي وتحقّق من الإخراج في ملف flow.report.html:

  # npm i puppeteer lighthouse
  node your_export.js
  

  

التصدير بتنسيق مخصّص من خلال تثبيت إضافة

اطّلِع على إضافات أداة Recorder.

استيراد مسار مستخدِم

لاستيراد مسار مستخدِم، اتّبِع الخطوات التالية:

1. انقر على الزر استيراد في أعلى لوحة المسجِّل.
2. اختَر ملف JSON الذي يتضمّن مسار المستخدِم المسجَّل.
3. انقر على الزر إعادة تشغيل لتشغيل مسار المستخدِم المستورَد.

إعادة تشغيل المحتوى باستخدام مكتبات خارجية

Puppeteer Replay هي مكتبة مفتوحة المصدر يديرها فريق "أدوات مطوّري البرامج في Chrome". تم إنشاؤه استنادًا إلى Puppeteer. وهي أداة سطر أوامر يمكنك من خلالها إعادة تشغيل ملفات JSON.

بالإضافة إلى ذلك، يمكنك تحويل ملفات JSON وإعادة تشغيلها باستخدام المكتبات التابعة لجهات خارجية التالية.

تحويل مسارات المستخدِمين بتنسيق JSON إلى نصوص برمجية مخصّصة:

• Cypress Chrome Recorder ويمكنك استخدامها لتحويل ملفات JSON الخاصة بمسار المستخدِم إلى نصوص برمجية لاختبار Cypress. يمكنك مشاهدة هذا العرض التوضيحي للاطّلاع على هذه الميزة بشكل عملي.
• Nightwatch Chrome Recorder يمكنك استخدامها لتحويل ملفات JSON الخاصة بمسار المستخدِم إلى نصوص برمجية لاختبار Nightwatch.
• CodeceptJS Chrome Recorder يمكنك استخدامها لتحويل ملفات JSON الخاصة بمسارات المستخدِمين إلى نصوص اختبار CodeceptJS.

إعادة تشغيل مسارات المستخدِمين في ملف JSON:

• إعادة تشغيل الاختبار باستخدام Testcafe يمكنك استخدام TestCafe لإعادة تشغيل ملفات JSON الخاصة بمسار المستخدِم وإنشاء تقارير اختبار لهذه التسجيلات.
• إعادة تشغيل الفيديو باستخدام Sauce Labs يمكنك إعادة تشغيل ملفات JSON على Sauce Labs باستخدام saucectl.

نقطة رئيسية: حالة الاستخدام المتقدّمة: الدمج مع مكتبة Puppeteer Replay على غرار المكتبات التابعة لجهات خارجية المذكورة أعلاه، يمكنك إنشاء مكتبتك الخاصة استنادًا إلى Puppeteer Replay أيضًا. توفّر مكتبة Puppeteer Replay طرقًا لتخصيص طريقة تشغيل التسجيل و"تحويل" ملفات JSON الخاصة بمسار المستخدِم، أي تحويلها إلى ملف آخر.

تصحيح أخطاء مسارات المستخدِمين

مثل أي رمز، عليك أحيانًا تصحيح أخطاء مسارات المستخدِمين المسجّلة.

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

إبطاء سرعة إعادة التشغيل

يعيد المسجِّل تدفق المستخدِم تلقائيًا بأسرع ما يمكن. لفهم ما يحدث في التسجيل، يمكنك إبطاء سرعة إعادة التشغيل:

1. افتح القائمة المنسدلة إعادة تشغيل.
2. اختَر أحد خيارات سرعة إعادة التشغيل:
   • عادي (الإعداد التلقائي)
   • بطيئة
   • بطيء للغاية
   • بطيء للغاية

ملاحظة مهمة: لا يمكنك استخدام خيارات إعادة التشغيل البطيء هذه إلا في المسجّلة الذكية. لإضافة مهلات إلى التسجيل نفسه، اطّلِع على ضبط المهلات للخطوات.

فحص الرمز

لفحص رمز مسار مستخدم بتنسيقات مختلفة:

1. افتح تسجيلًا في لوحة المسجّلة.
2. انقر على عرض الرمز في أعلى يسار قائمة الخطوات.
3. يعرض المسجِّل عرضًا جنبًا إلى جنب للخطوات ورمزها.
4. عند تمرير مؤشر الماوس فوق خطوة، يُبرز المسجِّل الرمز البرمجي المقابل لها بأي تنسيق، بما في ذلك تلك المقدَّمة من الإضافات.

5. وسِّع القائمة المنسدلة للتنسيق لاختيار تنسيق تستخدمه لتصدير مسارات المستخدِمين.

   

   يمكن أن يكون أحد التنسيقات التلقائية الثلاثة (JSON أو @puppeteer/replay أو نص برمجي Puppeteer أو تنسيق تقدّمه إضافة).

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

ضبط نقاط التوقف وتنفيذ الخطوات خطوة بخطوة

لضبط نقطة توقّف وتنفيذ الخطوات خطوة بخطوة:

1. مرِّر مؤشر الماوس فوق الدائرة بجانب أي خطوة في أحد التسجيلات. تتحول الدائرة إلى رمز نقطة التوقف .
2. انقر على رمز نقطة التوقف وأعِد تشغيل التسجيل. يتم إيقاف عمليات التنفيذ مؤقتًا عند نقطة الإيقاف.
3. للانتقال خلال التنفيذ، انقر على الزر تنفيذ خطوة واحدة في شريط الإجراءات أعلى لوحة المسجِّل.
4. لإيقاف إعادة التشغيل، انقر على إلغاء إعادة التشغيل.

تعديل الخطوات

يمكنك تعديل أي خطوة في التسجيل من خلال النقر على الزر بجانبها، سواء أثناء التسجيل أو بعده.

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

إضافة خطوات

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

لإضافة خطوة يدويًا:

1. افتح هذه الصفحة التجريبية وابدأ تسجيلًا جديدًا.
2. مرِّر مؤشر الماوس فوق العنصر في إطار العرض. ستظهر قائمة إجراءات.
3. اختَر إجراءً من القائمة واوقف التسجيل. لا يسجِّل المسجِّل سوى حدث النقر.
4. حاوِل إعادة تشغيل التسجيل بالنقر على إعادة التشغيل. يتعذّر إعادة تشغيل المحتوى بعد انتهاء مهلة زمنية لأنّ المسجِّل لا يمكنه الوصول إلى العنصر في القائمة.
5. انقر على الزر الذي يتضمّن ثلاث نقاط بجانب خطوة النقر واختَر إضافة خطوة قبل.
6. وسِّع الخطوة الجديدة. يكون نوعها تلقائيًا waitForElement. انقر على القيمة بجانب type واختَر hover.
7. بعد ذلك، اضبط أداة اختيار مناسبة للخطوة الجديدة. انقر على اختيار، ثمّ انقر على منطقة في عنصر Hover over me! خارج القائمة المنبثقة. تم ضبط أداة الاختيار على #clickable.
8. يُرجى إعادة تشغيل التسجيل. بعد إضافة خطوة التمرير بمؤشر الماوس، يعيد المسجِّل تشغيل المسار بنجاح.

إضافة تأكيدات

أثناء التسجيل، يمكنك تأكيد سمات HTML وخصائص JavaScript، على سبيل المثال. لإضافة تأكيد:

1. ابدأ تسجيلًا، على سبيل المثال، في هذه الصفحة التجريبية.

2. انقر على إضافة تأكيد.

   

   ينشئ المسجِّل خطوة waitForElement قابلة للضبط.

3. حدِّد أدوات الاختيار لهذه الخطوة.

4. اضبط الخطوة، ولكن لا تغيِّر نوع waitForElement. على سبيل المثال، يمكنك تحديد ما يلي:

   • سمة HTML انقر على إضافة سمات واكتب اسم السمة وقيمتها التي تستخدمها العناصر في هذه الصفحة. على سبيل المثال، data-test: <value>.
   • خاصية JavaScript انقر على إضافة مواقع واكتب اسم الموقع وقيمته بتنسيق JSON. على سبيل المثال، {".innerText":"<text>"}.
   • خصائص الخطوة الأخرى: مثلاً: visible: true

5. واصِل تسجيل بقية مسار المستخدِم، ثم أوقِف التسجيل.

6. انقر على إعادة تشغيل. إذا تعذّر إجراء تأكيد، يعرض المسجِّل رسالة خطأ بعد مهلة.

شاهِد الفيديو التالي لمعرفة كيفية تنفيذ سير العمل هذا.

نسخ الخطوات

بدلاً من تصدير مسار المستخدِم بالكامل، يمكنك نسخ خطوة واحدة إلى الحافظة:

1. انقر بزر الماوس الأيمن على الخطوة التي تريد نسخها أو انقر على رمز النقاط الثلاث بجانبها.
2. في القائمة المنسدلة، اختَر أحد خيارات النسخ على النحو التالي.

يمكنك نسخ الخطوات بتنسيقات مختلفة: JSON وPuppeteer و@puppeteer/replay والخطوات التي تقدّمها الإضافات.

إزالة الخطوات

لإزالة خطوة تم تسجيلها عن طريق الخطأ، انقر بزر الماوس الأيمن على الخطوة أو انقر على رمز النقاط الثلاث بجانبها واختَر إزالة الخطوة.

بالإضافة إلى ذلك، يضيف المسجّل الذكي خطوتَين منفصلتَين تلقائيًا إلى بداية كل تسجيل:

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

لإجراء عمليات التشغيل الآلي داخل الصفحة بدون إعادة تحميل الصفحة، عليك إزالة خطوة التنقّل كما هو موضّح أعلاه.

ضبط الخطوات

لضبط خطوة:

1. حدِّد نوعها: click أو doubleClick أو hover أو (إدخال) change أو keyUp أو keyDown أو scroll أو close أو navigate (لصفحة) أو waitForElement أو waitForExpression أو setViewport.

   تعتمد السمات الأخرى على قيمة type.

2. حدِّد السمات المطلوبة أسفل type.

   

3. انقر على الأزرار المقابلة لإضافة سمات اختيارية خاصة بالنوع وتحديدها.

للحصول على قائمة بالخصائص المتاحة، يُرجى الاطّلاع على خصائص الخطوة.

لإزالة خاصيّة اختيارية، انقر على الزر إزالة بجانبها.

لإضافة عنصر أو إزالته من أو إلى سمة صفيف، انقر على الزرَّين + أو - بجانب العنصر.

سمات الخطوة

يمكن أن تحتوي كل خطوة على السمات الاختيارية التالية:

• target: عنوان URL لهدف بروتوكول أدوات مطوري البرامج في Chrome (CDP)، تشير الكلمة الرئيسية التلقائية main إلى الصفحة الحالية.
• assertedEvents يمكن أن يكون حدث navigation واحدًا فقط.

في ما يلي السمات الشائعة الأخرى المتاحة لمعظم أنواع الخطوات:

• ‫frame: صفيف من الفهارس التي تستند إلى الصفر والتي تحدّد إطار iframe الذي يمكن تداخله على سبيل المثال، يمكنك تحديد إطار iframe الأول (0) داخل إطار iframe ثانٍ (1) للاستهداف الرئيسي على أنّه [1, 0].
• timeout: عدد من المللي ثانية للانتظار قبل تنفيذ خطوة. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل مهلات الخطوات.
• selectors: صفيف من أدوات الاختيار لمزيد من المعلومات، يُرجى الاطّلاع على فهم المحدّدات.

السمات الخاصة بالنوع هي:

النوع	الموقع	مطلوب	الوصف
click doubleClick	offsetX offsetY		بالنسبة إلى أعلى يمين مربّع محتوى العنصر، بالبكسل
click doubleClick	button		زر المؤشر: أساسي | إضافي | ثانوي | الرجوع | التقديم
change	value		القيمة النهائية
keyDown keyUp	key		اسم المفتاح
scroll	x y		موضعَا التمرير x وy المطلقَين بالبكسل، القيمة التلقائية هي 0
navigate	url		عنوان URL المستهدف
waitForElement	operator		>= (الإعداد التلقائي) | == | <=
waitForElement	count		عدد العناصر التي يحدّدها أحد المحدّدات
waitForElement	attributes		سمة HTML وقيمتها
waitForElement	properties		سمة JavaScript وقيمتها في ملف JSON
waitForElement	visible		منطقي. صحيح إذا كان العنصر في DOM ومرئيًا (لا يتضمّن display: none أو visibility: hidden)
waitForElement waitForExpression	asserted events		حاليًا، type: navigation فقط، ولكن يمكنك تحديد العنوان وعنوان URL
waitForElement waitForExpression	timeout		الحد الأقصى للوقت الذي يمكن الانتظار فيه بالمللي ثانية
waitForExpression	expression		تعبير JavaScript الذي يُحسِّن القيمة إلى صحيح
setViewport	width height		عرض إطار العرض وارتفاعه بالبكسل
setViewport	deviceScaleFactor		مشابهة لنسبة وحدات البكسل على الجهاز (DPR)، القيمة التلقائية هي 1
setViewport	isMobile hasTouch isLandscape		علامات منطقية تحدّد ما إذا كان يجب: مراعاة العلامة الوصفية إتاحة أحداث اللمس العرض في الوضع الأفقي

هناك سمتان تؤديان إلى إيقاف الإعادة مؤقتًا:

• تجعل السمة waitForElement الخطوة تنتظر توفّر (أو عدم توفّر) عدد من العناصر التي يحدّدها أحد المحدّدات. على سبيل المثال، تنتظر الخطوة التالية ظهور أقل من ثلاثة عناصر في الصفحة تتطابق مع أداة الاختيار .my-class.

    "type": "waitForElement",
    "selectors": [".my-class"],
    "operator": "<=",
    "count": 2,
  

• تجعل السمة waitForExpression الخطوة تنتظر تعبير JavaScript ليتم تقييمه على أنّه صحيح. على سبيل المثال، يتم إيقاف الخطوة التالية مؤقتًا لمدة ثانيتَين ثم يتم حلّها لتصبح صحيحة، ما يسمح بمواصلة الإعادة.

    "type": "waitForExpression",
    "expression": "new Promise(resolve => setTimeout(() => resolve(true), 2000))",
  

تعديل مهلات الخطوات

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

لتجنُّب هذه المشكلة، يمكنك ضبط مهلة الانتظار التلقائية لكل خطوة في آنٍ واحد أو ضبط مهلات انتظار منفصلة لخطوات معيّنة. تلغي مهلات الانتظار في خطوات معيّنة المدة التلقائية.

لضبط مهلة الانتظار التلقائية لكل خطوة في آنٍ واحد:

1. انقر على إعدادات إعادة التشغيل لجعل مربّع المهلة قابلاً للتعديل.

   

2. في مربّع المهلة، اضبط قيمة المهلة بالملي ثانية.

3. انقر على إعادة التشغيل للاطّلاع على مهلة الانتظار التلقائية المعدَّلة أثناء تنفيذها.

لإعادة ضبط مهلة الانتظار التلقائية في خطوة معيّنة:

1. وسِّع الخطوة وانقر على إضافة مهلة.

   

2. انقر على timeout: <value> واضبط القيمة بالملي ثانية.

   

3. انقر على إعادة التشغيل للاطّلاع على الخطوة التي حدث فيها وقت الاستراحة.

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

فهم أدوات الاختيار

عند بدء تسجيل جديد، يمكنك ضبط ما يلي:

• في مربّع نص سمة أداة الاختيار، أدخِل سمة اختبار مخصّصة. سيستخدم المسجِّل هذه السمة لرصد أدوات الاختيار بدلاً من قائمة سمات الاختبار الشائعة.

• في مجموعة مربّعات الاختيار أنواع أدوات الاختيار المُستخدَمة أثناء التسجيل، اختَر أنواع أدوات الاختيار التي تريد رصدها تلقائيًا:

  • CSS: أدوات الاختيار النحوي
  • ARIA: أدوات الاختيار الدلالية
  • النص: أدوات الاختيار التي تحتوي على أقصر نص فريد، إن توفّرت
  • XPath: أدوات الاختيار التي تستخدِم لغة مسار XML
  • Pierce. أدوات اختيار مشابهة لأدوات اختيار CSS ولكنّها يمكنها اختراق shadow DOM

ملاحظة: لمزيد من المعلومات، يُرجى الاطّلاع على المحدّدات النحوية مقابل المحدّدات الدلالية وأولوية المحدّد.

أدوات اختيار الاختبارات الشائعة

بالنسبة إلى صفحات الويب البسيطة، تكون سمات id وسمّات CSS class كافية لكي يرصد المسجِّل أدوات الاختيار. ومع ذلك، قد لا يكون هذا هو الحال دائمًا للأسباب التالية:

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

على سبيل المثال، قد يتم إنشاء قيم class في CSS تلقائيًا للتطبيقات المطوّرة باستخدام إطارات عمل JavaScript الحديثة (مثل React وAngular وVue) وإطارات عمل CSS.

في هذه الحالات، يمكنك استخدام سمات data-* لإنشاء اختبارات أكثر مرونة. هناك حاليًا بعض أدوات اختيار data-* الشائعة التي يستخدمها المطوّرون للتشغيل الآلي. تتيح ميزة المسجلة الذكية استخدام هذه الميزة أيضًا.

إذا كانت لديك عناصر اختيار الاختبار الشائعة التالية محدّدة على موقعك الإلكتروني، سيرصدها المسجِّل ويستخدمها تلقائيًا أولاً:

• data-testid
• data-test
• data-qa
• data-cy
• data-test-id
• data-qa-id
• data-testing

على سبيل المثال، افحص عنصر Cappuccino في هذه الصفحة التجريبية واطّلِع على سمات الاختبار:

سجِّل نقرة على "كابوتشينو"، وسِّع الخطوة المقابلة في التسجيل، وتحقّق من عناصر الاختيار التي تم رصدها:

تخصيص أداة اختيار التسجيل

يمكنك تخصيص أداة اختيار التسجيل إذا لم تكن أدوات اختيار الاختبارات الشائعة مناسبة لك.

على سبيل المثال، تستخدم هذه الصفحة التجريبية السمة data-automate كعنصر اختيار. ابدأ تسجيلًا جديدًا وأدخِل data-automate كسمة الاختيار.

املأ عنوان بريد إلكتروني واطّلِع على قيمة أداة الاختيار ([data-automate=email-address]).

أولوية أداة الاختيار

يبحث المسجِّل عن المحدّدات بالترتيب التالي استنادًا إلى ما إذا كنت قد حدّدت سمة محدّد CSS مخصّص:

• في حال تحديدها:
  1. أداة اختيار CSS مع سمة CSS المخصّصة
  2. أدوات اختيار XPath
  3. محدِّد ARIA إذا تم العثور عليه
  4. أداة اختيار تتضمّن أقصر نص فريد إذا تم العثور عليه
• إذا لم يتم تحديده:
  1. محدِّد ARIA إذا تم العثور عليه
  2. أدوات اختيار لغة CSS ذات الأولوية التالية:
     1. في ما يلي السمات الأكثر شيوعًا المستخدَمة للاختبار:
        • data-testid
        • data-test
        • data-qa
        • data-cy
        • data-test-id
        • data-qa-id
        • data-testing
     2. سمات المعرّفات، مثل <div id="some_ID">
     3. أدوات اختيار لغة CSS العادية
  3. أدوات اختيار XPath
  4. أدوات اختيار العناصر التي يمكن اختراقها
  5. أداة اختيار تتضمّن أقصر نص فريد إذا تم العثور عليه

يمكن أن يكون هناك عدّة أدوات اختيار عادية لـ CSS وXPath وPierce. يُسجِّل تطبيق المسجّلة الذكية ما يلي:

• أدوات اختيار CSS وXPath العادية في كل مستوى جذر، أي المضيفون الظلّ المتداخلون، إن توفّروا
• اختراق المحدّدات الفريدة بين جميع العناصر ضمن جميع جذور الظل