action.setTitle()

设置浏览器操作的标题。标题显示在浏览器操作图标上的工具提示中。您可以传递一个tabId或一个windowId作为可选参数 - 如果你这样做，那么标题只会在指定的标签或窗口中更改。没有特定标题的标签或窗口将继承全局标题文本，默认值为清单中指定的default_title或name。

注意：此 API 在清单 V3 或更高版本中可用。

语法

js
browser.action.setTitle(
  details // object
)

参数

details

object. 新标题，以及可选的目标标签或窗口的 ID。

title

string 或 null. 浏览器操作在鼠标悬停时应该显示的字符串。

如果title是一个空字符串，使用的标题将是扩展名，但action.getTitle仍然会提供空字符串。

如果title是null

  • 如果指定了tabId，并且标签设置了标签特定的标题，那么标签将继承其所属窗口的标题。
  • 如果指定了windowId，并且窗口设置了窗口特定的标题，那么窗口将继承全局标题。
  • 否则，全局标题将重置为清单标题。
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);
});

浏览器兼容性

BCD 表只在浏览器中加载

注意：此 API 基于 Chromium 的 chrome.action API。此文档来自 Chromium 代码中的 browser_action.json。