action.getTitle()

获取浏览器操作的标题。

备注：该 API 在 Manifest V3 或更高版本中可用。

就像你可以使用 action.setTitle() 在每个标签页上设置标题一样，你也可以通过将标签页的 ID 传递给此函数来检索特定于标签页的标题。

这是一个返回 Promise 的异步函数。

语法

js
let gettingTitle = browser.action.getTitle(
  details               // 对象
)

参数

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

浏览器兼容性

BCD tables only load in the browser

备注：该 API 基于 Chromium 的 chrome.action API。该文档衍生自 Chromium 代码中的 browser_action.json。