sidebarAction.getTitle()

Obtient le titre de la barre latérale.

Tout comme vous pouvez définir le titre par tabulation à l'aide de sidebarAction.setTitle(),vous pouvez ainsi récupérer un titre spécifique à un onglet en lui transmettant l'ID de l'onglet.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var gettingTitle = browser.sidebarAction.getTitle(
  details               // object
)

Paramètres

details
object. Un objet avec les propriétés suivantes :
tabIdFacultatif
integer. Obtenir le titre de la barre latérale spécifique à l'onglet donné.
windowId Facultatif
integer. Obtenir le titre de la barre latérale spécifique à la fenêtre donnée.
  • Si windowId et tabId sont tous deux fournis, la fonction échoue et la promesse qu'elle renvoie est rejetée.
  • SI windowId et tabId sont tous les deux omis, le titre global est renvoyé.

Valeur retournée

Une Promise qui sera remplie avec une chaîne contenant le titre de la barre latérale.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 54Opera Support complet 30Firefox Android Aucun support Non
details.windowIdChrome Aucun support NonEdge Aucun support NonFirefox Support complet 61Opera Aucun support NonFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Exemples

Ce code bascule le titre entre "this" et "that" chaque fois que l'utilisateur clique sur l'action du navigateur

function toggleTitle(title) {
  if (title == "this") {
    browser.sidebarAction.setTitle({title: "that"});
  } else {
    browser.sidebarAction.setTitle({title: "this"});
  }
}

browser.browserAction.onClicked.addListener(() => {
  var gettingTitle = browser.sidebarAction.getTitle({});
  gettingTitle.then(toggleTitle);
});

Remerciements :

Cette API est basée sur l'API Opera chrome.sidebarAction.

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,