sidebarAction.getTitle()
Erhält den Titel der Sidebar.
Genau wie Sie den Titel basierend auf dem Tab mit sidebarAction.setTitle()
setzen können, so können Sie einen tab-spezifischen Titel abrufen, indem Sie die ID des Tabs in 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:tabId
Optional-
integer
. Holt den Titel für die Sidebar, der spezifisch für den angegebenen Tab ist. windowId
Optional-
integer
. Holt den Titel für die Sidebar, der spezifisch für das angegebene Fenster ist.
- Wenn sowohl
windowId
als auchtabId
angegeben werden, schlägt die Funktion fehl und das 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 Sidebar enthält.
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);
});
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.sidebarAction
API von Opera.