action.setTitle()
设置浏览器操作的标题。标题会显示在浏览器操作图标上方的工具提示中。您可以选择性地传递一个 tabId 或 windowId 作为可选参数 — 如果这样做，则仅为指定的标签页或窗口更改标题。没有特定标题的标签页或窗口将继承全局标题文本，该文本默认为 manifest 中指定的 default_title 或 name。
注意：此 API 在 Manifest V3 或更高版本中可用。
语法
js
browser.action.setTitle(
details // object
)
参数
details-
object。新的标题，以及可选的要定位的标签页或窗口的 ID。title-
string或null。当鼠标悬停在浏览器操作图标上时，浏览器操作应显示的字符串。如果
title是一个空字符串，将使用的标题是扩展名，但action.getTitle仍将返回空字符串。如果
title是null- 如果指定了
tabId，并且该标签页设置了特定于标签页的标题，那么该标签页将继承其所属窗口的标题。 - 如果指定了
windowId，并且该窗口设置了特定于窗口的标题，那么该窗口将继承全局标题。 - 否则，全局标题将重置为 manifest 标题。
- 如果指定了
tabId可选-
integer。仅为给定的标签页设置标题。 windowId可选-
integer。为给定的窗口设置标题。
- 如果同时提供了
windowId和tabId，则函数会失败，标题不会被设置。 - 如果同时省略了
windowId和tabId，则会设置全局标题。
示例
此代码在用户每次点击浏览器操作时，在“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。