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