browserAction.setTitle()

Syntax

browser.browserAction.setTitle(
  details // object
)

Parameter

details

object. Der neue Titel und optional die ID des Tabs oder Fensters, das angesprochen werden soll.

title

string oder null. Der String, den die Browser-Aktion anzeigen soll, wenn sie mit der Maus überfahren wird.

Wenn title ein leerer String ist, wird der verwendete Titel der Erweiterungsname sein, aber browserAction.getTitle wird dennoch den leeren String liefern.

Wenn title null ist:

• Wenn tabId angegeben ist und der Tab einen tab-spezifischen Titel gesetzt hat, dann übernimmt der Tab den Titel des Fensters, zu dem er gehört.
• Wenn windowId angegeben ist und das Fenster einen fensterspezifischen Titel gesetzt hat, dann übernimmt das Fenster den globalen Titel.
• Andernfalls wird der globale Titel auf den Manifesttitel zurückgesetzt.

tabId Optional

integer. Setzt den Titel nur für den angegebenen Tab.

windowId Optional

integer. Setzt den Titel nur für das angegebene Fenster.

• Werden sowohl windowId als auch tabId angegeben, schlägt die Funktion fehl und der Titel wird nicht gesetzt.
• Wenn sowohl windowId als auch tabId weggelassen werden, wird der globale Titel gesetzt.

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.browserAction.setTitle({ title: "that" });
  } else {
    browser.browserAction.setTitle({ title: "this" });
  }
}

browser.browserAction.onClicked.addListener(() => {
  let gettingTitle = browser.browserAction.getTitle({});
  gettingTitle.then(toggleTitle);
});

Beispielerweiterungen

• bookmark-it

Browser-Kompatibilität