跳至主要内容

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, // 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
  • 必填： 否

点击匹配元素above x 个像素。

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

relativePosition.right​

  • 类型： number
  • 必填： 否

点击匹配元素right x 个像素。

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

relativePosition.below​

  • 类型： number
  • 必填： 否

点击匹配元素below x 个像素。

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

relativePosition.left​

  • 类型： number
  • 必填： 否

点击匹配元素left x 个像素。

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

fuzzyFindOptions​

您可以使用以下选项更改模糊逻辑以查找文本。这可能有助于找到更好的匹配项。

fuzzyFindOptions.distance​

  • 类型： number
  • 必填： 否
  • 默认值 100

确定匹配项与模糊位置（由位置指定）的接近程度。与模糊位置距离 distance 个字符的精确字母匹配将被评分为完全不匹配。距离为 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,
    },
});

欢迎！我如何帮助您？

WebdriverIO AI Copilot