HTMLIFrameElement.findAll()

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.

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

See also

• Using the Browser API