Playwright performs a range of actionability checks on the elements before making actions to ensure these actions behave as expected. It auto-waits for all the relevant checks to pass and only then performs the requested action. If the required checks do not pass within the given timeout
, action fails with the TimeoutError
.
For example, for locator.click(), Playwright will ensure that:
Here is the complete list of actionability checks performed for each action:
Forcing actionsSome actions like locator.click() support force
option that disables non-essential actionability checks, for example passing truthy force
to locator.click() method will not check that the target element actually receives click events.
Playwright includes auto-retrying assertions that remove flakiness by waiting until the condition is met, similarly to auto-waiting before actions.
Learn more in the assertions guide.
VisibleElement is considered visible when it has non-empty bounding box and does not have visibility:hidden
computed style.
Note that according to this definition:
display:none
are not considered visible.opacity:0
are considered visible.Element is considered stable when it has maintained the same bounding box for at least two consecutive animation frames.
EnabledElement is considered enabled when it is not disabled.
Element is disabled when:
<button>
, <select>
, <input>
, <textarea>
, <option>
or <optgroup>
with a [disabled]
attribute;<button>
, <select>
, <input>
, <textarea>
, <option>
or <optgroup>
that is a part of a <fieldset>
with a [disabled]
attribute;[aria-disabled=true]
attribute.Element is considered editable when it is enabled and is not readonly.
Element is readonly when:
<select>
, <input>
or <textarea>
with a [readonly]
attribute;[aria-readonly=true]
attribute and an aria role that supports it.Element is considered receiving pointer events when it is the hit target of the pointer event at the action point. For example, when clicking at the point (10;10)
, Playwright checks whether some other element (usually an overlay) will instead capture the click at (10;10)
.
For example, consider a scenario where Playwright will click Sign Up
button regardless of when the locator.click() call was made:
Sign Up
button is disabled;Sign Up
button is replaced with another one that is now enabled.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4