This is documentation for the next version of K6. For the latest stable release, go to the latest version.
press(key, [options])
Press a single key on the keyboard or a combination of keys.
Parameter | Type | Default | Description |
---|---|---|---|
key | string | '' | Name of the key to press or a character to generate, such as ArrowLeft or a . A superset of the key values can be found here. |
options | object | null | |
options.delay | number | 0 | Milliseconds to wait between keydown and keyup . |
options.noWaitAfter | boolean | false | If set to true and a navigation occurs from performing this action, it will not wait for it to complete. |
options.timeout | number | 30000 | Maximum time in milliseconds. Pass 0 to disable the timeout. Default is overridden by the setDefaultTimeout option on BrowserContext or Page. |
Returns
Type | Description |
---|---|
Promise<void> | A Promise that fulfills when the key is pressed. |
Example
import { browser } from 'k6/browser';
export const options = {
scenarios: {
browser: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
},
};
export default async function () {
const page = await browser.newPage();
await page.goto('https://test.k6.io/browser.php');
const text = page.locator('#text1');
await text.press('i');
await text.press('ArrowLeft');
await text.press('h');
}