sidebarAction.getTitle()
获取侧边栏的标题。
就像你可以使用 sidebarAction.setTitle()
在每个标签上设置标题一样,你也可以通过将标签页的 ID 传递给此函数来检索特定于标签页的标题。
这是一个返回 Promise
的异步函数。
语法
js
let gettingTitle = browser.sidebarAction.getTitle(
details // 对象
)
参数
details
-
object
。包含以下属性的对象:tabId
可选-
integer
。获取特定于给定标签页的侧边栏的标题。 windowId
可选-
integer
。获取特定于给定窗口的侧边栏的标题。
- 如果同时提供了
windowId
和tabId
,函数将失败且返回的 promise 将被拒绝。 - 如果同时省略
windowId
和tabId
,则返回全局标题。
返回值
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。