browserAction.onClicked

Action quand l'icone d'action du navigateur est cliqué. Cet événement ne déclenchera pas si l'action du navigateur comporte une fenêtre contextuelle.

Pour définir une action de clic droit, utilisez l'API contextMenus avec le type de contexte "browser_action".

Syntaxe

js
browser.browserAction.onClicked.addListener(listener);
browser.browserAction.onClicked.removeListener(listener);
browser.browserAction.onClicked.hasListener(listener);

Les événements ont trois fonctions :

addListener(listener)

Ajoutez un auditeur à cet événement.

removeListener(listener)

Arretez d'écouter cet événement. L'argument de l'auditeur est l'auditeur à supprimer.

hasListener(listener)

Vérifier si l'autditeur est enregistré pour cet événement. Renvoie true si elle est écouté, sinon false.

Syntaxe addListener

Paramètre

callback

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

tab

tabs.Tab. L'onglet qui était actif lorsque l'icône a été cliquée .

Compatibilité des navigateurs

BCD tables only load in the browser

Exemples

Lorsque l'utilisateur clique sur l'icône, désactivez-la pour l'onglet actif et enregistrez l'URL de l'onglet

js
browser.browserAction.onClicked.addListener((tab) => {
  // disable the active tab
  browser.browserAction.disable(tab.id);
  // requires the "tabs" or "activeTab" permission
  console.log(tab.url);
});

Example extensions

Note :

Cette API est basée sur l'API Chromium chrome.browserAction. Cette documentation est dérivée de browser_action.json dans le code de Chromium code.

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.