sidebarAction.setTitle()

Ihre Erweiterung sollte einen Titel für die Seitenleiste im sidebar_action Manifest-Schlüssel angeben. Dieser wird als "Manifest-Titel" bezeichnet. Wenn Sie den Manifest-Titel nicht angeben, wird standardmäßig der Name der Erweiterung verwendet.

Wenn Sie einen neuen Titel mit setTitle() festlegen und die tabId-Option einschließen, wird der Titel nur für den angegebenen Tab festgelegt. Dieser Titel wird als "Tab-spezifischer Titel" bezeichnet.

Wenn Sie einen neuen Titel mit setTitle() festlegen und die windowId-Option einschließen, wird der Titel nur für das angegebene Fenster festgelegt. Dieser Titel wird als "Fenster-spezifischer Titel" bezeichnet und erscheint in allen Tabs dieses Fensters, die keinen Tab-spezifischen Titel haben.

Wenn Sie einen neuen Titel mit setTitle() festlegen und sowohl die Optionen tabId als auch windowId weglassen, wird der "globale Titel" gesetzt. Der globale Titel erscheint dann in allen Tabs, die weder einen Tab-spezifischen Titel haben noch deren Fenster einen Fenster-spezifischen Titel hat.

details

object. Ein Objekt mit folgenden Eigenschaften:

title

string oder null. Der neue Titel der Seitenleiste.

Wenn title ein leerer String ist, wird der verwendete Titel der Name der Erweiterung sein, aber sidebarAction.getTitle wird weiterhin den leeren String liefern.

Wenn title null ist, wird ein zuvor gesetzter Titel entfernt, sodass:

• Wenn tabId angegeben ist und der Tab einen Tab-spezifischen Titel hat, der Tab den Titel des Fensters erbt, zu dem er gehört.
• Wenn windowId angegeben ist und das Fenster einen Fenster-spezifischen Titel hat, das Fenster den globalen Titel erbt.
• Andernfalls wird der globale Titel auf den Manifest-Titel 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.

• 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 weggelassen werden, wird der globale Titel gesetzt.

Dieser Code ändert den Titel für die Seitenleiste, wenn der Benutzer auf eine Browser-Aktion klickt, aber nur für den aktuellen Tab:

let title = "A different title";

function setTitleForTab(tab) {
  browser.sidebarAction.setTitle({ title, tabId: tab.id });
}

browser.browserAction.onClicked.addListener(setTitleForTab);