Documentation for automated readers A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers
and AI tools to parse than HTML. The Markdown version is available at
https://grafana.com/docs/k6/next/javascript-api/k6-browser/frame/press.md, or by sending
Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/k6-browser/frame/press/. For broader
documentation discovery, the curated index is available at https://grafana.com/llms.txt
and the complete index is available at https://grafana.com/llms-full.txt.
Following modification shortcuts are also supported: Shift, Control, Alt, Meta, ShiftLeft.
Holding down Shift will type the text that corresponds to the key in the upper case.
If key is a single character, it is case-sensitive, so the values a and A will generate different respective texts.
Shortcuts such as key: "Control+o" or key: "Control+Shift+T" are supported as well. When specified with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
Parameter
Type
Default
Description
selector
string
''
A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
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.strict
boolean
false
When true, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception.
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 fullfils when the press action is finished.
