Skip to main content

Interface: Interactor

Defined in: packages/core/src/interactor/Interactor.ts:20

Methods

click()

click(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:27

Click on the desired element

Parameters

locator

PartLocator

option?

Partial<ClickOption>

Returns

Promise<void>


clone()

clone(): Interactor

Defined in: packages/core/src/interactor/Interactor.ts:139

Returns

Interactor


enterText()

enterText(locator, text, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:55

Type text into the desired element

Parameters

locator

PartLocator

text

string

option?

Partial<EnterTextOption>

Returns

Promise<void>


exists()

exists(locator): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:122

Parameters

locator

PartLocator

Returns

Promise<boolean>


focus()

focus(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:48

Parameters

locator

PartLocator

option?

Partial<FocusOption>

Returns

Promise<void>


getAttribute()

Call Signature

getAttribute(locator, name, isMultiple): Promise<readonly string[]>

Defined in: packages/core/src/interactor/Interactor.ts:110

Parameters
locator

PartLocator

name

string

isMultiple

true

Returns

Promise<readonly string[]>

Call Signature

getAttribute(locator, name, isMultiple): Promise<Optional<string>>

Defined in: packages/core/src/interactor/Interactor.ts:111

Parameters
locator

PartLocator

name

string

isMultiple

false

Returns

Promise<Optional<string>>

Call Signature

getAttribute(locator, name): Promise<Optional<string>>

Defined in: packages/core/src/interactor/Interactor.ts:112

Parameters
locator

PartLocator

name

string

Returns

Promise<Optional<string>>


getInputValue()

getInputValue(locator): Promise<Optional<string>>

Defined in: packages/core/src/interactor/Interactor.ts:98

Parameters

locator

PartLocator

Returns

Promise<Optional<string>>


getSelectLabels()

getSelectLabels(locator): Promise<Optional<readonly string[]>>

Defined in: packages/core/src/interactor/Interactor.ts:108

Get the select element's selected options' labels

Parameters

locator

PartLocator

Returns

Promise<Optional<readonly string[]>>


getSelectValues()

getSelectValues(locator): Promise<Optional<readonly string[]>>

Defined in: packages/core/src/interactor/Interactor.ts:103

Get the select element's selected options' values

Parameters

locator

PartLocator

Returns

Promise<Optional<readonly string[]>>


getStyleValue()

getStyleValue(locator, propertyName): Promise<Optional<string>>

Defined in: packages/core/src/interactor/Interactor.ts:119

Get the value of a style property

Parameters

locator

PartLocator

propertyName

CssProperty

Returns

Promise<Optional<string>>


getText()

getText(locator): Promise<Optional<string>>

Defined in: packages/core/src/interactor/Interactor.ts:121

Parameters

locator

PartLocator

Returns

Promise<Optional<string>>


hasAttribute()

hasAttribute(locator, name): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:129

Parameters

locator

PartLocator

name

string

Returns

Promise<boolean>


hasCssClass()

hasCssClass(locator, className): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:128

Parameters

locator

PartLocator

className

string

Returns

Promise<boolean>


hover()

hover(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:68

Perform a mouse hover on the desired element

Parameters

locator

PartLocator

option?

HoverOption

Returns

Promise<void>


innerHTML()

innerHTML(locator): Promise<string>

Defined in: packages/core/src/interactor/Interactor.ts:137

Get the HTML of an element

Parameters

locator

PartLocator

Returns

Promise<string>


isChecked()

isChecked(locator): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:123

Parameters

locator

PartLocator

Returns

Promise<boolean>


isDisabled()

isDisabled(locator): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:124

Parameters

locator

PartLocator

Returns

Promise<boolean>


isReadonly()

isReadonly(locator): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:125

Parameters

locator

PartLocator

Returns

Promise<boolean>


isVisible()

isVisible(locator): Promise<boolean>

Defined in: packages/core/src/interactor/Interactor.ts:126

Parameters

locator

PartLocator

Returns

Promise<boolean>


mouseDown()

mouseDown(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:36

Parameters

locator

PartLocator

option?

Partial<MouseDownOption>

Returns

Promise<void>


mouseEnter()

mouseEnter(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:44

Parameters

locator

PartLocator

option?

Partial<MouseEnterOption>

Returns

Promise<void>


mouseLeave()

mouseLeave(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:46

Parameters

locator

PartLocator

option?

Partial<MouseLeaveOption>

Returns

Promise<void>


mouseMove()

mouseMove(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:34

Mouse move on the desired element

Parameters

locator

PartLocator

option?

Partial<MouseMoveOption>

Returns

Promise<void>


mouseOut()

mouseOut(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:42

Parameters

locator

PartLocator

option?

Partial<MouseOutOption>

Returns

Promise<void>


mouseOver()

mouseOver(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:40

Parameters

locator

PartLocator

option?

Partial<HoverOption>

Returns

Promise<void>


mouseUp()

mouseUp(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:38

Parameters

locator

PartLocator

option?

Partial<MouseUpOption>

Returns

Promise<void>


selectOptionValue()

selectOptionValue(locator, values): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:62

Select option by value from a select element

Parameters

locator

PartLocator

values

string[]

Returns

Promise<void>


wait()

wait(ms): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:74

Wait for a given amount of time in milliseconds

Parameters

ms

number

Returns

Promise<void>


waitUntil()

waitUntil<T>(option): Promise<T>

Defined in: packages/core/src/interactor/Interactor.ts:94

Keep running a probe function until it returns a value that matches the terminate condition or timeout

Type Parameters

T

T

Parameters

option

WaitUntilOption<T>

Returns

Promise<T>

The last value returned by the probe function


waitUntilComponentState()

waitUntilComponentState(locator, option?): Promise<void>

Defined in: packages/core/src/interactor/Interactor.ts:88

Wait until the component is in the expected state such as the component's visibility or existence. If the component has not reached the expected state within the timeout, it will throw an error.

By default it waits until the component is attached to the DOM within 30 seconds.

Parameters

locator

PartLocator

The locator of the component to wait for

option?

Partial<Readonly<WaitForOption>>

The option to configure the wait behavior

Returns

Promise<void>