Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
mohamedkhallouq
GitHub Repository: mohamedkhallouq/content
 Path: blob/main/files/en-us/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md
6566 views
---
title: tabs.onHighlightChanged
slug: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged
page-type: webextension-api-event
tags:
  - API
  - Add-ons
  - Deprecated
  - Event
  - Extensions
  - Non-standard
  - Reference
  - WebExtensions
  - onHighlightChanged
  - tabs
browser-compat: webextensions.api.tabs.onHighlightChanged
---

{{AddonSidebar()}}

Warning: This event is deprecated. Use {{WebExtAPIRef("tabs.onHighlighted")}} instead.

Fired when the highlighted or selected tabs in a window changes.

Syntax

browser.tabs.onHighlightChanged.addListener(listener)
browser.tabs.onHighlightChanged.removeListener(listener)
browser.tabs.onHighlightChanged.hasListener(listener)

Events have three functions:

  • addListener(callback)

    • : Adds a listener to this event.

  • removeListener(listener)

    • : Stop listening to this event. The listener argument is the listener to remove.

  • hasListener(listener)

    • : Check whether listener is registered for this event. Returns true if it is listening, false otherwise.

addListener syntax

Parameters

  • callback

    • : Function that will be called when this event occurs. The function will be passed the following arguments:

      • selectInfo

        • : object. See the selectInfo section for more details.

Additional objects

selectInfo

  • windowId

    • : integer. The window whose tabs changed.

  • tabIds

    • : array of integer. All highlighted tabs in the window.

Browser compatibility

{{Compat}}

Note: This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.