sidebarAction.getTitle()

获取侧边栏的标题。

就像您可以使用 sidebarAction.setTitle() 在每个选项卡的基础上设置标题一样，您也可以通过将选项卡的 ID 传递给此函数来检索特定于选项卡的标题。

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

语法

let gettingTitle = browser.sidebarAction.getTitle(
  details               // object
)

参数

details

object. 一个具有以下属性的对象

tabId 可选: integer. 获取特定于给定选项卡的侧边栏标题。
windowId 可选: integer. 获取特定于给定窗口的侧边栏标题。

如果同时提供了 windowId 和 tabId，则函数将失败，并且它返回的 Promise 将被拒绝。
如果同时省略了 windowId 和 tabId，则将返回全局标题。

返回值

一个 Promise，它将以包含侧边栏标题的字符串的形式完成。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例

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

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

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

注意：此 API 基于 Opera 的 chrome.sidebarAction API。