tabs.highlight()
突出显示(选择)一个或多个标签页。通过窗口 ID 和一系列标签索引来指定标签页。
这是一个返回 Promise
的异步函数。
语法
js
let highlighting = browser.tabs.highlight(
highlightInfo, // 对象
);
参数
highlightInfo
-
object
。windowId
可选-
integer
。包含要突出显示标签页的窗口的 ID。 populate
可选-
boolean
。默认为true
。如果设置为false
,则windows.Window
对象不会包含tabs
属性,该属性包含表示窗口中打开的标签页的tabs.Tab
对象列表。备注: 在标签页很多的情况下,对窗口进行填充(默认行为)可能会消耗大量资源。为了更好的性能,如果不需要标签页详情,建议手动将
populate
设置为false
。 tabs
-
integer
数组,指定要突出显示的一个或多个标签页索引。之前突出显示的但未包含在tabs
中的标签页将停止被突出显示。tabs
中的第一个标签页将成为活动标签页。
返回值
一个 Promise
,其会兑现一个包含突出显示的标签页信息的 windows.Window
对象。如果无法找到窗口或发生其他错误,promise 会以错误信息拒绝。
浏览器兼容性
BCD tables only load in the browser
备注:
此 API 基于 Chromium 的 chrome.tabs
API。此文档源自 Chromium 代码中的 tabs.json
。