مرجع الميزات

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

• الدمى المتحركة (بما في ذلك تحليل 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 إلى نصوص برمجية مخصّصة:

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

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

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

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

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

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

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

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

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 الذي يمكن تداخله على سبيل المثال، يمكنك تحديد أول (0) إطار 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" على صفحة العرض التوضيحي هذه والاطّلاع على سمات الاختبار:

سجِّل نقرة على "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 العادية في كل مستوى جذر، أي مضيفات الظل المدمجة، إن وجدت.
• اختراق المحدّدات الفريدة بين جميع العناصر ضمن جميع جذور الظل