HTMLIFrameElement.findAll()

Warning: Removed in Firefox 65.

The findAll() method of the HTMLIFrameElement searches for a string in a browser <iframe>'s text content; if found, the first instance of the string relative to the caret position will be highlighted.

Invoking this method results in a mozbrowserfindchange event firing, which carries details about the search results.

Note: Use of the Browser API requires a privileged app, and browser and/or embed-apps permissions, depending on what you want to do. See Using the Browser API for more details.

Syntax

instanceOfHTMLIframeElement.findAll(searchString, caseSensitivity);

Returns

Void.

Parameters

searchString: The string you want to search for in the browser <iframe>'s text.
caseSensitivity: A string to declare whether you want the search to be case sensitive (case-sensitive) or insensitive (case-insensitive.)

Example

The following function is taken from our Browser API demo, and executes a search when a search form is submitted. See Implementing the search bar for more explanation.

searchForm.addEventListener('submit', function(e) {
  e.preventDefault();
  browser.findAll(searchBar.value, 'case-sensitive');
  searchActive = true;
  prev.disabled = false;
  next.disabled = false;
  searchBar.blur();
});

Specification

Not part of any specification.

Browser compatibility

Supported since Firefox 47, in chrome code only. Removed completely in Firefox 65.

Unlikely ever to be supported in other browsers.