browserAction.setTitle()

语法

browser.browserAction.setTitle(
  details // object
)

参数

details

object。新的标题，以及可选的要定位的标签页或窗口的 ID。

title

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

如果 title 为空字符串，则使用的标题将是扩展名，但 browserAction.getTitle 仍将返回空字符串。

如果 title 为 null

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

tabId 可选

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

windowId 可选

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

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

示例

此代码在用户每次点击浏览器操作时，在“this”和“that”之间切换标题。

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);
});

扩展程序示例

• bookmark-it

浏览器兼容性