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é. windowIdFacultatif-
integer. Obtenir le titre de la barre latérale spécifique à la fenêtre donnée.
- Si
windowIdettabIdsont tous deux fournis, la fonction échoue et la promesse qu'elle renvoie est rejetée. - SI
windowIdettabIdsont 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
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
Chargement…
Note :
Cette API est basée sur l'API Opera chrome.sidebarAction.