sidebarAction.setTitle()

Ваше расширение должно указать заголовок для боковой панели в ключе sidebar_action манифеста. Это называется "заголовок манифеста". Если вы не укажете заголовок манифеста, он будет по умолчанию равен имени расширения.

Если вы установите новый заголовок с помощью setTitle(), и включите опцию tabId, то заголовок будет установлен только для данного вкладки. Этот заголовок называется "заголовок, специфичный для вкладки".

Если вы установите новый заголовок с помощью setTitle(), и включите опцию windowId, то заголовок будет установлен только для данного окна. Этот заголовок называется "заголовок, специфичный для окна", и он будет отображаться во всех вкладках этого окна, в которых не установлен заголовок, специфичный для вкладки.

Если вы установите новый заголовок с помощью setTitle(), и опустите оба параметра tabId и windowId, тогда это установит "глобальный заголовок". Глобальный заголовок будет отображаться во всех вкладках, в которых не установлен заголовок, специфичный для вкладки, и у которых окно не имеет заголовка, специфичного для окна.

details

object. Объект со следующими свойствами:

title

string или null. Новый заголовок боковой панели.

Если title пустая строка, используемый заголовок будет именем расширения, но sidebarAction.getTitle всё равно вернёт пустую строку.

Если title равно null, то ранее установленный заголовок будет удалён, так что:

• Если tabId указан, и у вкладки установлен заголовок, специфичный для вкладки, то вкладка унаследует заголовок от окна, к которому она принадлежит.
• Если windowId указан, и у окна установлен заголовок, специфичный для окна, то окно унаследует глобальный заголовок.
• В противном случае глобальный заголовок будет сброшен до заголовка манифеста.

tabId Необязательно

integer. Устанавливает заголовок только для данной вкладки.

windowId Необязательно

integer. Устанавливает заголовок только для данного окна.

• Если windowId и tabId оба указаны, функция завершается неудачно, и заголовок не устанавливается.
• Если windowId и tabId оба пропущены, устанавливается глобальный заголовок.

Этот код изменяет заголовок боковой панели, когда пользователь нажимает на действие браузера, но только для текущей вкладки:

let title = "A different title";

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

browser.browserAction.onClicked.addListener(setTitleForTab);