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