press - Momentic

Issues a single key press. Use + to combine modifiers, e.g. Meta+Enter, Control+Shift+P. Reach for press when a flow depends on the keyboard: submitting a form with Enter, dismissing a dialog with Escape, or running an app’s keyboard shortcuts. To hold a key across several steps, use keyDown and keyUp instead.

Parameters

Parameter	Type	Required	Description
`key`	`string`	Yes	Key name or chord (e.g. `Enter`, `Meta+Enter`).
`repeat`	`number`	No	Number of times to repeat the press.
`delay`	`number`	No	Milliseconds between key down and key up.
`convertMeta`	`boolean`	No	Translate `Meta` to `Control` on non-mac platforms.
`saveAs`	`string`	No	Name of the variable to write this step’s return value to.
`retries`	`number`	No	Number of times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Shorthand

Key name as a single string.

- press: Enter

Examples

Submit a login form without clicking the button:

- type:
    text: qa@acme.test
    into: the Email field
- type:
    text: "{{ env.PASSWORD }}"
    into: the Password field
- press: Enter

Close a modal with the keyboard:

- press: Escape
- checkPageDoesNotContain: Confirm your choice

- press:
    key: Meta+Shift+Enter

- press:
    key: Control+Shift+Enter
    convertMeta: true

- press:
    key: ArrowDown
    repeat: 3

⌘I