Skip to main content

PageAssertions

PageAssertions 类提供了断言方法，可用于对测试中的 Page 状态进行断言。

¥The PageAssertions class provides assertion methods that can be used to make assertions about the Page state in the tests.

// ...
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;

public class TestPage {
  // ...
  @Test
  void navigatesToLoginPage() {
    // ...
    page.getByText("Sign in").click();
    assertThat(page).hasURL(Pattern.compile(".*/login"));
  }
}

方法​

¥Methods

hasTitle​

Added in: v1.20 pageAssertions.hasTitle

确保页面具有给定的标题。

¥Ensures the page has the given title.

用法

¥Usage

assertThat(page).hasTitle("Playwright");

参数

¥Arguments

预期的标题或正则表达式。

¥Expected title or RegExp.

  • options PageAssertions.HasTitleOptions（可选）

    ¥options PageAssertions.HasTitleOptions (optional)

    • setTimeout double (optional) Added in: v1.18#

重试断言的时间（以毫秒为单位）。默认为 5000。

¥Time to retry the assertion for in milliseconds. Defaults to 5000.

返回

¥Returns

hasURL​

Added in: v1.20 pageAssertions.hasURL

确保页面导航到给定的 URL。

¥Ensures the page is navigated to the given URL.

用法

¥Usage

assertThat(page).hasURL(".com");

参数

¥Arguments

需要 URL 字符串或正则表达式。

¥Expected URL string or RegExp.

  • options PageAssertions.HasURLOptions（可选）

    ¥options PageAssertions.HasURLOptions (optional)

    • setIgnoreCase boolean (optional) Added in: v1.44#

是否进行不区分大小写的匹配。如果指定，setIgnoreCase 选项优先于相应的正则表达式参数。提供的谓词会忽略此标志。

¥Whether to perform case-insensitive match. setIgnoreCase option takes precedence over the corresponding regular expression parameter if specified. A provided predicate ignores this flag.

  • setTimeout double (optional) Added in: v1.18#

重试断言的时间（以毫秒为单位）。默认为 5000。

¥Time to retry the assertion for in milliseconds. Defaults to 5000.

返回

¥Returns

属性​

¥Properties

not()​

Added in: v1.20 pageAssertions.not()

使断言检查相反的条件。例如，此代码测试页面 URL 是否不包含 "error"：

¥Makes the assertion check for the opposite condition. For example, this code tests that the page URL doesn't contain "error":

assertThat(page).not().hasURL("error");

用法

¥Usage

assertThat(page).not()

返回

¥Returns