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 . Renvoie true 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é du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui Non48 Non Oui

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

Remerciements :

Cette API est basée sur l'API Chromium chrome.commands.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,