`waitFor`

The waitFor method waits for a new data stream from the host and for a match to occur.

This method works like the wait method, but expects a match. If the match doesn’t occur, it waits for a new change or times out.

If there are two or more matches defined, waitFor selects the best match and calls the associated callback function.

Call Parameters (mode 1)

Parameter name	Parameter type	Explanation
match	String or RegExp	Represents the value to match in the received stream.
success	function	Callback to be called when the match occurs.
fail	function	Callback to be called when the match fails.
timeout	integer	Time to wait for the match, in milliseconds.

Parameter name	Parameter type	Explanation
matches	Javascript object array	An array containing a set of matching objects.
fail	function	Callback to be called when the match fails.
timeout	integer	Time to wait for the match, in milliseconds.

Parameter name	Parameter type	Explanation
match	String or RegExp	Represents the value to match in the received stream.
function	function	Callback to be called when the match occurs.

This function does not return any object.