tabs.highlight()

高亮(选择)一个或多个标签页。标签页通过窗口 ID 和标签索引范围指定。

这是一个异步函数,返回一个 Promise

语法

js
let highlighting = browser.tabs.highlight(
  highlightInfo         // object
)

参数

highlightInfo

object.

windowId 可选

integer. 包含标签页的窗口 ID。

populate 可选

boolean. 默认为 true。如果设置为 false,则 windows.Window 对象将不包含 tabs 属性,该属性包含代表窗口中打开的标签页的 tabs.Tab 对象列表。

注意: 如果有很多标签页,填充窗口(默认行为)可能是一项耗时的操作。为了获得更好的性能,建议当您不需要标签页详细信息时,手动将 populate 设置为 false

tabs

array of integer values. 指定要高亮的多个标签页索引。未包含在 tabs 中的先前已高亮的标签页将停止高亮。tabs 中的第一个标签页将成为活动标签页。

返回值

一个 Promise,它将使用一个 windows.Window 对象进行 fulfilled,该对象包含有关已高亮标签页的窗口的详细信息。如果找不到窗口或发生其他错误,Promise 将被拒绝并附带错误消息。

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.tabs API。本文档源自 Chromium 代码中的 tabs.json