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 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
[1] Supported in chrome code only.