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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getTitle

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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.