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

js
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 Seitenleiste, die dem angegebenen Tab zugeordnet ist.

windowId Optional

integer. Holt den Titel für die Seitenleiste, die dem angegebenen Fenster zugeordnet ist.

  • Wenn sowohl windowId als auch tabId angegeben werden, schlägt die Funktion fehl und das von ihr 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, 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.

js
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.