browserAction.setBadgeText()

Устанавливает текст метки для действия браузера. Метка отображается поверх значка.

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

Синтаксис

browser.browserAction.setBadgeText(
  details // object
)

Этот API также доступен как chrome.browserAction.setBadgeText().

Параметры

details

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

text

string или null. Можно передать любое количество символов, но в отводимом пространстве помещаются примерно четыре.

Используйте пустую строку - "" - если вы не хотите отображать метку.

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

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

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

integer. Устанавливает текст метки только для данной вкладки. Текст сбрасывается, когда пользователь переходит в этой вкладке на новую страницу.

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

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

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

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`setBadgeText`	Да	14	45 45–58 Текст метки, специфичный для вкладки, не очищается при загрузке новой страницы.	?	Да	14	?	?	79	?	15	?
`details_windowId_parameter`	Нет	Нет	62	?	Нет	Нет	?	?	79	?	Нет	?
`null`	Нет	Нет	59	?	Нет	Нет	?	?	79	?	Нет	?

Примеры

Добавьте метку, показывающую, сколько раз пользователь нажал кнопку:

let clicks = 0;

function increment() {
  browser.browserAction.setBadgeText({ text: (++clicks).toString() });
}

browser.browserAction.onClicked.addListener(increment);

Примеры расширений

tabs-tabs-tabs

Примечание: Этот API основан на API chrome.browserAction Chromium. Данная документация взята из browser_action.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeText