focus()
Fetches an element with the given selector and focuses it. If there’s no element matching selector, the method throws an error.
Examples
Section titled “Examples”await focus(textBox('Username:'))await focus(textBox('Username:'), { waitForEvents: ['firstMeaningfulPaint'], force: true })Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
selector | selector | string | A selector of an element to focus. If there are multiple elements satisfying the selector, the first will be focused. |
options | Object | Default: {}. |
options.force | boolean | Set to true to perform action on hidden/disabled elements. Default: false. |
options.waitForEvents | Array | Events available to wait for [‘DOMContentLoaded’, ‘loadEventFired’, ‘networkAlmostIdle’, ‘networkIdle’, ‘firstPaint’, ‘firstContentfulPaint’, ‘firstMeaningfulPaint’, ‘targetNavigated’] Default: []. |
Returns
Section titled “Returns”This API does not return any values.