action.setTitle()

Syntax

browser.action.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 Text, den die Browser-Aktion bei Mauszeigerbewegung anzeigen soll.

Wenn title ein leerer String ist, wird der Erweiterungsname als Titel verwendet, aber action.getTitle liefert dennoch den leeren String.

Wenn title null ist:

• Wenn tabId angegeben ist und der Tab einen tab-spezifischen Titel hat, übernimmt der Tab den Titel des Fensters, zu dem er gehört.
• Wenn windowId angegeben ist und das Fenster einen fensterspezifischen Titel hat, ü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 für das angegebene Fenster.

• Wenn sowohl windowId als auch tabId angegeben sind, schlägt die Funktion fehl und der Titel wird nicht gesetzt.
• Wenn sowohl windowId als auch tabId ausgelassen 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.action.setTitle({ title: "that" });
  } else {
    browser.action.setTitle({ title: "this" });
  }
}

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

Browser-Kompatibilität