browserAction.setTitle()

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

语法

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

参数

details

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

title

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

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

如果 title 为 null

  • 如果指定了 tabId，并且标签页设置了标签页特定的标题，则该标签页将继承其所属窗口的标题。
  • 如果指定了 windowId，并且窗口设置了窗口特定的标题，则该窗口将继承全局标题。
  • 否则，全局标题将重置为清单标题。
tabId 可选

integer. 仅为给定的标签页设置标题。

windowId 可选

integer. 为给定的窗口设置标题。

  • 如果同时提供 windowId 和 tabId，则函数将失败，并且不会设置标题。
  • 如果省略 windowId 和 tabId，则将设置全局标题。

浏览器兼容性

BCD 表仅在浏览器中加载

示例

此代码每次用户单击浏览器操作时，会在“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。