sidebarAction.setTitle()

Ihre Erweiterung sollte einen Titel für die Seitenleiste im sidebar_action Manifest-Schlüssel angeben. Dies 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 "fensterspezifischer 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 tabId- als auch die windowId-Option weglassen, wird damit der "globale Titel" festgelegt. Der globale Titel erscheint dann in allen Tabs, die keinen tab-spezifischen Titel haben und deren Fenster keinen fensterspezifischen Titel haben.

details

object. Ein Objekt mit den 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 immer noch 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, wird der Tab den Titel des Fensters übernehmen, zu dem er gehört.
• Wenn windowId angegeben ist und das Fenster einen fensterspezifischen Titel hat, wird das Fenster den globalen Titel übernehmen.
• 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 windowId und tabId beide angegeben sind, schlägt die Funktion fehl und der Titel wird nicht gesetzt.
• Wenn windowId und tabId beide weggelassen werden, wird der globale Titel gesetzt.

Dieser Code ändert den Titel für die Seitenleiste, wenn der Benutzer auf eine Browseraktion klickt, jedoch 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);