mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
b7ebc5d9bb
Issue: #1313 <!-- Thanks for submitting a pull request! Please provide enough information so that others can review your pull request. --> **What kind of change does this PR introduce?** Feature. **Did you add tests for your changes?** Yes. **If relevant, did you update the documentation?** Yes. **Summary** Supports keyboard shotcuts on MacOS. See Chrome Devtools Protocol document: https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-dispatchKeyEvent.
2.8 KiB
2.8 KiB
| sidebar_label |
|---|
| Keyboard.down |
Keyboard.down() method
Dispatches a keydown event.
Signature:
class Keyboard {
down(
key: KeyInput,
options?: {
text?: string;
commands?: string[];
}
): Promise<void>;
}
Parameters
| Parameter | Type | Description |
|---|---|---|
| key | KeyInput | Name of key to press, such as ArrowLeft. See KeyInput for a list of all key names. |
| options | { text?: string; commands?: string[]; } | (Optional) An object of options. Accepts text which, if specified, generates an input event with this text. Accepts commands which, if specified, is the commands of keyboard shortcuts, see Chromium Source Code for valid command names. |
Returns:
Promise<void>
Remarks
If key is a single character and no modifier keys besides Shift are being held down, a keypress/input event will also generated. The text option can be specified to force an input event to be generated. If key is a modifier key, Shift, Meta, Control, or Alt, subsequent key presses will be sent with that modifier active. To release the modifier key, use Keyboard.up().
After the key is pressed once, subsequent calls to Keyboard.down() will have repeat set to true. To release the key, use Keyboard.up().
Modifier keys DO influence Keyboard.down(). Holding down Shift will type the text in upper case.