ocrSetValue

ارسال یک مجموعه از کلیدها به یک عنصر. این کار:

• به صورت خودکار عنصر را تشخیص می‌دهد
• با کلیک روی آن، فوکوس را روی فیلد قرار می‌دهد
• مقدار را در فیلد تنظیم می‌کند

این دستور متن ارائه شده را جستجو می‌کند و سعی می‌کند براساس منطق فازی از Fuse.js تطبیقی پیدا کند. این بدان معنی است که اگر یک انتخابگر با اشتباه تایپی ارائه دهید، یا متن یافت شده تطابق ۱۰۰٪ نباشد، همچنان سعی می‌کند یک عنصر به شما برگرداند. به لاگ‌ها زیر توجه کنید.

استفاده

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, // This is 3 seconds
});

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"),
});

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

// OR
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",
    // Use Dutch as a language
    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 پیکسل بالاتر از عنصر تطبیقی کلیک کنید.

مثال

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

relativePosition.right

• نوع: number
• اجباری: خیر

x پیکسل راست از عنصر تطبیقی کلیک کنید.

مثال

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

relativePosition.below

• نوع: number
• اجباری: خیر

x پیکسل پایین‌تر از عنصر تطبیقی کلیک کنید.

مثال

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

relativePosition.left

• نوع: number
• اجباری: خیر

x پیکسل چپ از عنصر تطبیقی کلیک کنید.

مثال

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

fuzzyFindOptions

می‌توانید منطق فازی را برای یافتن متن با گزینه‌های زیر تغییر دهید. این می‌تواند به یافتن تطابق بهتر کمک کند.

fuzzyFindOptions.distance

• نوع: number
• اجباری: خیر
• پیش‌فرض: 100

تعیین می‌کند که تطابق چقدر باید به موقعیت فازی (مشخص شده توسط location) نزدیک باشد. یک تطابق دقیق حرفی که به فاصله چند کاراکتر از موقعیت فازی باشد، به عنوان عدم تطابق کامل امتیازبندی می‌شود. فاصله 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,
    },
});