斷言

斷言列表

Assertion	Description
expect(locator).to_be_attached()	元素已附加
expect(locator).to_be_checked()	勾選框已勾選
expect(locator).to_be_disabled()	元素已停用
expect(locator).to_be_editable()	元素可編輯
expect(locator).to_be_empty()	容器為空
expect(locator).to_be_enabled()	元素已啟用
expect(locator).to_be_focused()	元素已聚焦
expect(locator).to_be_hidden()	元素不可見
expect(locator).to_be_in_viewport()	元素與視口相交
expect(locator).to_be_visible()	元素可見
expect(locator).to_contain_text()	元素包含文字
expect(locator).to_have_accessible_description()	元素具有匹配的可訪問描述
expect(locator).to_have_accessible_name()	元素具有匹配的可訪問名稱
expect(locator).to_have_attribute()	元素具有 DOM 屬性
expect(locator).to_have_class()	元素具有類別屬性
expect(locator).to_have_count()	列表具有確切的子項數量
expect(locator).to_have_css()	元素具有 CSS 屬性
expect(locator).to_have_id()	元素具有 ID
expect(locator).to_have_js_property()	元素具有 JavaScript 屬性
expect(locator).to_have_role()	元素具有特定的ARIA 角色
expect(locator).to_have_text()	元素匹配文字
expect(locator).to_have_value()	輸入具有值
expect(locator).to_have_values()	選擇具有選中的選項
expect(page).to_have_title()	頁面具有標題
expect(page).to_have_url()	頁面具有 URL
expect(response).to_be_ok()	回應具有 OK 狀態

自訂期望訊息

您可以指定一個自訂的預期訊息作為 expect 函式的第二個參數，例如:

expect(page.get_by_text("Name"), "should be logged in").to_be_visible()

當 expect 失敗時，錯誤會看起來像這樣:

    def test_foobar(page: Page) -> None:
>       expect(page.get_by_text("Name"), "should be logged in").to_be_visible()
E       AssertionError: should be logged in
E       Actual value: None
E       Call log:
E       LocatorAssertions.to_be_visible with timeout 5000ms
E       waiting for get_by_text("Name")
E       waiting for get_by_text("Name")

tests/test_foobar.py:22: AssertionError

設定 a custom timeout

您可以為斷言指定自訂的超時時間，無論是全域還是每個斷言。預設的超時時間為 5 秒。

全域 timeout

conftest.py

from playwright.sync_api import expect

expect.set_options(timeout=10_000)

每個斷言超時

test_foobar.py

from playwright.sync_api import expect

def test_foobar(page: Page) -> None:
    expect(page.get_by_text("Name")).to_be_visible(timeout=10_000)