メインコンテンツにスキップ

PlaywrightAssertions

Playwrightは、期待される条件が満たされるまで待機して再試行するアサーションを作成するための便利なメソッドを備えた、Web-Firstのアサーションを提供します。

次の例を考えてみましょう。

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

public class TestExample {
  // ...
  @Test
  void statusBecomesSubmitted() {
    // ...
    page.locator("#submit-button").click();
    assertThat(page.locator(".status")).hasText("Submitted");
  }
}

Playwright は、選択子 .status を持つノードを再テストし、取得されたノードが "Submitted" テキストを持つまで続けます。このノードは、条件が満たされるかタイムアウトに達するまで、繰り返し取得およびチェックされます。このタイムアウトはオプションとして渡すことができます。

デフォルトでは、アサーションのタイムアウトは5秒に設定されています。

メソッド​

assertThat(response)​

追加: v1.18 playwrightAssertions.assertThat(response)

指定されたAPIResponseに対してAPIResponseAssertionsオブジェクトを作成します。

使用法

PlaywrightAssertions.assertThat(response).isOK();

引数

戻り値

assertThat(locator)​

追加: v1.18 playwrightAssertions.assertThat(locator)

指定されたLocatorに対してLocatorAssertionsオブジェクトを作成します。

使用法

PlaywrightAssertions.assertThat(locator).isVisible();

引数

  • locator Locator#

    アサーションに使用するLocatorオブジェクト。

戻り値

assertThat(page)​

追加: v1.18 playwrightAssertions.assertThat(page)

指定されたPageに対してPageAssertionsオブジェクトを作成します。

使用法

PlaywrightAssertions.assertThat(page).hasTitle("News");

引数

  • page Page#

    アサーションに使用するPageオブジェクト。

戻り値

setDefaultAssertionTimeout​

追加バージョン: v1.25 playwrightAssertions.setDefaultAssertionTimeout

Playwrightアサーションのデフォルトのタイムアウトを5秒から指定された値に変更します。

使用法

PlaywrightAssertions.setDefaultAssertionTimeout(30_000);

引数

  • timeout double#

    タイムアウト（ミリ秒単位）。