tabs.highlight()
突出显示(选择)一个或多个标签。标签使用窗口 ID 和标签索引范围指定。
这是一个异步函数,返回一个 Promise
。
语法
js
let highlighting = browser.tabs.highlight(
highlightInfo // object
)
参数
highlightInfo
-
对象
.windowId
可选-
整数
。包含标签的窗口的 ID。 populate
可选-
布尔值
。默认值为true
。如果设置为false
,则windows.Window
对象将没有包含代表窗口中打开标签的tabs.Tab
对象列表的tabs
属性。注意: 如果存在大量标签,填充窗口(默认行为)可能是一项昂贵的操作。为了提高性能,建议在您不需要标签详细信息的情况下,手动将
populate
设置为false
。 tabs
-
数组
,包含指定一个或多个要突出显示的标签索引的整数值。之前突出显示的标签(不在tabs
中)将不再被突出显示。tabs
中的第一个标签将变为活动标签。
返回值
一个 Promise
,它将被一个包含有关突出显示其标签的窗口详细信息的 windows.Window
对象实现。如果找不到窗口或出现其他错误,则承诺将被错误消息拒绝。
浏览器兼容性
BCD 表仅在浏览器中加载
注意: 此 API 基于 Chromium 的 chrome.tabs
API。此文档源自 Chromium 代码中的 tabs.json
。