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

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

Exemples

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

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

Exemples d'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.

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content