browserAction.getTitle()

Получает заголовок действия браузера.

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

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let gettingTitle = browser.browserAction.getTitle(
  details               // object
)

Параметры

details

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

tabId Необязательно: integer. Укажите вкладку, для которой нужно получить заголовок.
windowId Необязательно: integer. Укажите окно, для которого нужно получить заголовок.

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

Возвращаемое значение

A Promise, который будет выполнен со строкой, содержащей заголовок действия браузера.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`getTitle`	Да	15	45	?	Да	14	?	?	55	?	15 API существует, но заголовок не отображается в пользовательском интерфейсе.	?
`details_windowId_parameter`	Нет	Нет	62	?	Нет	Нет	?	?	Нет	?	Нет	?

Примеры

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

function toggleTitle(title) {
  if (title === "this") {
    browser.browserAction.setTitle({ title: "that" });
  } else {
    browser.browserAction.setTitle({ title: "this" });
  }
}

browser.browserAction.onClicked.addListener(() => {
  let gettingTitle = browser.browserAction.getTitle({});
  gettingTitle.then(toggleTitle);
});

Примечание: Этот 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/getTitle