Window.find()

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.

Note:  Support for window.find() might change in future versions of Gecko . See bug 672395.

Summary

Finds a string in a window.

Syntax

window.find(aString, aCaseSensitive, aBackwards, aWrapAround,
            aWholeWord, aSearchInFrames, aShowDialog);
aString
The text string for which to search.
aCaseSensitive
Boolean value. If true, specifies a case-sensitive search.
aBackwards
Boolean. If true, specifies a backward search.
aWrapAround
Boolean. If true, specifies a wrap around search.
aWholeWord Unimplemented
Boolean. If true, specifies a whole word search. This is not implemented; see bug 481513.
aSearchInFrames
Boolean. If true, specifies a search in frames.

Returns

true if the string is found; otherwise, false.

Example

JavaScript

findString = function findText(text) {
  window.find(text);
  alert("String \x22" + text + "\x22 found? " + window.find(text));
}

HTML

<p>Apples, Bananas, and Oranges.</p>
<button type="button" onClick='findString("Apples")'>Search for Apples</button>
<button type="button" onClick='findString("Banana")'>Search for Banana</button>
<button type="button" onClick='findString("Borange")'>Search for Borange</button>

Result

Notes

--

Specification

This is not part of any specification.

Document Tags and Contributors

 Last updated by: chrisdavidmills,