sidebarAction.getTitle()

Ruft den Titel der Seitenleiste ab.

Genau wie Sie den Titel tab-spezifisch mit sidebarAction.setTitle() setzen können, können Sie 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 für den angegebenen Tab spezifisch ist.

windowId Optional

integer. Holt den Titel für die Seitenleiste, die für das angegebene Fenster spezifisch ist.

  • Wenn sowohl windowId als auch tabId angegeben werden, 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, der den Titel der Seitenleiste enthält.

Browser-Kompatibilität

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 Operas chrome.sidebarAction API.