browserAction.getTitle()

获取浏览器操作的标题。

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

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

语法

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

参数

details

包含以下属性的对象:

tabId 可选

integer。指定要从中获取标题的标签页。

windowId 可选

integer。指定要从中获取标题的窗口。

  • 如果同时提供了 windowIdtabId,则函数失败并返回的 Promise 会被拒绝。
  • 如果 windowIdtabId 都省略,则返回全局标题。

返回值

一个 Promise,其会兑现一个包含浏览器操作标题的字符串。

浏览器兼容性

BCD tables only load in the browser

示例

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