browserAction.getTitle()

获取浏览器操作的标题。

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

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

语法

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

参数

details

包含以下属性的对象:

tabId 可选

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

windowId 可选

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

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

返回值

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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getTitle
details.windowId parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

示例

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