PageAssertions
Added in: v1.17The PageAssertions class provides assertion methods that can be used to make assertions about the Page state in the tests.
import re
from playwright.async_api import Page, expect
async def test_navigates_to_login_page(page: Page) -> None:
# ..
await page.get_by_text("Sign in").click()
await expect(page).to_have_url(re.compile(r".*/login"))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"))Methods
page_assertions.not_to_have_title()
Added in: v1.20The opposite of page_assertions.to_have_title().
Arguments
page_assertions.not_to_have_url()
Added in: v1.20The opposite of page_assertions.to_have_url().
Arguments
url_or_reg_expstring | RegExpAdded in: v1.18Expected URL string or RegExp.
ignore_caseboolean(optional) Added in: v1.44Whether to perform case-insensitive match.
ignore_caseoption takes precedence over the corresponding regular expression flag if specified.timeoutfloat(optional) Added in: v1.18Time to retry the assertion for in milliseconds. Defaults to
5000.
page_assertions.not_to_match_aria_snapshot()
Added in: v1.60The opposite of page_assertions.to_match_aria_snapshot().
Arguments
page_assertions.to_have_title()
Added in: v1.20Ensures the page has the given title.
Usage
import re
from playwright.async_api import expect
# ...
await expect(page).to_have_title(re.compile(r".*checkout"))import re
from playwright.sync_api import expect
# ...
expect(page).to_have_title(re.compile(r".*checkout"))Arguments
page_assertions.to_have_url()
Added in: v1.20Ensures the page is navigated to the given URL.
Usage
import re
from playwright.async_api import expect
# ...
await expect(page).to_have_url(re.compile(".*checkout"))import re
from playwright.sync_api import expect
# ...
expect(page).to_have_url(re.compile(".*checkout"))Arguments
url_or_reg_expstring | RegExpAdded in: v1.18Expected URL string or RegExp.
ignore_caseboolean(optional) Added in: v1.44Whether to perform case-insensitive match.
ignore_caseoption takes precedence over the corresponding regular expression parameter if specified. A provided predicate ignores this flag.timeoutfloat(optional) Added in: v1.18Time to retry the assertion for in milliseconds. Defaults to
5000.
page_assertions.to_match_aria_snapshot()
Added in: v1.60Asserts that the page body matches the given accessibility snapshot.
Usage
await page.goto("https://demo.playwright.dev/todomvc/")
await expect(page).to_match_aria_snapshot('''
- heading "todos"
- textbox "What needs to be done?"
''')page.goto("https://demo.playwright.dev/todomvc/")
expect(page).to_match_aria_snapshot('''
- heading "todos"
- textbox "What needs to be done?"
''')Arguments