Home | Top | Free Ajax Editor | JavaScript Editor JavaScript EditorGet Advanced
JavaScript and Ajax Editor,
Validator and Debugger!

1st JavaScript Editor.

findText Method

Searches for text in the document and positions the start and end points of the range to encompass the search string.


bFound = TextRange .findText( sText [ , iSearchScope ] [ , iFlags ] )


sText Required. String  that specifies the text to find.
iSearchScope Optional. Integer  that specifies the number of characters to search from the starting point of the range. A positive integer indicates a forward search; a negative integer indicates a backward search.
iFlags Optional. Integer  that specifies one or more of the following flags to indicate the type of search:
0 Default. Match partial words.
1 Match backwards.
2 Match whole words only.
4 Match case.
131072 Match bytes.
536870912 Match diacritical marks.
1073741824 Match Kashida character.
2147483648 Match AlefHamza character.

Return Value

Boolean that returns one of the following values:

true The search text was found.
false The search text was not found.


A range has two distinct states: degenerate and nondegenerate.

A degenerate range is like a text editor caret (insertion point) —it does not actually select any characters. Instead, it specifies a point between two characters. The end points of a degenerate range are adjacent.

A nondegenerate range is like a text editor selection, in that it selects a certain amount of text. The end points of a nondegenerate range are not adjacent.

The value passed for the iSearchScope parameter controls the part of the document, relative to the range, that is searched. The behavior of the findText method depends on whether the state is degenerate or nondegenerate:

This feature might not be available on non-Microsoft® Win32® platforms.

A text range is not modified if the text specified for the findText method is not found.


This example creates a TextRange over the body of the document, and then uses the findText method to search for text with various flag combinations. The results are indicated in the example code comments.


Leonardo da Vinci was one of the great masters of the High Renaissance, especially in painting, sculpture, architecture, engineering, and science.
var oRange = document.body.createTextRange();
// record the current position in a bookmark
var sBookMark = oRange.getBookmark();
// true - case-insensitive and partial word match
oRange. findText ('leo');
// reset the range using the bookmark
// false - matches whole words only
oRange. findText ('engineer', 0, 2);
// false - case-sensitive
oRange. findText ('high', 0, 4);
// true - case-sensitive and matches whole words
oRange. findText ('Leonardo', 0, 6);
// the degenerate case
// make the range degenerate
// false - must specify large character count in this case
oRange. findText ('Leonardo', 0, 6);
// true - no third parameter passed, so no count needed
oRange. findText ('Leonardo');
// true - a large count covers the range
oRange. findText ('Leonardo', 1000000000, 6);

Standards Information

There is no public standard that applies to this method.

Applies To

[ Object Name ] Platform Version
Windows CE:
Home | Top | Free Ajax Editor | JavaScript Editor JavaScript EditorGet Advanced
JavaScript and Ajax Editor,
Validator and Debugger!

1st JavaScript Editor.