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

• 類型： 字串
• 必要： 是

您要搜尋以點擊的文字。

範例

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

value

• 類型： 字串
• 必要： 是

要加入的值。

範例

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

submitValue

• 類型： 布林值
• 必要： 否
• 預設值： false

是否也需要將值提交到輸入欄位。這表示在字串結尾會傳送「ENTER」。

範例

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

clickDuration

• 類型： 數字
• 必要： 否
• 預設值： 500 毫秒

這是點擊的持續時間。如果您想，也可以透過增加時間來建立「長點擊」。

範例

await browser.ocrSetValue({
    text: "WebdriverIO",
    value: "The Value",
    clickDuration: 3000, // This is 3 seconds
});

contrast

• 類型： 數字
• 必要： 否
• 預設值： 0.25

對比度越高，影像越暗，反之亦然。這有助於在影像中尋找文字。它接受 -1 到 1 之間的值。

範例

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

haystack

• 類型： 數字
• 必要： 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

• 類型： 字串
• 必要： 否
• 預設值： 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

• 類型： 物件
• 必要： 否

您可以點擊螢幕上相對於匹配元素的座標。這可以根據相對於匹配元素的 above、right、below 或 left 的相對像素來完成

注意

允許以下組合

• 單一屬性
• above + left 或 above + right
• below + left 或 below + right

不允許以下組合

• above 加 below
• left 加 right

relativePosition.above

• 類型： 數字
• 必要： 否

點擊匹配元素 上方 x 個像素。

範例

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

relativePosition.right

• 類型： 數字
• 必要： 否

點擊匹配元素 右方 x 個像素。

範例

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

relativePosition.below

• 類型： 數字
• 必要： 否

點擊匹配元素 下方 x 個像素。

範例

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

relativePosition.left

• 類型： 數字
• 必要： 否

點擊匹配元素 左方 x 個像素。

範例

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

fuzzyFindOptions

您可以使用以下選項來修改模糊邏輯以尋找文字。這可能有助於找到更好的匹配項

fuzzyFindOptions.distance

• 類型： 數字
• 必要： 否
• 預設值 100

決定匹配項必須與模糊位置（由 location 指定）有多接近。距離模糊位置有 distance 個字元的完全字母匹配會被評為完全不匹配。距離為 0 需要匹配項位於指定位置。距離為 1000 需要完美匹配在 800 個字元內，且使用 0.8 的閾值才能找到。

範例

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

fuzzyFindOptions.location

• 類型： 數字
• 必要： 否
• 預設值 0

決定預期在文字中找到模式的大概位置。

範例

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

fuzzyFindOptions.threshold

• 類型： 數字
• 必要： 否
• 預設值 0.6

匹配演算法在什麼時候放棄。閾值為 0 需要完美匹配（字母和位置），閾值為 1.0 會匹配任何內容。

範例

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

fuzzyFindOptions.isCaseSensitive

• 類型： 布林值
• 必要： 否
• 預設值： false

搜尋是否應區分大小寫。

範例

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

fuzzyFindOptions.minMatchCharLength

• 類型： 數字
• 必要： 否
• 預設值 2

只會回傳長度超過此值的匹配項。（例如，如果您想忽略結果中的單一字元匹配項，請將其設定為 2）

範例

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

fuzzyFindOptions.findAllMatches

• 類型： 數字
• 必要： 否
• 預設值： false

當 true 時，即使字串中已找到完全匹配的項目，匹配函數仍會繼續搜尋到搜尋模式的結尾。

範例

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