onCommand
Wird ausgelöst, wenn ein Befehl mit dem zugeordneten Tastaturkürzel ausgeführt wird.
Dem Listener wird der Name des Befehls übergeben. Dieser stimmt mit dem Namen überein, der dem Befehl in seinem manifest.json-Eintrag gegeben wurde.
Syntax
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. Gibttrue
zurück, wenn es zuhört, andernfallsfalse
.
addListener-Syntax
Parameter
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.
Beispiele
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!");
}
});
Beispielerweiterungen
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
onCommand | |||||||
name | |||||||
tab |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.
Hinweis:
Diese API basiert auf Chromium's chrome.commands
API.