Spec-Zone.ru › Web Extensions

action.setTitle()

Устанавливает заголовок действия браузера. Заголовок отображается в подсказке над иконкой действия браузера. Вы можете передать tabId или windowId в качестве необязательного параметра — в этом случае заголовок изменяется только для указанной вкладки или окна. Вкладки или окна без конкретного заголовка наследуют глобальный текст заголовка, который по умолчанию равен default_title или name, указанным в манифесте.

Примечание: Этот API доступен в манифесте версии 3 или выше.

Синтаксис

browser.action.setTitle(
  details // object
)

Параметры

details

object. Новый заголовок и необязательно идентификатор вкладки или окна, на которые нацелено действие.

title

string или null. Строка, которую действие браузера должно отображать при наведении курсора.

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

Если title равно null:

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

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

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

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

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

Примеры

Этот код переключает заголовок между "это" и "то" каждый раз, когда пользователь нажимает на действие браузера:

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);
});

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera для Android Safari на iOS Samsung Internet
setTitle 88 88 109 ? 74 Нет ? ? 109 ? Нет ?

Примечание: Этот API основан на API chrome.action 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/action/setTitle

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API