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 :-
tabId
Facultatifinteger
. Obtenir le titre de la barre latérale spécifique à l'onglet donné.windowId
Facultatifinteger
. Obtenir le titre de la barre latérale spécifique à la fenêtre donnée.
- Si
windowId
ettabId
sont tous deux fournis, la fonction échoue et la promesse qu'elle renvoie est rejetée. - SI
windowId
ettabId
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
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
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);
});
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.