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.