onSelectionChanged

{{AddonSidebar}} 

Fires when the user selects a different page element for inspection with the browser’s developer tools, for example by selecting the “Inspect Element” context menu item in Firefox.

Syntax

browser.devtools.panels.elements.onSelectionChanged.addListener(listener)
browser.devtools.panels.elements.onSelectionChanged.removeListener(listener)
browser.devtools.panels.elements.onSelectionChanged.hasListener(listener)

Events have three functions:

• addListener(listener)
  • : 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

• listener
  • : The function called when this event occurs. The function is passed no arguments.

Browser compatibility

{{Compat}} 

Examples

Listen for selection changed events, and log the text content of the newly selected element:

function handleSelectedElement() {
  browser.devtools.inspectedWindow.eval("$0.textContent").then((result) => {
    console.log(result[0]);
  });
}

browser.devtools.panels.elements.onSelectionChanged.addListener(
  handleSelectedElement,
);

{{WebExtExamples}} 

[!NOTE] This API is based on Chromium’s chrome.devtools API.