Expect

在编写测试时，您经常需要检查值是否满足特定条件。 expect 为您提供了许多"匹配器"，让您能够在 browser 、 element 或 mock 对象上进行各种验证。

默认选项 ​

以下默认选项与配置中设置的 waitforTimeout 和 waitforInterval 选项相关联。

只有当您想为断言设置特定的超时时间时，才需要设置以下选项。

{
    wait: 2000, // ms to wait for expectation to succeed
    interval: 100, // interval between attempts
}

如果您想选择不同的超时和间隔时间，可以这样设置这些选项：

// wdio.conf.js
import { setOptions } from 'expect-webdriverio'

export const config = {
    // ...
    before () {
        setOptions({ wait: 5000 })
    },
    // ...
}

匹配器选项 ​

每个匹配器都可以接受多个选项，允许您修改断言：

命令选项 ​

字符串选项 ​

在断言字符串时，可以在命令选项之外应用此选项。

数字选项 ​

在断 言数字时，可以在命令选项之外应用此选项。

处理 HTML 实体 ​

HTML 实体是一段以"&"符号开始并以分号";"结束的文本（"字符串"）。实体通常用于显示保留字符（否则会被解释为 HTML 代码）和不可见字符（如不间断空格，例如   ）。

要查找或与此类元素交互，请使用实体的 Unicode 等效项。例如：

<div data="Some&nbsp;Value">Some&nbsp;Text</div>

const myElem = await $('div[data="Some\u00a0Value"]')
await expect(myElem).toHaveAttribute('data', 'div[Some\u00a0Value')
await expect(myElem).toHaveText('Some\u00a0Text')

您可以在 HTML 规范 中找到所有 Unicode 引用。

注意： Unicode 不区分大小写，因此 \u00a0 和 \u00A0 都有效。要在浏览器检查中查找元素，请从 Unicode 中删除 u ，例如： div[data="Some\00a0Value"]

浏览器匹配器 ​

toHaveUrl ​

检查浏览器是否在特定页面上。

await browser.url('https://webdriver.io/')
await expect(browser).toHaveUrl('https://webdriver.io')

await browser.url('https://webdriver.io/')
await expect(browser).toHaveUrl(expect.stringContaining('webdriver'))

toHaveTitle ​

检查网站是否有特定标题。

await browser.url('https://webdriver.io/')
await expect(browser).toHaveTitle('WebdriverIO · Next-gen browser and mobile automation test framework for Node.js')
await expect(browser).toHaveTitle(expect.stringContaining('WebdriverIO'))

toHaveClipboardText ​

检查浏览器的剪贴板中是否存储了特定文本。

import { Key } from 'webdriverio'

await browser.keys([Key.Ctrl, 'a'])
await browser.keys([Key.Ctrl, 'c'])
await expect(browser).toHaveClipboardText('some clipboard text')
await expect(browser).toHaveClipboardText(expect.stringContaining('clipboard text'))

元素匹配器 ​

toBeDisplayed ​

在给定元素上调用 isDisplayed 。

const elem = await $('#someElem')
await expect(elem).toBeDisplayed()

toExist ​

在给定元素上调用 isExisting 。

const elem = await $('#someElem')
await expect(elem).toExist()

toBePresent ​