Skip to main content

PlaywrightAssertions

Playwright 为你提供了 Web 优先断言以及创建断言的便捷方法,这些断言将等待并重试,直到满足预期条件。

¥Playwright gives you Web-First Assertions with convenience methods for creating assertions that will wait and retry until the expected condition is met.

考虑以下示例:

¥Consider the following example:

import { test, expect } from '@playwright/test';

test('status becomes submitted', async ({ page }) => {
// ...
await page.locator('#submit-button').click();
await expect(page.locator('.status')).toHaveText('Submitted');
});

Playwright 将使用选择器 .status 重新测试节点,直到获取的节点具有 "Submitted" 文本。它将重新获取节点并一遍又一遍地检查它,直到满足条件或达到超时。你可以将此超时作为一个选项传递。

¥Playwright will be re-testing the node with the selector .status until fetched Node has the "Submitted" text. It will be re-fetching the node and checking it over and over, until the condition is met or until the timeout is reached. You can pass this timeout as an option.

默认情况下,断言超时设置为 5 秒。

¥By default, the timeout for assertions is set to 5 seconds.


方法

¥Methods

expect(response)

Added in: v1.18 playwrightAssertions.expect(response)

为给定的 APIResponse 创建一个 APIResponseAssertions 对象。

¥Creates a APIResponseAssertions object for the given APIResponse.

用法

¥Usage

参数

¥Arguments

用于断言的 APIResponse 对象。

¥APIResponse object to use for assertions.

返回

¥Returns


expect(value)

Added in: v1.9 playwrightAssertions.expect(value)

为给定值创建 GenericAssertions 对象。

¥Creates a GenericAssertions object for the given value.

用法

¥Usage

expect(value);

参数

¥Arguments

将断言的值。

¥Value that will be asserted.

返回

¥Returns


expect(locator)

Added in: v1.18 playwrightAssertions.expect(locator)

为给定的 Locator 创建一个 LocatorAssertions 对象。

¥Creates a LocatorAssertions object for the given Locator.

用法

¥Usage

参数

¥Arguments

用于断言的 Locator 对象。

¥Locator object to use for assertions.

返回

¥Returns


expect(page)

Added in: v1.18 playwrightAssertions.expect(page)

为给定的 Page 创建一个 PageAssertions 对象。

¥Creates a PageAssertions object for the given Page.

用法

¥Usage

参数

¥Arguments

用于断言的 Page 对象。

¥Page object to use for assertions.

返回

¥Returns