sidebarAction.getTitle()

获取侧边栏的标题。

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

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

语法

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

参数

details

object。包含以下属性的对象:

tabId 可选

integer。获取特定于给定标签页的侧边栏的标题。

windowId 可选

integer。获取特定于给定窗口的侧边栏的标题。

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

返回值

Promise,将兑现为包含侧边栏标题的字符串。

浏览器兼容性

BCD tables only load in the browser

示例

在用户点击浏览器操作时在“这”和“那”之间切换标题:

js
function toggleTitle(title) {
  if (title === "this") {
    browser.sidebarAction.setTitle({ title: "那" });
  } else {
    browser.sidebarAction.setTitle({ title: "这" });
  }
}

browser.browserAction.onClicked.addListener(() => {
  let gettingTitle = browser.sidebarAction.getTitle({});
  gettingTitle.then(toggleTitle);
});

备注: 此 API 基于 Opera 的 chrome.sidebarAction API。