Spec-Zone.ru › Web Extensions

action.getTitle()

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

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

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

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

Синтаксис

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

Параметры

details

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

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

integer. Указывает вкладку, заголовок которой требуется получить.

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

integer. Указывает окно, заголовок которого требуется получить.

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

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

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

Примеры

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

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 for Android Opera Android Safari on IOS Samsung Internet
getTitle 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/getTitle

Spec-Zone.ru

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