action.getTitle()

Erhält den Titel der Browser-Aktion.

Genau wie Sie den Titel tab-spezifisch mit action.setTitle() festlegen können, können Sie auch 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.action.getTitle(
 details // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

tabId Optional

integer. Gibt den Tab an, von dem der Titel abgerufen werden soll.

windowId Optional

integer. Gibt das Fenster an, von dem der Titel abgerufen werden soll.

• Wenn windowId und tabId beide angegeben sind, schlägt die Funktion fehl und das zurückgegebene Promise wird abgelehnt.
• Wenn sowohl windowId als auch tabId weggelassen werden, wird der globale Titel zurückgegeben.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, welcher den Titel der Browser-Aktion enthält.

Beispiele

Dieser Code wechselt den Titel zwischen "this" und "that" jedes Mal, wenn der Benutzer auf die Browser-Aktion klickt:

function toggleTitle(title) {
 if (title === "this") {
 browser.action.setTitle({ title: "that" });
 } else {
 browser.action.setTitle({ title: "this" });
 }
}
browser.action.onClicked.addListener(() => {
 let gettingTitle = browser.action.getTitle({});
 gettingTitle.then(toggleTitle);
});

Browser-Kompatibilität