onCommand

browser.commands.onCommand.addListener(listener)
browser.commands.onCommand.removeListener(listener)
browser.commands.onCommand.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt einen Listener zu diesem Ereignis hinzu.

removeListener(listener)

Hört auf, auf dieses Ereignis zu hören. Das Argument listener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es zuhört, andernfalls false.

listener

Die Funktion, die aufgerufen wird, wenn ein Benutzer das Tastenkürzel des Befehls eingibt. Der Funktion werden diese Argumente übergeben:

name

string. Name des Befehls. Dieser stimmt mit dem Namen überein, der dem Befehl in seinem manifest.json-Eintrag gegeben wurde.

tab

tabs.Tab. Der Tab, der aktiv war, als das Befehls-Tastenkürzel eingegeben wurde.

Bei einem manifest.json-Eintrag wie diesem:

"commands": {
  "toggle-feature": {
    "suggested_key": {
      "default": "Ctrl+Shift+Y"
    },
    "description": "Send a 'toggle-feature' event"
  }
}

Könnten Sie auf diesen speziellen Befehl wie folgt hören:

browser.commands.onCommand.addListener((command) => {
  if (command === "toggle-feature") {
    console.log("toggling the feature!");
  }
});

• commands