Package io.karatelabs.driver

Class MissingElement

java.lang.Object

io.karatelabs.driver.BaseElement

io.karatelabs.driver.MissingElement

All Implemented Interfaces:

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

public class MissingElement
extends BaseElement

The element Driver.optional(String) returns when nothing matched: actions are no-ops, reads return null / false / empty, retry() keeps the element missing (as in v1, optional(x).retry().click() never waits or throws), and the wait methods delegate to the driver and return the element that eventually appears.

Field Summary

Fields inherited from class io.karatelabs.driver.BaseElement

driver, exists, locator

Fields inherited from interface io.karatelabs.js.SimpleObject

logger, TO_STRING

Constructor Summary

Constructors

Constructor	Description
MissingElement(Driver driver, String locator)

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()
Element	focus()
Element	highlight()
String	html()
String	innerHtml()
Element	input(String value)
Element	inputFile(String... files)
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	toString()
String	value()
Element	value(String value)
Element	waitFor()
Element	waitForEnabled()
Element	waitForText(String expected)
Element	waitUntil(String expression)

Methods inherited from class io.karatelabs.driver.BaseElement

assertExists, existing, exists, getLocator, isPresent, isPureJsLocator, jsGet, of, optional

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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, jsKeys, jsToString, putMember, removeMember, toMap

Constructor Details

MissingElement

public MissingElement(Driver driver,
 String locator)

Method Details

text

public String text()

Specified by:

text in interface Element

Overrides:

text in class BaseElement

html

public String html()

Specified by:

html in interface Element

Overrides:

html in class BaseElement

innerHtml

public String innerHtml()

Specified by:

innerHtml in interface Element

Overrides:

innerHtml in class BaseElement

value

public String value()

Specified by:

value in interface Element

Overrides:

value in class BaseElement

attribute

public String attribute(String name)

Specified by:

attribute in interface Element

Overrides:

attribute in class BaseElement

property

public Object property(String name)

Specified by:

property in interface Element

Overrides:

property in class BaseElement

enabled

public boolean enabled()

Specified by:

enabled in interface Element

Overrides:

enabled in class BaseElement

position

public Map<String,Object> position()

Specified by:

position in interface Element

Overrides:

position in class BaseElement

position

public Map<String,Object> position(boolean relative)

Specified by:

position in interface Element

Overrides:

position in class BaseElement

click

public Element click()

Specified by:

click in interface Element

Overrides:

click in class BaseElement

focus

public Element focus()

Specified by:

focus in interface Element

Overrides:

focus in class BaseElement

clear

public Element clear()

Specified by:

clear in interface Element

Overrides:

clear in class BaseElement

input

public Element input(String value)

Specified by:

input in interface Element

Overrides:

input in class BaseElement

inputFile

public Element inputFile(String... files)

Specified by:

inputFile in interface Element

Overrides:

inputFile in class BaseElement

value

public Element value(String value)

Specified by:

value in interface Element

Overrides:

value in class BaseElement

select

public Element select(String text)

Specified by:

select in interface Element

Overrides:

select in class BaseElement

select

public Element select(int index)

Specified by:

select in interface Element

Overrides:

select in class BaseElement

scroll

public Element scroll()

Specified by:

scroll in interface Element

Overrides:

scroll in class BaseElement

highlight

public Element highlight()

Specified by:

highlight in interface Element

Overrides:

highlight in class BaseElement

submit

public Element submit()

Specified by:

submit in interface Element

Overrides:

submit in class BaseElement

locate

public Element locate(String childLocator)

Specified by:

locate in interface Element

Overrides:

locate in class BaseElement

locateAll

public List<Element> locateAll(String childLocator)

Specified by:

locateAll in interface Element

Overrides:

locateAll in class BaseElement

closest

public Element closest(String selector)

Description copied from interface: Element

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.

Specified by:

closest in interface Element

Overrides:

closest in class BaseElement

matches

public boolean matches(String selector)

Description copied from interface: Element

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

Specified by:

matches in interface Element

Overrides:

matches in class BaseElement

script

public Object script(String expression)

Specified by:

script in interface Element

Overrides:

script in class BaseElement

retry

public Element retry()

Specified by:

retry in interface Element

Overrides:

retry in class BaseElement

retry

public Element retry(int count)

Specified by:

retry in interface Element

Overrides:

retry in class BaseElement

retry

public Element retry(int count,
 int interval)

Specified by:

retry in interface Element

Overrides:

retry in class BaseElement

waitFor

public Element waitFor()

Specified by:

waitFor in interface Element

Overrides:

waitFor in class BaseElement

waitForText

public Element waitForText(String expected)

Specified by:

waitForText in interface Element

Overrides:

waitForText in class BaseElement

waitForEnabled

public Element waitForEnabled()

Specified by:

waitForEnabled in interface Element

Overrides:

waitForEnabled in class BaseElement

waitUntil

public Element waitUntil(String expression)

Specified by:

waitUntil in interface Element

Overrides:

waitUntil in class BaseElement

toString

public String toString()

Overrides:

toString in class BaseElement