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

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Non Non54 Non30
details.windowId Non Non61 Non Non

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,