Class: Playwright::LocatorAssertions
- Inherits:
-
PlaywrightApi
- Object
- PlaywrightApi
- Playwright::LocatorAssertions
- Defined in:
- lib/playwright_api/locator_assertions.rb
Overview
The ‘LocatorAssertions` class provides assertion methods that can be used to make assertions about the `Locator` state in the tests.
“‘python sync from playwright.sync_api import Page, expect
def test_status_becomes_submitted(page: Page) -> None:
# ..
page.get_by_role("button").click()
expect(page.locator(".status")).to_have_text("Submitted")
“‘
Instance Method Summary collapse
-
#not_to_be_attached(attached: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeAttached`].
-
#not_to_be_checked(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeChecked`].
-
#not_to_be_disabled(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeDisabled`].
-
#not_to_be_editable(editable: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEditable`].
-
#not_to_be_empty(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEmpty`].
-
#not_to_be_enabled(enabled: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEnabled`].
-
#not_to_be_focused(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeFocused`].
-
#not_to_be_hidden(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeHidden`].
-
#not_to_be_in_viewport(ratio: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeInViewport`].
-
#not_to_be_visible(timeout: nil, visible: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeVisible`].
-
#not_to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toContainText`].
-
#not_to_have_accessible_description(name, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAccessibleDescription`].
-
#not_to_have_accessible_name(name, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAccessibleName`].
-
#not_to_have_attribute(name, value, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAttribute`].
-
#not_to_have_class(expected, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveClass`].
-
#not_to_have_count(count, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveCount`].
-
#not_to_have_css(name, value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveCSS`].
-
#not_to_have_id(id, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveId`].
-
#not_to_have_js_property(name, value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveJSProperty`].
-
#not_to_have_role(role, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveRole`].
-
#not_to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveText`].
-
#not_to_have_value(value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveValue`].
-
#not_to_have_values(values, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveValues`].
-
#to_be_attached(attached: nil, timeout: nil) ⇒ Object
Ensures that ‘Locator` points to an element that is [connected](developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
-
#to_be_checked(checked: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a checked input.
-
#to_be_disabled(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a disabled element.
-
#to_be_editable(editable: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an editable element.
-
#to_be_empty(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an empty editable element or to a DOM node that has no text.
-
#to_be_enabled(enabled: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an enabled element.
-
#to_be_focused(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a focused DOM node.
-
#to_be_hidden(timeout: nil) ⇒ Object
Ensures that ‘Locator` either does not resolve to any DOM node, or resolves to a [non-visible](../actionability.md#visible) one.
-
#to_be_in_viewport(ratio: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element that intersects viewport, according to the [intersection observer API](developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
-
#to_be_visible(timeout: nil, visible: nil) ⇒ Object
Ensures that ‘Locator` points to an attached and [visible](../actionability.md#visible) DOM node.
-
#to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
Ensures the ‘Locator` points to an element that contains the given text.
-
#to_have_accessible_description(description, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [accessible description](w3c.github.io/accname/#dfn-accessible-description).
-
#to_have_accessible_name(name, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [accessible name](w3c.github.io/accname/#dfn-accessible-name).
-
#to_have_attribute(name, value, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given attribute.
-
#to_have_class(expected, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given CSS classes.
-
#to_have_count(count, timeout: nil) ⇒ Object
Ensures the ‘Locator` resolves to an exact number of DOM nodes.
-
#to_have_css(name, value, timeout: nil) ⇒ Object
Ensures the ‘Locator` resolves to an element with the given computed CSS style.
-
#to_have_id(id, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given DOM Node ID.
-
#to_have_js_property(name, value, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given JavaScript property.
-
#to_have_role(role, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [ARIA role](www.w3.org/TR/wai-aria-1.2/#roles).
-
#to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given text.
-
#to_have_value(value, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given input value.
-
#to_have_values(values, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the specified values are selected.
Methods inherited from PlaywrightApi
Constructor Details
This class inherits a constructor from Playwright::PlaywrightApi
Instance Method Details
#not_to_be_attached(attached: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeAttached`].
17 18 19 |
# File 'lib/playwright_api/locator_assertions.rb', line 17 def not_to_be_attached(attached: nil, timeout: nil) wrap_impl(@impl.not_to_be_attached(attached: unwrap_impl(attached), timeout: unwrap_impl(timeout))) end |
#not_to_be_checked(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeChecked`].
23 24 25 |
# File 'lib/playwright_api/locator_assertions.rb', line 23 def not_to_be_checked(timeout: nil) wrap_impl(@impl.not_to_be_checked(timeout: unwrap_impl(timeout))) end |
#not_to_be_disabled(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeDisabled`].
29 30 31 |
# File 'lib/playwright_api/locator_assertions.rb', line 29 def not_to_be_disabled(timeout: nil) wrap_impl(@impl.not_to_be_disabled(timeout: unwrap_impl(timeout))) end |
#not_to_be_editable(editable: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEditable`].
35 36 37 |
# File 'lib/playwright_api/locator_assertions.rb', line 35 def not_to_be_editable(editable: nil, timeout: nil) wrap_impl(@impl.not_to_be_editable(editable: unwrap_impl(editable), timeout: unwrap_impl(timeout))) end |
#not_to_be_empty(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEmpty`].
41 42 43 |
# File 'lib/playwright_api/locator_assertions.rb', line 41 def not_to_be_empty(timeout: nil) wrap_impl(@impl.not_to_be_empty(timeout: unwrap_impl(timeout))) end |
#not_to_be_enabled(enabled: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeEnabled`].
47 48 49 |
# File 'lib/playwright_api/locator_assertions.rb', line 47 def not_to_be_enabled(enabled: nil, timeout: nil) wrap_impl(@impl.not_to_be_enabled(enabled: unwrap_impl(enabled), timeout: unwrap_impl(timeout))) end |
#not_to_be_focused(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeFocused`].
53 54 55 |
# File 'lib/playwright_api/locator_assertions.rb', line 53 def not_to_be_focused(timeout: nil) wrap_impl(@impl.not_to_be_focused(timeout: unwrap_impl(timeout))) end |
#not_to_be_hidden(timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeHidden`].
59 60 61 |
# File 'lib/playwright_api/locator_assertions.rb', line 59 def not_to_be_hidden(timeout: nil) wrap_impl(@impl.not_to_be_hidden(timeout: unwrap_impl(timeout))) end |
#not_to_be_in_viewport(ratio: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeInViewport`].
65 66 67 |
# File 'lib/playwright_api/locator_assertions.rb', line 65 def (ratio: nil, timeout: nil) wrap_impl(@impl.(ratio: unwrap_impl(ratio), timeout: unwrap_impl(timeout))) end |
#not_to_be_visible(timeout: nil, visible: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toBeVisible`].
71 72 73 |
# File 'lib/playwright_api/locator_assertions.rb', line 71 def not_to_be_visible(timeout: nil, visible: nil) wrap_impl(@impl.not_to_be_visible(timeout: unwrap_impl(timeout), visible: unwrap_impl(visible))) end |
#not_to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toContainText`].
77 78 79 |
# File 'lib/playwright_api/locator_assertions.rb', line 77 def not_to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) wrap_impl(@impl.not_to_contain_text(unwrap_impl(expected), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout), useInnerText: unwrap_impl(useInnerText))) end |
#not_to_have_accessible_description(name, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAccessibleDescription`].
83 84 85 |
# File 'lib/playwright_api/locator_assertions.rb', line 83 def not_to_have_accessible_description(name, ignoreCase: nil, timeout: nil) wrap_impl(@impl.not_to_have_accessible_description(unwrap_impl(name), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#not_to_have_accessible_name(name, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAccessibleName`].
89 90 91 |
# File 'lib/playwright_api/locator_assertions.rb', line 89 def not_to_have_accessible_name(name, ignoreCase: nil, timeout: nil) wrap_impl(@impl.not_to_have_accessible_name(unwrap_impl(name), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#not_to_have_attribute(name, value, ignoreCase: nil, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveAttribute`].
95 96 97 |
# File 'lib/playwright_api/locator_assertions.rb', line 95 def not_to_have_attribute(name, value, ignoreCase: nil, timeout: nil) wrap_impl(@impl.not_to_have_attribute(unwrap_impl(name), unwrap_impl(value), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#not_to_have_class(expected, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveClass`].
101 102 103 |
# File 'lib/playwright_api/locator_assertions.rb', line 101 def not_to_have_class(expected, timeout: nil) wrap_impl(@impl.not_to_have_class(unwrap_impl(expected), timeout: unwrap_impl(timeout))) end |
#not_to_have_count(count, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveCount`].
107 108 109 |
# File 'lib/playwright_api/locator_assertions.rb', line 107 def not_to_have_count(count, timeout: nil) wrap_impl(@impl.not_to_have_count(unwrap_impl(count), timeout: unwrap_impl(timeout))) end |
#not_to_have_css(name, value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveCSS`].
113 114 115 |
# File 'lib/playwright_api/locator_assertions.rb', line 113 def not_to_have_css(name, value, timeout: nil) wrap_impl(@impl.not_to_have_css(unwrap_impl(name), unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#not_to_have_id(id, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveId`].
119 120 121 |
# File 'lib/playwright_api/locator_assertions.rb', line 119 def not_to_have_id(id, timeout: nil) wrap_impl(@impl.not_to_have_id(unwrap_impl(id), timeout: unwrap_impl(timeout))) end |
#not_to_have_js_property(name, value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveJSProperty`].
125 126 127 |
# File 'lib/playwright_api/locator_assertions.rb', line 125 def not_to_have_js_property(name, value, timeout: nil) wrap_impl(@impl.not_to_have_js_property(unwrap_impl(name), unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#not_to_have_role(role, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveRole`].
131 132 133 |
# File 'lib/playwright_api/locator_assertions.rb', line 131 def not_to_have_role(role, timeout: nil) wrap_impl(@impl.not_to_have_role(unwrap_impl(role), timeout: unwrap_impl(timeout))) end |
#not_to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveText`].
137 138 139 |
# File 'lib/playwright_api/locator_assertions.rb', line 137 def not_to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) wrap_impl(@impl.not_to_have_text(unwrap_impl(expected), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout), useInnerText: unwrap_impl(useInnerText))) end |
#not_to_have_value(value, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveValue`].
143 144 145 |
# File 'lib/playwright_api/locator_assertions.rb', line 143 def not_to_have_value(value, timeout: nil) wrap_impl(@impl.not_to_have_value(unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#not_to_have_values(values, timeout: nil) ⇒ Object
The opposite of [‘method: LocatorAssertions.toHaveValues`].
149 150 151 |
# File 'lib/playwright_api/locator_assertions.rb', line 149 def not_to_have_values(values, timeout: nil) wrap_impl(@impl.not_to_have_values(unwrap_impl(values), timeout: unwrap_impl(timeout))) end |
#to_be_attached(attached: nil, timeout: nil) ⇒ Object
Ensures that ‘Locator` points to an element that is [connected](developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
Usage
“‘python sync expect(page.get_by_text(“Hidden text”)).to_be_attached() “`
161 162 163 |
# File 'lib/playwright_api/locator_assertions.rb', line 161 def to_be_attached(attached: nil, timeout: nil) wrap_impl(@impl.to_be_attached(attached: unwrap_impl(attached), timeout: unwrap_impl(timeout))) end |
#to_be_checked(checked: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a checked input.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_label(“Subscribe to newsletter”) expect(locator).to_be_checked() “‘
176 177 178 |
# File 'lib/playwright_api/locator_assertions.rb', line 176 def to_be_checked(checked: nil, timeout: nil) wrap_impl(@impl.to_be_checked(checked: unwrap_impl(checked), timeout: unwrap_impl(timeout))) end |
#to_be_disabled(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a disabled element. Element is disabled if it has “disabled” attribute or is disabled via [’aria-disabled’](developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled). Note that only native control elements such as HTML ‘button`, `input`, `select`, `textarea`, `option`, `optgroup` can be disabled by setting “disabled” attribute. “disabled” attribute on other elements is ignored by the browser.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“button.submit”) expect(locator).to_be_disabled() “‘
195 196 197 |
# File 'lib/playwright_api/locator_assertions.rb', line 195 def to_be_disabled(timeout: nil) wrap_impl(@impl.to_be_disabled(timeout: unwrap_impl(timeout))) end |
#to_be_editable(editable: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an editable element.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_role(“textbox”) expect(locator).to_be_editable() “‘
210 211 212 |
# File 'lib/playwright_api/locator_assertions.rb', line 210 def to_be_editable(editable: nil, timeout: nil) wrap_impl(@impl.to_be_editable(editable: unwrap_impl(editable), timeout: unwrap_impl(timeout))) end |
#to_be_empty(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an empty editable element or to a DOM node that has no text.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“div.warning”) expect(locator).to_be_empty() “‘
225 226 227 |
# File 'lib/playwright_api/locator_assertions.rb', line 225 def to_be_empty(timeout: nil) wrap_impl(@impl.to_be_empty(timeout: unwrap_impl(timeout))) end |
#to_be_enabled(enabled: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an enabled element.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“button.submit”) expect(locator).to_be_enabled() “‘
240 241 242 |
# File 'lib/playwright_api/locator_assertions.rb', line 240 def to_be_enabled(enabled: nil, timeout: nil) wrap_impl(@impl.to_be_enabled(enabled: unwrap_impl(enabled), timeout: unwrap_impl(timeout))) end |
#to_be_focused(timeout: nil) ⇒ Object
Ensures the ‘Locator` points to a focused DOM node.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_role(“textbox”) expect(locator).to_be_focused() “‘
255 256 257 |
# File 'lib/playwright_api/locator_assertions.rb', line 255 def to_be_focused(timeout: nil) wrap_impl(@impl.to_be_focused(timeout: unwrap_impl(timeout))) end |
#to_be_hidden(timeout: nil) ⇒ Object
Ensures that ‘Locator` either does not resolve to any DOM node, or resolves to a [non-visible](../actionability.md#visible) one.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(‘.my-element’) expect(locator).to_be_hidden() “‘
270 271 272 |
# File 'lib/playwright_api/locator_assertions.rb', line 270 def to_be_hidden(timeout: nil) wrap_impl(@impl.to_be_hidden(timeout: unwrap_impl(timeout))) end |
#to_be_in_viewport(ratio: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element that intersects viewport, according to the [intersection observer API](developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_role(“button”) # Make sure at least some part of element intersects viewport. expect(locator).to_be_in_viewport() # Make sure element is fully outside of viewport. expect(locator).not_to_be_in_viewport() # Make sure that at least half of the element intersects viewport. expect(locator).to_be_in_viewport(ratio=0.5) “‘
290 291 292 |
# File 'lib/playwright_api/locator_assertions.rb', line 290 def (ratio: nil, timeout: nil) wrap_impl(@impl.(ratio: unwrap_impl(ratio), timeout: unwrap_impl(timeout))) end |
#to_be_visible(timeout: nil, visible: nil) ⇒ Object
Ensures that ‘Locator` points to an attached and [visible](../actionability.md#visible) DOM node.
To check that at least one element from the list is visible, use [‘method: Locator.first`].
Usage
“‘python sync # A specific element is visible. expect(page.get_by_text(“Welcome”)).to_be_visible()
# At least one item in the list is visible. expect(page.get_by_test_id(“todo-item”).first).to_be_visible()
# At least one of the two elements is visible, possibly both. expect(
page.get_by_role("button", name="Sign in")
.or_(page.get_by_role("button", name="Sign up"))
.first
).to_be_visible() “‘
315 316 317 |
# File 'lib/playwright_api/locator_assertions.rb', line 315 def to_be_visible(timeout: nil, visible: nil) wrap_impl(@impl.to_be_visible(timeout: unwrap_impl(timeout), visible: unwrap_impl(visible))) end |
#to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
Ensures the ‘Locator` points to an element that contains the given text. All nested elements will be considered when computing the text content of the element. You can use regular expressions for the value as well.
Details
When ‘expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
Usage
“‘python sync import re from playwright.sync_api import expect
locator = page.locator(‘.title’) expect(locator).to_contain_text(“substring”) expect(locator).to_contain_text(re.compile(r“d messages”)) “‘
If you pass an array as an expected value, the expectations are:
-
Locator resolves to a list of elements.
-
Elements from a subset of this list contain text from the expected array, respectively.
-
The matching subset of elements has the same order as the expected array.
-
Each text value from the expected array is matched by some element from the list.
For example, consider the following list:
“‘html <ul>
<li>Item Text 1</li>
<li>Item Text 2</li>
<li>Item Text 3</li>
</ul> “‘
Let’s see how we can use the assertion:
“‘python sync from playwright.sync_api import expect
# ✓ Contains the right items in the right order expect(page.locator(“ul > li”)).to_contain_text([“Text 1”, “Text 3”, “Text 4”])
# ✖ Wrong order expect(page.locator(“ul > li”)).to_contain_text([“Text 3”, “Text 2”])
# ✖ No item contains this text expect(page.locator(“ul > li”)).to_contain_text([“Some 33”])
# ✖ Locator points to the outer list element, not to the list items expect(page.locator(“ul”)).to_contain_text([“Text 3”]) “‘
371 372 373 |
# File 'lib/playwright_api/locator_assertions.rb', line 371 def to_contain_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) wrap_impl(@impl.to_contain_text(unwrap_impl(expected), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout), useInnerText: unwrap_impl(useInnerText))) end |
#to_have_accessible_description(description, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [accessible description](w3c.github.io/accname/#dfn-accessible-description).
Usage
“‘python sync locator = page.get_by_test_id(“save-button”) expect(locator).to_have_accessible_description(“Save results to disk”) “`
384 385 386 |
# File 'lib/playwright_api/locator_assertions.rb', line 384 def to_have_accessible_description(description, ignoreCase: nil, timeout: nil) wrap_impl(@impl.to_have_accessible_description(unwrap_impl(description), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#to_have_accessible_name(name, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [accessible name](w3c.github.io/accname/#dfn-accessible-name).
Usage
“‘python sync locator = page.get_by_test_id(“save-button”) expect(locator).to_have_accessible_name(“Save to disk”) “`
397 398 399 |
# File 'lib/playwright_api/locator_assertions.rb', line 397 def to_have_accessible_name(name, ignoreCase: nil, timeout: nil) wrap_impl(@impl.to_have_accessible_name(unwrap_impl(name), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#to_have_attribute(name, value, ignoreCase: nil, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given attribute.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“input”) expect(locator).to_have_attribute(“type”, “text”) “‘
412 413 414 |
# File 'lib/playwright_api/locator_assertions.rb', line 412 def to_have_attribute(name, value, ignoreCase: nil, timeout: nil) wrap_impl(@impl.to_have_attribute(unwrap_impl(name), unwrap_impl(value), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout))) end |
#to_have_class(expected, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given CSS classes. This needs to be a full match or using a relaxed regular expression.
Usage
“‘html <div class=’selected row’ id=‘component’></div> “‘
“‘python sync from playwright.sync_api import expect
locator = page.locator(“#component”) expect(locator).to_have_class(re.compile(r“selected”)) expect(locator).to_have_class(“selected row”) “‘
Note that if array is passed as an expected value, entire lists of elements can be asserted:
“‘python sync from playwright.sync_api import expect
locator = page.locator(“list > .component”) expect(locator).to_have_class([“component”, “component selected”, “component”]) “‘
442 443 444 |
# File 'lib/playwright_api/locator_assertions.rb', line 442 def to_have_class(expected, timeout: nil) wrap_impl(@impl.to_have_class(unwrap_impl(expected), timeout: unwrap_impl(timeout))) end |
#to_have_count(count, timeout: nil) ⇒ Object
Ensures the ‘Locator` resolves to an exact number of DOM nodes.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“list > .component”) expect(locator).to_have_count(3) “‘
457 458 459 |
# File 'lib/playwright_api/locator_assertions.rb', line 457 def to_have_count(count, timeout: nil) wrap_impl(@impl.to_have_count(unwrap_impl(count), timeout: unwrap_impl(timeout))) end |
#to_have_css(name, value, timeout: nil) ⇒ Object
Ensures the ‘Locator` resolves to an element with the given computed CSS style.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_role(“button”) expect(locator).to_have_css(“display”, “flex”) “‘
472 473 474 |
# File 'lib/playwright_api/locator_assertions.rb', line 472 def to_have_css(name, value, timeout: nil) wrap_impl(@impl.to_have_css(unwrap_impl(name), unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#to_have_id(id, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given DOM Node ID.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.get_by_role(“textbox”) expect(locator).to_have_id(“lastname”) “‘
487 488 489 |
# File 'lib/playwright_api/locator_assertions.rb', line 487 def to_have_id(id, timeout: nil) wrap_impl(@impl.to_have_id(unwrap_impl(id), timeout: unwrap_impl(timeout))) end |
#to_have_js_property(name, value, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with given JavaScript property. Note that this property can be of a primitive type as well as a plain serializable JavaScript object.
Usage
“‘python sync from playwright.sync_api import expect
locator = page.locator(“.component”) expect(locator).to_have_js_property(“loaded”, True) “‘
503 504 505 |
# File 'lib/playwright_api/locator_assertions.rb', line 503 def to_have_js_property(name, value, timeout: nil) wrap_impl(@impl.to_have_js_property(unwrap_impl(name), unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#to_have_role(role, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with a given [ARIA role](www.w3.org/TR/wai-aria-1.2/#roles).
Note that role is matched as a string, disregarding the ARIA role hierarchy. For example, asserting a superclass role ‘“checkbox”` on an element with a subclass role `“switch”` will fail.
Usage
“‘python sync locator = page.get_by_test_id(“save-button”) expect(locator).to_have_role(“button”) “`
518 519 520 |
# File 'lib/playwright_api/locator_assertions.rb', line 518 def to_have_role(role, timeout: nil) wrap_impl(@impl.to_have_role(unwrap_impl(role), timeout: unwrap_impl(timeout))) end |
#to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given text. All nested elements will be considered when computing the text content of the element. You can use regular expressions for the value as well.
Details
When ‘expected` parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
Usage
“‘python sync import re from playwright.sync_api import expect
locator = page.locator(“.title”) expect(locator).to_have_text(re.compile(r“Welcome, Test User”)) expect(locator).to_have_text(re.compile(r“Welcome, .*”)) “‘
If you pass an array as an expected value, the expectations are:
-
Locator resolves to a list of elements.
-
The number of elements equals the number of expected values in the array.
-
Elements from the list have text matching expected array values, one by one, in order.
For example, consider the following list:
“‘html <ul>
<li>Text 1</li>
<li>Text 2</li>
<li>Text 3</li>
</ul> “‘
Let’s see how we can use the assertion:
“‘python sync from playwright.sync_api import expect
# ✓ Has the right items in the right order expect(page.locator(“ul > li”)).to_have_text([“Text 1”, “Text 2”, “Text 3”])
# ✖ Wrong order expect(page.locator(“ul > li”)).to_have_text([“Text 3”, “Text 2”, “Text 1”])
# ✖ Last item does not match expect(page.locator(“ul > li”)).to_have_text([“Text 1”, “Text 2”, “Text”])
# ✖ Locator points to the outer list element, not to the list items expect(page.locator(“ul”)).to_have_text([“Text 1”, “Text 2”, “Text 3”]) “‘
573 574 575 |
# File 'lib/playwright_api/locator_assertions.rb', line 573 def to_have_text(expected, ignoreCase: nil, timeout: nil, useInnerText: nil) wrap_impl(@impl.to_have_text(unwrap_impl(expected), ignoreCase: unwrap_impl(ignoreCase), timeout: unwrap_impl(timeout), useInnerText: unwrap_impl(useInnerText))) end |
#to_have_value(value, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to an element with the given input value. You can use regular expressions for the value as well.
Usage
“‘python sync import re from playwright.sync_api import expect
locator = page.locator(“input”) expect(locator).to_have_value(re.compile(r“”)) “‘
589 590 591 |
# File 'lib/playwright_api/locator_assertions.rb', line 589 def to_have_value(value, timeout: nil) wrap_impl(@impl.to_have_value(unwrap_impl(value), timeout: unwrap_impl(timeout))) end |
#to_have_values(values, timeout: nil) ⇒ Object
Ensures the ‘Locator` points to multi-select/combobox (i.e. a `select` with the `multiple` attribute) and the specified values are selected.
Usage
For example, given the following element:
“‘html <select id=“favorite-colors” multiple>
<option value="R">Red</option>
<option value="G">Green</option>
<option value="B">Blue</option>
</select> “‘
“‘python sync import re from playwright.sync_api import expect
locator = page.locator(“id=favorite-colors”) locator.select_option([“R”, “G”]) expect(locator).to_have_values([re.compile(r“R”), re.compile(r“G”)]) “‘
616 617 618 |
# File 'lib/playwright_api/locator_assertions.rb', line 616 def to_have_values(values, timeout: nil) wrap_impl(@impl.to_have_values(unwrap_impl(values), timeout: unwrap_impl(timeout))) end |