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

js
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.

Exemples

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

js
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);
});

Compatibilité des navigateurs

BCD tables only load in the browser

Note :

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.