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 会以错误信息拒绝。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
highlight
populate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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