PlaywrightEx.Selector (PlaywrightEx v0.13.0)

Copy Markdown View Source

Playright supports different types of locators: CSS, XPath, internal.

They can mixed and matched by chaining the together.

Also, you can register custom selector engines that run right in the browser (Javascript).

There is no official documentation, since this is considered Playwright internal.

References:

Summary

Types

built()
exact_opts()
t()

Functions

left and right
any_frame(selector)

Searches for a selector in any frame below the current frame.

at(at)
build(selector)
button(text, opts \\ [])
concat(left, right)
css(selector)
has(left, right)
label(label, opts \\ [])
link(text, opts \\ [])
menuitem(text, opts \\ [])
none()
role(role, text, opts \\ [])
text(text, opts \\ [])
value(value)
visible(selector, visible? \\ true)

Restricts a selector to visible or hidden elements.

Types

built()

@type built() :: String.t()

exact_opts()

@type exact_opts() :: [{:exact, boolean()}]

t()

@type t() :: built() | :none

Functions

left and right

@spec t() and t() :: t()

any_frame(selector)

@spec any_frame(t()) :: t()

Searches for a selector in any frame below the current frame.

This is the selector-building equivalent of calling Playwright 1.63's frameLocator() without an iframe selector.

at(at)

@spec at(nil | integer()) :: t()

build(selector)

@spec build(t()) :: built()

button(text, opts \\ [])

@spec button(String.t(), exact_opts()) :: built()

concat(left, right)

@spec concat(t(), t()) :: t()

css(selector)

@spec css(nil | String.t() | [String.t()]) :: t()

has(left, right)

@spec has(t(), t()) :: t()

label(label, opts \\ [])

@spec label(nil | String.t(), exact_opts()) :: t()

link(text, opts \\ [])

@spec link(String.t(), exact_opts()) :: built()

none()

@spec none() :: t()

role(role, text, opts \\ [])

@spec role(String.t(), String.t(), exact_opts()) :: built()

text(text, opts \\ [])

@spec text(nil | String.t(), exact_opts()) :: t()

value(value)

@spec value(nil | any()) :: t()

visible(selector, visible? \\ true)

@spec visible(t(), boolean()) :: t()

Restricts a selector to visible or hidden elements.

This is the selector-building equivalent of Playwright 1.63's locator.visible() API.