Package io.karatelabs.driver

Interface Element

All Superinterfaces:

io.karatelabs.js.ObjectLike, io.karatelabs.js.SimpleObject

All Known Implementing Classes:

BaseElement, W3cElement

public interface Element
extends io.karatelabs.js.SimpleObject

Represents a DOM element found by a locator. Provides element-scoped operations and fluent API for chaining. Extends SimpleObject for JavaScript interoperability.

Implementations include:

• BaseElement - Locator-based, delegates to Driver (works with any backend)

See Also:

• BaseElement
• Driver

Field Summary

Fields inherited from interface io.karatelabs.js.SimpleObject

logger, TO_STRING

Method Summary

Modifier and Type	Method	Description
String	attribute(String name)
Element	clear()
Element	click()
Element	closest(String selector)	The closest ancestor (or self) matching the given CSS selector.
boolean	enabled()
boolean	exists()
Element	focus()
String	getLocator()
Element	highlight()
String	html()
String	innerHtml()
Element	input(String value)
boolean	isPresent()
Element	locate(String childLocator)
List<Element>	locateAll(String childLocator)
boolean	matches(String selector)	Whether this element matches the given CSS selector.
Map<String,Object>	position()
Map<String,Object>	position(boolean relative)
Object	property(String name)
Element	retry()
Element	retry(int count)
Element	retry(int count, int interval)
Object	script(String expression)
Element	scroll()
Element	select(int index)
Element	select(String text)
Element	submit()
String	text()
String	value()
Element	value(String value)
Element	waitFor()
Element	waitForEnabled()
Element	waitForText(String expected)
Element	waitUntil(String expression)

Methods inherited from interface io.karatelabs.js.ObjectLike

getMember, getPrototype, isExtensible, isFrozen, isOwnProperty, isSealed, putMember, removeMember, setExtensible, setFrozen, setSealed

Methods inherited from interface io.karatelabs.js.SimpleObject

getMember, jsGet, jsKeys, jsToString, putMember, removeMember, toMap

Method Details

exists

boolean exists()

isPresent

boolean isPresent()

getLocator

String getLocator()

text

String text()

html

String html()

innerHtml

String innerHtml()

value

String value()

attribute

String attribute(String name)

property

Object property(String name)

enabled

boolean enabled()

position

Map<String,Object> position()

position

Map<String,Object> position(boolean relative)

click

Element click()

focus

Element focus()

clear

Element clear()

input

Element input(String value)

value

Element value(String value)

select

Element select(String text)

select

Element select(int index)

scroll

Element scroll()

highlight

Element highlight()

submit

Element submit()

locate

Element locate(String childLocator)

locateAll

List<Element> locateAll(String childLocator)

closest

Element closest(String selector)

The closest ancestor (or self) matching the given CSS selector. Mirrors the native Element.closest() DOM API — robust to markup shuffling, preferred over counting parent hops.

matches

boolean matches(String selector)

Whether this element matches the given CSS selector. Mirrors the native Element.matches() DOM API.

script

Object script(String expression)

waitFor

Element waitFor()

waitForText

Element waitForText(String expected)

waitForEnabled

Element waitForEnabled()

waitUntil

Element waitUntil(String expression)

retry

Element retry()

retry

Element retry(int count)

retry

Element retry(int count,
 int interval)