action.getTitle()
获取浏览器操作的标题。
注意:此 API 在 Manifest V3 或更高版本中可用。
就像您可以使用 action.setTitle() 按标签页设置标题一样,您也可以通过将标签页的 ID 传递给此函数来检索特定于标签页的标题。
这是一个异步函数,返回一个 Promise。
语法
js
let gettingTitle = browser.action.getTitle(
details // object
)
参数
details-
具有以下属性的对象:
tabId可选-
integer。指定要从中获取标题的标签页。 windowId可选-
integer。指定要从中获取标题的窗口。
- 如果同时提供了
windowId和tabId,则函数将失败,并且它返回的 Promise 将被拒绝。 - 如果同时省略了
windowId和tabId,则返回全局标题。
返回值
一个 Promise,它将以包含浏览器操作标题的字符串来兑现。
示例
此代码在用户每次点击浏览器操作时,在“this”和“that”之间切换标题。
js
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);
});
浏览器兼容性
加载中…
注意:此 API 基于 Chromium 的 chrome.action API。本文档源自 Chromium 代码中的 browser_action.json。