sidebarAction.getTitle()
Ruft den Titel der Seitenleiste ab.
Genau wie Sie den Titel für einen bestimmten Tab mittels sidebarAction.setTitle()
festlegen können, so können Sie auch einen Tab-spezifischen Titel abrufen, indem Sie die ID des Tabs an diese Funktion übergeben.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let gettingTitle = browser.sidebarAction.getTitle(
details // object
)
Parameter
details
-
object
. Ein Objekt mit den folgenden Eigenschaften:
- Wenn sowohl
windowId
als auchtabId
angegeben werden, schlägt die Funktion fehl und das von ihr zurückgegebene Promise wird abgelehnt. - Wenn sowohl
windowId
als auchtabId
weggelassen werden, wird der globale Titel zurückgegeben.
Rückgabewert
Ein Promise
, das mit einem String erfüllt wird, der den Titel der Seitenleiste enthält.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Dieser Code wechselt den Titel zwischen "this" und "that" jedes Mal, wenn der Benutzer auf die Browseraktion klickt.
function toggleTitle(title) {
if (title === "this") {
browser.sidebarAction.setTitle({ title: "that" });
} else {
browser.sidebarAction.setTitle({ title: "this" });
}
}
browser.browserAction.onClicked.addListener(() => {
let gettingTitle = browser.sidebarAction.getTitle({});
gettingTitle.then(toggleTitle);
});
Hinweis: Diese API basiert auf der chrome.sidebarAction
-API von Opera.