com.teamdev.jxbrowser.search

Interface TextFinder

public interface TextFinder

Allows finding text on the loaded web page.

Method Summary

Modifier and Type	Method and Description
Browser	browser() Returns the Browser instance of this text finder.
void	find(java.lang.String text, java.util.function.Consumer<FindResult> consumer) Performs search of the given text, highlights all matches and selects the first match on the currently loaded web page.
void	find(java.lang.String text, FindOptions options, java.util.function.Consumer<FindResult> consumer) Performs search of the given text with the given options, highlights all matches and selects the first or the last (depending on the given FindOptions.isSearchBackward() flag) match on the currently loaded web page.
void	stopFindingAndClearSelection() Stops finding and clears the highlighting of the found matches.
void	stopFindingAndKeepSelection() Stops finding and keeps the currently highlighted match selected.

Method Detail

browser

Browser browser()

Returns the Browser instance of this text finder.

Since:

7.28

find

void find(java.lang.String text,
          java.util.function.Consumer<FindResult> consumer)

Performs search of the given text, highlights all matches and selects the first match on the currently loaded web page.

Subsequent calls of this method with the same text select the next match.

If this method is invoked after stopFindingAndKeepSelection() then the search will start from the last selected match, and if after stopFindingAndClearSelection() then the search will start from the first match.

If the search is still in progress, but the page content is already changed, then the search result will be displayed for the new content of the page (different number of matches, and the next selected match).

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters:

text - a text to search

consumer - a consumer object which allows obtaining the search result

Throws:

java.lang.IllegalArgumentException - when text is empty or blank

ObjectClosedException - when the browser is closed

find

void find(java.lang.String text,
          FindOptions options,
          java.util.function.Consumer<FindResult> consumer)

Performs search of the given text with the given options, highlights all matches and selects the first or the last (depending on the given FindOptions.isSearchBackward() flag) match on the currently loaded web page.

Subsequent calls of this method with the same text select the next or the previous match depending on the given FindOptions.isSearchBackward() flag.

If this method is invoked after stopFindingAndKeepSelection() then the search will start from the last selected match, and if after stopFindingAndClearSelection() then the search will start from the first or the last match depending on the given FindOptions.isSearchBackward() flag.

If the search is still in progress, but the page content is already changed, then the search result will be displayed for the new content of the page (different number of matches, and the next or the previous selected match).

The search is performed only through a visible content on the loaded web page. If some text is presented on the web page, but due to CSS rules it is not visible, the text finder will not check this content during search. Also, it does not find text on the web pages with an empty size, so make sure that the size of the browser instance where the text search is performed isn't empty.

Parameters:

text - a text to search

options - the parameters such as direction and match case

consumer - a consumer object which allows obtaining the search result

Throws:

java.lang.IllegalArgumentException - when text is empty

ObjectClosedException - when the browser is closed

stopFindingAndKeepSelection

void stopFindingAndKeepSelection()

Stops finding and keeps the currently highlighted match selected.

Throws:

ObjectClosedException - when the browser is closed

stopFindingAndClearSelection

void stopFindingAndClearSelection()

Stops finding and clears the highlighting of the found matches.

Throws:

ObjectClosedException - when the browser is closed