Assertions

Playwright provides convenience APIs for common tasks, like reading the text content of an element. These APIs can be used in your test assertions.

• Text content
• Inner text
• Attribute value
• Checkbox state
• JS expression
• Inner HTML
• Visibility
• Enabled state
• Custom assertions

Text content

Sync

content = page.text_content("nav:first-child")

assert content == "home"

Async

content = await page.text_content("nav:first-child")

assert content == "home"

API reference

• page.inner_text(selector, **kwargs)
• element_handle.inner_text()

Inner text

Sync

text = page.inner_text(".selected")

assert text == "value"

Async

text = await page.inner_text(".selected")

assert text == "value"

API reference

• page.inner_text(selector, **kwargs)
• element_handle.inner_text()

Attribute value

Sync

checked = page.get_attribute("input", "alt")

assert alt == "Text"

Async

checked = await page.get_attribute("input", "alt")

assert alt == "Text"

Checkbox state

Sync

checked = page.is_checked("input")

assert checked

Async

checked = await page.is_checked("input")

assert checked

API reference

• page.is_checked(selector, **kwargs)
• element_handle.is_checked()

JS expression

Sync

content = page.eval_on_selector("nav:first-child", "e => e.textContent")

assert content == "home"

Async

content = await page.eval_on_selector("nav:first-child", "e => e.textContent")

assert content == "home"

API reference

• page.eval_on_selector(selector, expression, **kwargs)
• js_handle.evaluate(expression, **kwargs)

Inner HTML

Sync

html = page.inner_html("div.result")

assert html == "<p>Result</p>"

Async

html = await page.inner_html("div.result")

assert html == "<p>Result</p>"

API reference

• page.inner_html(selector, **kwargs)
• element_handle.inner_html()

Visibility

Sync

visible = page.is_visible("input")

assert visible

Async

visible = await page.is_visible("input")

assert visible

API reference

• page.is_visible(selector, **kwargs)
• element_handle.is_visible()

Enabled state

Sync

enabled = page.is_enabled("input")

assert enabled

Async

enabled = await page.is_enabled("input")

assert enabled

API reference

• page.is_enabled(selector, **kwargs)
• element_handle.is_enabled()

Custom assertions

With Playwright, you can also write custom JavaScript to run in the context of the browser. This is useful in situations where you want to assert for values that are not covered by the convenience APIs above.

Sync

# Assert local storage value

user_id = page.evaluate("() => window.localStorage.getItem('user_id')")

assert user_id

# Assert value for input element

page.wait_for_selector('#search')

value = page.eval_on_selector('#search', 'el => el.value')

assert value == 'query'

# Assert computed style

font_size = page.eval_on_selector('div', 'el => window.getComputedStyle(el).fontSize')

assert font_size == '16px'

# Assert list length

length = page.eval_on_selector_all('li.selected', '(items) => items.length')

assert length == 3

Async

# Assert local storage value

user_id = page.evaluate("() => window.localStorage.getItem('user_id')")

assert user_id

# Assert value for input element

await page.wait_for_selector('#search')

value = await page.eval_on_selector('#search', 'el => el.value')

assert value == 'query'

# Assert computed style

font_size = await page.eval_on_selector('div', 'el => window.getComputedStyle(el).fontSize')

assert font_size == '16px'

# Assert list length

length = await page.eval_on_selector_all('li.selected', '(items) => items.length')

assert length == 3

API reference

• page.evaluate(expression, **kwargs)
• page.eval_on_selector(selector, expression, **kwargs)
• page.eval_on_selector_all(selector, expression, **kwargs)
• frame.evaluate(expression, **kwargs)
• frame.eval_on_selector(selector, expression, **kwargs)
• frame.eval_on_selector_all(selector, expression, **kwargs)
• element_handle.eval_on_selector(selector, expression, **kwargs)
• element_handle.eval_on_selector_all(selector, expression, **kwargs)
• [EvaluationArgument]