press()
Presses the given keys.
Examples
Section titled “Examples”await press('Enter')await press('a')await press(['Shift', 'ArrowLeft', 'ArrowLeft'])awaitpress('a', { waitForNavigation: false })Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
keys |
string | Array<string> | Name of keys to press. See USKeyboardLayout for a list of all key names. |
options |
Object | Default: {}. |
options.text |
string | If specified, generates an input event with this text. Default: "". |
options.delay |
number | Time to wait between keydown and keyup in milliseconds. Default: 0. |
options.waitForNavigation |
boolean | Wait for navigation after the click. Default navigation timeout is 30 seconds, to override pass { navigationTimeout: 10000 } in options parameter. Default: true. |
options.waitForStart |
number | wait for navigation to start. Default: 100. |
options.navigationTimeout |
number | Navigation timeout value in milliseconds for navigation after click. Default: 30000. |
options.waitForEvents |
Array | Events available to wait for [‘DOMContentLoaded’, ‘loadEventFired’, ‘networkAlmostIdle’, ‘networkIdle’, ‘firstPaint’, ‘firstContentfulPaint’, ‘firstMeaningfulPaint’, ‘targetNavigated’] Default: []. |
Returns
Section titled “Returns”| Type | Description |
|---|---|
Promise<void> |