Hotkeys
6.8.3The Hotkeys API allows apps to register key combinations and receive notifications when a key combination is pressed by the user regardless of whether or not the app is on focus. Hotkeys are useful for web apps that don't have access to system resources and can't register global shortcuts.
The Hotkeys API is accessible through the io.hotkeys
object.
APIobject
Description
Hotkeys API.
Methods
isRegisteredmethod
Signature
(hotkey: string) => void
Description
Whether the current app has registered a hotkey.
Parameters
Name | Type | Required | Description |
---|---|---|---|
hotkey | string | The name of the hotkey you want to check. |
registermethod
Signature
(hotkey: string | HotkeyInfo, callback: HotkeyCallback) => Promise<void>
Description
Registers a hotkey. All registered hotkeys within the framework must be unique.
Parameters
Name | Type | Required | Description |
---|---|---|---|
hotkey | string | HotkeyInfo | The key or key combination (as a string or as a |
|
callback | HotkeyCallback | Callback function that will be invoked when the hotkey is activated. |
unregistermethod
Signature
(hotkey: string) => Promise<void>
Description
Unregisters a hotkey. Notifications will no longer be received about this hotkey.
Parameters
Name | Type | Required | Description |
---|---|---|---|
hotkey | string | The hotkey to unregister. |
unregisterAllmethod
Signature
() => Promise<void>
Description
Unregisters all hotkeys registered by the current app.
HotkeyInfoobject
Description
Information about the hotkey.
Properties
Property | Type | Default | Required | Description |
---|---|---|---|---|
description | string | Description of the hotkey. |
||
hotkey | string | The key or key combination that will be used as a hotkey. |
HotkeyCallbackfunction
Signature
() => void
Description
Callback function that is invoked when the hotkey is activated.