focus

Fetches an element with the given selector and focuses it. If there's no element matching selector, the method throws an error.

Examples

await focus(textBox('Username:'))

await focus(textBox('Username:'), { waitForEvents: ['firstMeaningfulPaint'], force: true })

Parameters

selector

A selector of an element to focus. If there are multiple elements satisfying the selector, the first will be focused.

options

options.force boolean

Set to true to perform action on hidden/disabled elements.

Default value

false

options.waitForEvents Array<string>

Events available to wait for ['DOMContentLoaded', 'loadEventFired', 'networkAlmostIdle', 'networkIdle', 'firstPaint', 'firstContentfulPaint', 'firstMeaningfulPaint', 'targetNavigated']

Default value

[]

Returns

This API does not return any values