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