onCommand
Wird ausgelöst, wenn ein Befehl über das zugehörige Tastenkürzel ausgeführt wird.
Das Ereignis übergibt dem Listener den Namen des Befehls. Dieser Name entspricht dem Namen, der für den Befehl in seinem manifest.json-Eintrag angegeben ist.
Wenn die Erweiterung über die Berechtigung activeTab verfügt, gilt das Auslösen eines Tastenkürzels für einen Befehl als Benutzeraktion, die der Erweiterung vorübergehend Zugriff auf den aktiven Tab gewährt.
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)-
Entfernt einen Listener für dieses Ereignis. Das Argument
listenergibt den zu entfernenden Listener an. hasListener(listener)-
Prüft, ob
listenerfür dieses Ereignis registriert ist. Gibttruezurück, wenn er registriert ist, andernfallsfalse.
addListener-Syntax
Parameter
listener-
Die Funktion, die aufgerufen wird, wenn ein Benutzer das Tastenkürzel des Befehls eingibt. Der Funktion werden folgende Argumente übergeben:
name-
string. Name des Befehls. Dieser Name entspricht dem Namen, der für den Befehl in seinem manifest.json-Eintrag angegeben ist. tab-
tabs.Tab. Der Tab, der aktiv war, als das Tastenkürzel des Befehls eingegeben wurde.
Beispiele
Angenommen, es gibt einen manifest.json-Eintrag wie diesen:
"commands": {
"duplicate-tab": {
"suggested_key": {
"default": "Ctrl+Shift+D"
},
"description": "Duplicate the active tab"
}
}
Sie können auf diesen Befehl reagieren und den an den Listener übergebenen tab verwenden, um den aktiven Tab zu duplizieren:
browser.commands.onCommand.addListener((command, tab) => {
if (command === "duplicate-tab") {
browser.tabs.duplicate(tab.id);
}
});
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.commands-API.