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