sidebarAction.getTitle()

Ruft den Titel der Seitenleiste ab.

Genau wie Sie den Titel tab-spezifisch mit sidebarAction.setTitle() festlegen können, so 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

let gettingTitle = browser.sidebarAction.getTitle(
  details               // object
)

Parameter

details

object. Ein Objekt mit den folgenden Eigenschaften:

tabId Optional: integer. Holt den Titel der Seitenleiste, der spezifisch für den angegebenen Tab ist.
windowId Optional: integer. Holt den Titel der Seitenleiste, der spezifisch für das angegebene Fenster ist.

Wenn windowId und tabId beide angegeben sind, schlägt die Funktion fehl und das zurückgegebene Promise wird abgelehnt.
Wenn windowId und tabId beide 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.

Beispiele

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

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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden