onCommand
Lancer quand une commande est exécutée à l'aide de son raccourci clavier associé.L'écouteur reçoit le nom de la commande. Cela correspond au nom donnée à la commande dans une entrée manifest.json.
Syntaxe
browser.commands.onCommand.addListener(listener);
browser.commands.onCommand.removeListener(listener);
browser.commands.onCommand.hasListener(listener);
Les événements ont trois fonctions :
addListener(callback)
-
Ajoute un écouteur à un événement.
removeListener(listener)
-
Arrêter d'écouter un événement. L'arguement
listener
est l'écouteur à supprimer. hasListener(listener)
-
Vérifiez si
listener
est enregistré pour cet événement . Renvoietrue
s'il écoute,false
sinon.
Syntaxe addListener
Paramètre
callback
-
Fonction qui sera appelée lorsqu'un utilisateur entre dans le raccourci de la commande. La fonction recevra les arguments suivants :
name
-
string
. Nom de la commande. Cela correspond au nom donné à la commande dans son entrée manifest.json.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Etant donnée une entrée manifest.json comme ceci :
"commands": {
"toggle-feature": {
"suggested_key": {
"default": "Ctrl+Shift+Y"
},
"description": "Send a 'toggle-feature' event"
}
}
Vous pouvez écouter cette commande particulière comme ceci :
browser.commands.onCommand.addListener(function (command) {
if (command == "toggle-feature") {
console.log("toggling the feature!");
}
});
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.commands
.