ocrSetValue

إرسال سلسلة من ضربات المفاتيح إلى عنصر. ستقوم بـ:

• اكتشاف العنصر تلقائيًا
• تركيز الانتباه على الحقل بالنقر عليه
• تعيين القيمة في الحقل

سيبحث الأمر عن النص المقدم ويحاول العثور على تطابق استنادًا إلى المنطق الضبابي من Fuse.js. هذا يعني أنه إذا قدمت محددًا يحتوي على خطأ مطبعي، أو كان النص المعثور عليه لا يتطابق بنسبة 100٪، فسيحاول إعادة عنصر لك. انظر السجلات أدناه.

الاستخدام

await brower.ocrSetValue({
    text: "docs",
    value: "specfileretries",
});

الناتج

السجلات

[0-0] 2024-05-26T04:17:51.355Z INFO webdriver: COMMAND ocrSetValue(<object>)
......................
[0-0] 2024-05-26T04:17:52.356Z INFO @wdio/ocr-service:ocrGetElementPositionByText: We searched for the word "docs" and found one match "docs" with score "100%"

الخيارات

text

• النوع: string
• إلزامي: نعم

النص الذي تريد البحث عنه للنقر عليه.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
});

value

• النوع: string
• إلزامي: نعم

القيمة المراد إضافتها.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
});

submitValue

• النوع: boolean
• إلزامي: لا
• القيمة الافتراضية: false

إذا كانت القيمة تحتاج أيضًا إلى أن يتم إرسالها إلى حقل الإدخال. هذا يعني أنه سيتم إرسال مفتاح "ENTER" في نهاية السلسلة.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    submitValue: true,
});

clickDuration

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 500 مللي ثانية

هذه هي مدة النقر. إذا أردت يمكنك أيضًا إنشاء "نقرة طويلة" عن طريق زيادة الوقت.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    clickDuration: 3000, // هذا 3 ثوانٍ
});

contrast

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 0.25

كلما زاد التباين، زاد ظلام الصورة والعكس صحيح. يمكن أن يساعد ذلك في العثور على نص في صورة. يقبل قيمًا بين -1 و 1.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    contrast: 0.5,
});

haystack

• النوع: number
• إلزامي: WebdriverIO.Element | ChainablePromiseElement | Rectangle

هذه هي منطقة البحث في الشاشة حيث يحتاج OCR للبحث عن النص. يمكن أن يكون عنصرًا أو مستطيلًا يحتوي على x و y و width و height

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    haystack: $("elementSelector"),
});

// أو
await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    haystack: await $("elementSelector"),
});

// أو
await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    haystack: {
        x: 10,
        y: 50,
        width: 300,
        height: 75,
    },
});

language

• النوع: string
• إلزامي: لا
• القيمة الافتراضية: eng

اللغة التي سيتعرف عليها Tesseract. يمكن العثور على مزيد من المعلومات هنا ويمكن العثور على اللغات المدعومة هنا.

مثال

import { SUPPORTED_OCR_LANGUAGES } from "@wdio/ocr-service";
await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    // استخدام الهولندية كلغة
    language: SUPPORTED_OCR_LANGUAGES.DUTCH,
});

relativePosition

• النوع: object
• إلزامي: لا

يمكنك النقر على الشاشة بالنسبة إلى العنصر المطابق. يمكن القيام بذلك بناءً على البكسل النسبي above أو right أو below أو left من العنصر المطابق

ملاحظة

التركيبات التالية مسموح بها

• خصائص فردية
• above + left أو above + right
• below + left أو below + right

التركيبات التالية غير مسموح بها

• above مع below
• left مع right

relativePosition.above

• النوع: number
• إلزامي: لا

انقر على x بكسل above العنصر المطابق.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    relativePosition: {
        above: 100,
    },
});

relativePosition.right

• النوع: number
• إلزامي: لا

انقر على x بكسل right من العنصر المطابق.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    relativePosition: {
        right: 100,
    },
});

relativePosition.below

• النوع: number
• إلزامي: لا

انقر على x بكسل below العنصر المطابق.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    relativePosition: {
        below: 100,
    },
});

relativePosition.left

• النوع: number
• إلزامي: لا

انقر على x بكسل left من العنصر المطابق.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    relativePosition: {
        left: 100,
    },
});

fuzzyFindOptions

يمكنك تغيير المنطق الضبابي للعثور على النص باستخدام الخيارات التالية. قد يساعد ذلك في العثور على تطابق أفضل

fuzzyFindOptions.distance

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 100

يحدد مدى قرب التطابق من الموقع الضبابي (المحدد بالموقع). ستسجل مطابقة الحرف الدقيقة التي تبعد بمسافة أحرف عن الموقع الضبابي على أنها عدم تطابق كامل. تتطلب المسافة 0 أن يكون التطابق في الموقع المحدد بالضبط. ستتطلب مسافة 1000 تطابقًا مثاليًا ليكون ضمن 800 حرف من الموقع ليتم العثور عليه باستخدام عتبة 0.8.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        distance: 20,
    },
});

fuzzyFindOptions.location

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 0

يحدد تقريبًا أين في النص من المتوقع العثور على النمط.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        location: 20,
    },
});

fuzzyFindOptions.threshold

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 0.6

عند أي نقطة يستسلم خوارزمية المطابقة. تتطلب عتبة 0 تطابقًا مثاليًا (للأحرف والموقع)، وستطابق عتبة 1.0 أي شيء.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        threshold: 0.8,
    },
});

fuzzyFindOptions.isCaseSensitive

• النوع: boolean
• إلزامي: لا
• القيمة الافتراضية: false

ما إذا كان البحث يجب أن يكون حساسًا لحالة الأحرف.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        isCaseSensitive: true,
    },
});

fuzzyFindOptions.minMatchCharLength

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: 2

سيتم إرجاع المطابقات التي يتجاوز طولها هذه القيمة فقط. (على سبيل المثال، إذا كنت تريد تجاهل مطابقات الأحرف الفردية في النتيجة، قم بتعيينها إلى 2)

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        minMatchCharLength: 5,
    },
});

fuzzyFindOptions.findAllMatches

• النوع: number
• إلزامي: لا
• القيمة الافتراضية: false

عندما تكون true، ستستمر وظيفة المطابقة حتى نهاية نمط البحث حتى إذا تم بالفعل تحديد موقع تطابق مثالي في السلسلة.

مثال

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    fuzzyFindOptions: {
        findAllMatches: 100,
    },
});