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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 48
Notes
Support complet 48
Notes
Notes Before version 63, the onCommand listener was not treated as a handler for a user action.
Opera Support complet OuiFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

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.

Étiquettes et contributeurs liés au document

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