locator
Locator
A WWW::Playwright::Locator points at one or more elements matched by a selector.
Get one from Page.locator or by chaining from another locator.
Playwright auto-waits for the element before each action.
Chaining
locator(Str $selector --> Locator)
Returns a locator scoped to the matches of this one.
$page.locator('body').locator('#greeting');Actions
| Method | Effect |
|---|---|
click(--> Nil) | Clicks the element. |
fill(Str $value --> Nil) | Replaces an input's value. |
type(Str $text --> Nil) | Types text one key at a time. |
press(Str $key --> Nil) | Dispatches a single key. |
check(--> Nil) | Ticks a checkbox. |
uncheck(--> Nil) | Clears a checkbox. |
select-option(Str $value --> List) | Selects an option, returns chosen values. |
hover(--> Nil) | Moves the pointer over the element. |
See the Action reference for examples.
Queries
| Method | Returns |
|---|---|
text-content(--> Str) | The element's textContent. |
inner-text(--> Str) | The rendered innerText. |
get-attribute(Str $name) | A named attribute's value. |
input-value(--> Str) | The current input/select value. |
count(--> Int) | The number of matched elements. |
is-visible(--> Bool) | Whether the element is visible. |
is-enabled(--> Bool) | Whether the element is enabled. |
is-checked(--> Bool) | Whether a checkbox is ticked. |
See the Query reference for examples.
Auto-waiting
wait-for(Str :$state --> Nil)
Waits until the element reaches a state: attached, detached, visible, or
hidden.
$page.locator('#greeting').wait-for(state => 'visible');