mozbrowserfindchange

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The mozbrowserfindchange event is fired when a search method is invoked in the browser <iframe> content.

This includes HTMLIFrameElement.findAll(), HTMLIFrameElement.findNext(), and HTMLIFrameElement.clearMatch().

General info

Specification
Non standard
Interface
CustomEvent
Bubbles
Yes
Cancelable
Yes
Target
<iframe>
Default Action
None

Properties

Property Type Description
target Read only EventTarget The browser iframe
type Read only DOMString The type of event.
bubbles Read only Boolean Whether the event normally bubbles or not.
cancelable Read only Boolean Whether the event is cancellable or not.
details Read only Object A custom object.

details

The details property returns an anonymous JavaScript object with the following properties:

active
A Boolean indicating whether a search is currently active (true), or not (false.)
searchString
A DOMString representing the string that is currently being searched for.
searchLimit
A number indicating the maximum number of searches that can be returned.
numberOfMatches
A number indicating the number of matches returned by the search.
activeMatchOrdinal
A number indicating the position of the currently highlighted search result, e.g. 3 out of 5.

Example

var browser = document.querySelector("iframe");

browser.addEventListener("mozbrowserfindchange", function(event) {
  console.log("Currently highlighted: " + event.details.activeMatchOrdinal +
              " out of " + event.details.numberOfMatches);
});

See also