onCommand

Syntax

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

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Beendet das Lauschen auf dieses Ereignis. 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 lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn ein Benutzer das Tastenkürzel des Befehls eingibt. Die Funktion erhält folgende Argumente:

name

string. Name des Befehls. Dieser Name entspricht dem Namen, der dem Befehl in seinem manifest.json-Eintrag zugewiesen wurde.

tab

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

Beispiele

Bei einem solchen manifest.json-Eintrag:

"commands": {
  "duplicate-tab": {
    "suggested_key": {
      "default": "Ctrl+Shift+D"
    },
    "description": "Duplicate the active tab"
  }
}

Können Sie auf diesen Befehl lauschen und den tab, der an den Listener übergeben wird, verwenden, um den aktiven Tab zu duplizieren, wie folgt:

browser.commands.onCommand.addListener((command, tab) => {
  if (command === "duplicate-tab") {
    browser.tabs.duplicate(tab.id);
  }
});

Beispielerweiterungen

• commands

Browser-Kompatibilität