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.