@tauri-apps/plugin-global-shortcut

Register global shortcuts.

Interfaces

ShortcutEvent

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L16

Payload sent to a shortcut handler when a registered shortcut is pressed or released.

Properties

Property	Type	Description	Defined in
id	number	Numeric identifier derived from the shortcut’s modifiers and key.	Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L20
shortcut	string	The shortcut definition that triggered this event, e.g. CommandOrControl+Shift+C.	Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L18
state	"Released" | "Pressed"	Whether the shortcut’s key combination was pressed down or released.	Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L22

Type Aliases

ShortcutHandler

type ShortcutHandler = (event) => void;

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L26

Callback invoked with a ShortcutEvent whenever a registered shortcut changes state.

Parameters

Parameter	Type
event	ShortcutEvent

Returns

void

Functions

isRegistered()

function isRegistered(shortcut): Promise<boolean>;

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L125

Determines whether the given shortcut is registered by this application or not.

If the shortcut is registered by another application, it will still return false.

Parameters

Parameter	Type	Description
shortcut	string	shortcut definition, modifiers and key separated by “+” e.g. CmdOrControl+Q

Returns

Promise<boolean>

A promise resolving to whether the shortcut is currently registered by this application.

Example

import { isRegistered } from '@tauri-apps/plugin-global-shortcut';
const isRegistered = await isRegistered('CommandOrControl+P');

Since

2.0.0

---

register()

function register(shortcuts, handler): Promise<void>;

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L58

Register a global shortcut or a list of shortcuts.

The handler is called when any of the registered shortcuts are pressed by the user.

If the shortcut is already taken by another application, the handler will not be triggered. Make sure the shortcut is as unique as possible while still taking user experience into consideration.

Parameters

Parameter	Type	Description
shortcuts	string | string[]	A shortcut definition, or a list of shortcut definitions, with modifiers and key separated by “+” e.g. CmdOrControl+Q
handler	ShortcutHandler	Shortcut handler callback - takes the triggered shortcut as argument

Returns

Promise<void>

Example

import { register } from '@tauri-apps/plugin-global-shortcut';

// register a single hotkey
await register('CommandOrControl+Shift+C', (event) => {
  if (event.state === "Pressed") {
      console.log('Shortcut triggered');
  }
});

// or register multiple hotkeys at once
await register(['CommandOrControl+Shift+C', 'Alt+A'], (event) => {
  console.log(`Shortcut ${event.shortcut} triggered`);
});

Since

2.0.0

---

unregister()

function unregister(shortcuts): Promise<void>;

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L89

Unregister a global shortcut or a list of shortcuts.

Parameters

Parameter	Type	Description
shortcuts	string | string[]	A shortcut definition, or a list of shortcut definitions, with modifiers and key separated by “+” e.g. CmdOrControl+Q

Returns

Promise<void>

Example

import { unregister } from '@tauri-apps/plugin-global-shortcut';

// unregister a single hotkey
await unregister('CmdOrControl+Space');

// or unregister multiple hotkeys at the same time
await unregister(['CmdOrControl+Space', 'Alt+A']);

Since

2.0.0

---

unregisterAll()

function unregisterAll(): Promise<void>;

Source: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/global-shortcut/guest-js/index.ts#L105

Unregister all global shortcuts.

Returns

Promise<void>

Example

import { unregisterAll } from '@tauri-apps/plugin-global-shortcut';
await unregisterAll();

Since

2.0.0