Selenium WebElement

All WebElement methods available when using the Selenium driver.

You get a RemoteWebElement from driver.findElement() or driver.findElements().

Actions

click()

Click the element.

1
const el = await runtime.driver.findElement({ css: '#submit' });
2
await el.click();

sendKeys(…text)

Type text into the element or send key sequences.

1
await el.sendKeys('hello world');

clear()

Clear the element’s value (for input/textarea).

1
await el.clear();

submit()

Submit the form containing this element.

1
await el.submit();

Content

getText()

Get the visible text of the element.

1
const text = await el.getText();

Returns string

getAttribute(name)

Get an attribute value.

1
const href = await el.getAttribute('href');

Returns string | null

getCssValue(propertyName)

Get a CSS property value.

1
const color = await el.getCssValue('background-color');

Returns string

getTagName()

Get the element’s tag name.

1
const tag = await el.getTagName(); // e.g., "div"

Returns string

getRect()

Get the element’s position and dimensions.

1
const rect = await el.getRect();
2
// { x, y, width, height }

Returns { x: number, y: number, width: number, height: number }

State Checks

isDisplayed()

Check if the element is visible.

1
const visible = await el.isDisplayed();

Returns boolean

isEnabled()

Check if the element is enabled.

1
const enabled = await el.isEnabled();

Returns boolean

isSelected()

Check if the element is selected (for checkboxes, radio buttons, options).

1
const selected = await el.isSelected();

Returns boolean

Screenshots

takeScreenshot()

Take a screenshot of this specific element.

1
const base64 = await el.takeScreenshot();

Returns string — base64-encoded PNG.

Queries

findElement(locator)

Find a child element within this element.

1
const child = await el.findElement({ css: '.child' });

Returns RemoteWebElement

findElements(locator)

Find all matching child elements within this element.

1
const children = await el.findElements({ css: '.item' });

Returns RemoteWebElement[]