مرجع الميزات

Sofia Emelianova
Sofia Emelianova
GitHub
Jecelyn Yeen

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

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

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

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

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

زر "عرض الاختصارات".

لتخصيص اختصارات المسجّلة الذكية، اتّبِع الخطوات التالية:

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

تعديل تدفقات المستخدم

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

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

  1. إضافة تسجيل جديدإضافة.. انقر على الرمز + من أجل إضافة تسجيل جديد.
  2. عرض كل التسجيلاتعرض معلومات أكثر تعرض القائمة المنسدلة قائمة التسجيلات المحفوظة. حدِّد خيار [number] تسجيلاً لتوسيع قائمة التسجيلات المحفوظة وإدارتها. عرض كل التسجيلات

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

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

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

  5. حذف تسجيلحذف. احذف التسجيل الذي اخترته.

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

مشاركة تدفقات المستخدم

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

تصدير تدفق المستخدم

لتصدير تدفق المستخدم:

  1. افتح تدفق المستخدم الذي تريد تصديره.
  2. انقر على تنزيل الملف. تصدير في أعلى لوحة المسجّلة الذكية. تصدير خيارات التنسيق
  3. اختَر أحد التنسيقات التالية من القائمة المنسدلة:
    • ملف JSON نزِّل التسجيل كملف JSON.
    • @puppeteer/replay. نزِّل التسجيل كنص برمجي Puppeteer Replay.
    • محرك الدُمى: نزِّل التسجيل كنص برمجي Puppeteer.
    • الدمى المتحركة (بما في ذلك تحليل Lighthouse): نزِّل التسجيل كنص برمجي Puppeteer مع تحليل Lighthouse مضمَّن.
    • توفّر إضافات التصدير في تطبيق "المسجّلة الذكية" خيارًا واحدًا أو أكثر.
  4. احفظ الملف.

يمكنك إجراء ما يلي مع كل خيار تصدير تلقائي:

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

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

    شغِّل النص البرمجي واطّلِع على النتيجة في ملف flow.report.html:

    # npm i puppeteer lighthouse
node your_export.js

    تم فتح تقرير Lighthouse في Chrome.

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

يُرجى الاطّلاع على إضافات المسجّلة الذكية.

استيراد تدفق المستخدم

لاستيراد تدفق مستخدم:

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

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

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

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

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

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

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

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

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

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

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

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

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

فحص الرمز البرمجي

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

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

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

    القائمة المنسدلة للتنسيق.

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

  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. انقر على الأزرار المقابلة لإضافة خصائص اختيارية خاصة بالنوع وتحديدها.

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

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

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

خصائص الخطوات

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

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

  • 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 >= | == (تلقائي) | &lt;=
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 يؤدي إلى true
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.

    فئات 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 وPirce. تسجِّل المسجّلة ما يلي:

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