Highlights (selects) one or more tabs. Tabs are specified using a window ID and a range of tab indices.
This is an asynchronous function that returns a
Promise
.
var highlighting = browser.tabs.highlight(
highlightInfo
// object
)
highlightInfo
对象
.
windowId
可选
integer
. ID of the window that contains the tabs.
populate
可选
boolean
。默认为
true
。若设为
false
,
windows.Window
object won't have a
tabs
property containing a list of
tabs.Tab
objects representing the tabs open in the window.
注意:
Populating the window (the default behavior) can be an expensive operation if there are lots of tabs. For better performance it's recommended to manually set
populate
to
false
if you don't need tab details.
tabs
array
of integer values specifying one or more tab indices to highlight. Previously highlighted tabs not included in
tabs
will stop being highlighted. The first tab in
tabs
will become active.
A
Promise
that will be fulfilled with a
windows.Window
object containing details about the window whose tabs were highlighted. If the window could not be found or some other error occurs, the promise will be rejected with an error message.
BCD tables only load in the browser
注意:
This API is based on Chromium's
chrome.tabs
API. This documentation is derived from
tabs.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改: , 由 MDN 贡献者