Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

browserAction.isEnabled()

Renvoie true si l'action du navigateur est activée.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
let gettingIsEnabled = browser.browserAction.isEnabled(
  details, // object
);

Paramètres

details

object. Un objet contenant éventuellement le tabId ou windowId à vérifier.

tabId Facultatif

integer. ID d'un onglet à vérifier

windowId Facultatif

integer. ID d'une fenêtre à vérifier.

  • Si windowId et tabId sont tous les deux fournis, la fonction échoue.
  • Si windowId et tabId sont tous les deux omis, l'état global activé/désactivé est renvoyé.

Valeur retournée

Une Promise qui sera remplie avec true si l'action du navigateur de l'extension est activée, et false dans le cas contraire.

Exemples

Vérifiez l'état global :

js
browser.browserAction.isEnabled({}).then((result) => {
  console.log(result);
});

Vérifiez l'état de l'onglet actuellement actif :

js
async function enabledInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let enabled = await browser.browserAction.isEnabled({
    tabId: tabs[0].id,
  });
  console.log(enabled);
}

Compatibilité des navigateurs