Window: find() method
Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.
Note:
Support for Window.find() might change in future
versions of Gecko. See Firefox bug 672395.
The Window.find() method finds a string in a window sequentially.
Syntax
find(string, caseSensitive, backwards, wrapAround, wholeWord, searchInFrames, showDialog)
Parameters
string-
The text string for which to search.
caseSensitive-
A boolean value. If
true, specifies a case-sensitive search. backwards-
A boolean value. If
true, specifies a backward search. wrapAround-
A boolean value. If
true, specifies a wrap around search. wholeWord-
A boolean value. If
true, specifies a whole word search. searchInFrames-
A boolean value. If
true, specifies a search in frames. showDialog-
A boolean value. If
true, a search dialog is shown.
Return value
true if the string is found; otherwise, false.
Examples
HTML
<p>Apples, Bananas, and Oranges.</p>
<button type="button" id="find-apples">Search for Apples</button>
<button type="button" id="find-bananas">Search for Bananas</button>
<button type="button" id="find-orange">Search for Orange</button>
<p id="output"></p>
JavaScript
function findString(text) {
document.querySelector("#output").textContent = `String found? ${window.find(
text,
)}`;
}
document.getElementById("find-apples").addEventListener("click", () => {
findString("Apples");
});
document.getElementById("find-bananas").addEventListener("click", () => {
findString("Bananas");
});
document.getElementById("find-orange").addEventListener("click", () => {
findString("Orange");
});
Result
Notes
In some browsers, Window.find() selects (highlights) the found content on
the site.
Specifications
This is not part of any specification.
Browser compatibility
| desktop | mobile | server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
find
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Non-standard. Check cross-browser support before using.