browserAction.getTitle()
获取浏览器操作的标题。
就像可以使用 browserAction.setTitle()
设置每个标签页的标题一样,通过将标签页的 ID 传递给此函数,也可以检索特定标签页的标题。
这是一个返回 Promise
的异步函数。
语法
js
let gettingTitle = browser.browserAction.getTitle(
details // 对象
)
参数
details
-
包含以下属性的对象:
tabId
可选-
integer
。指定要从中获取标题的标签页。 windowId
可选-
integer
。指定要从中获取标题的窗口。
- 如果同时提供了
windowId
和tabId
,则函数失败并返回的 Promise 会被拒绝。 - 如果
windowId
和tabId
都省略,则返回全局标题。
返回值
一个 Promise
,其会兑现一个包含浏览器操作标题的字符串。
浏览器兼容性
BCD tables only load in the browser
示例
此代码每次用户点击浏览器操作时,在“this”和“that”之间切换标题:
js
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 基于 Chromium 的 chrome.browserAction
API。该文档衍生自 Chromium 代码中的 browser_action.json
。