Skip to main content

PageAssertions

PageAssertions 類別提供斷言方法,可用於對測試中的 Page 狀態進行斷言。

import re
from playwright.sync_api import Page, expect

def test_navigates_to_login_page(page: Page) -> None:
# ..
page.get_by_text("Sign in").click()
expect(page).to_have_url(re.compile(r".*/login"))

方法

not_to_have_title

Added in: v1.20 pageAssertions.not_to_have_title

expect(page).to_have_title() 相反。

Usage

expect(page).not_to_have_title(title_or_reg_exp)
expect(page).not_to_have_title(title_or_reg_exp, **kwargs)

Arguments

  • title_or_reg_exp str | PatternAdded in: v1.18#

    預期的標題或 RegExp。

  • timeout float (optional)Added in: v1.18#

    重試斷言的時間(以毫秒為單位)。預設為 5000

Returns


not_to_have_url

Added in: v1.20 pageAssertions.not_to_have_url

expect(page).to_have_url() 相反。

Usage

expect(page).not_to_have_url(url_or_reg_exp)
expect(page).not_to_have_url(url_or_reg_exp, **kwargs)

Arguments

  • url_or_reg_exp str | PatternAdded in: v1.18#

    預期的 URL 字串或 RegExp。

  • ignore_case bool (optional)Added in: v1.44#

    是否執行不區分大小寫的匹配。ignore_case 選項優先於對應的正規表示式標誌 (如果指定)。

  • timeout float (optional)Added in: v1.18#

    重試斷言的時間(以毫秒為單位)。預設為 5000

Returns


to_have_title

Added in: v1.20 pageAssertions.to_have_title

確保頁面具有指定的標題。

Usage

import re
from playwright.sync_api import expect

# ...
expect(page).to_have_title(re.compile(r".*checkout"))

Arguments

  • title_or_reg_exp str | PatternAdded in: v1.18#

    預期的標題或 RegExp。

  • timeout float (optional)Added in: v1.18#

    重試斷言的時間(以毫秒為單位)。預設為 5000

Returns


to_have_url

Added in: v1.20 pageAssertions.to_have_url

確保頁面導航到指定的 URL。

Usage

import re
from playwright.sync_api import expect

# ...
expect(page).to_have_url(re.compile(".*checkout"))

Arguments

  • url_or_reg_exp str | PatternAdded in: v1.18#

    預期的 URL 字串或 RegExp。

  • ignore_case bool (optional)Added in: v1.44#

    是否執行不區分大小寫的匹配。ignore_case 選項優先於對應的正規表示式標誌 (如果指定)。

  • timeout float (optional)Added in: v1.18#

    重試斷言的時間(以毫秒為單位)。預設為 5000

Returns