Browser.WaitBrowserWindow method instructs TestComplete to wait until the specified browser window exists in the system or until the timeout is reached.
You typically use this method in combination with the
Exists property to check if a specific browser window exists. See Checking Whether an Object Exists.
|TestObj||A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section|
|Timeout||[in]||Optional||Integer||Default value: 0|
The method is applied to the following object:
To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.
The method has the following parameters:
A zero-based index of the browser window among all windows opened in the browser. The first browser window has the index of 0, the second - 1, and so on.
The time, in milliseconds, to wait for the browser window to become available. If Timeout is 0, the method searches for the specified browser window once and then returns immediately. If Timeout is -1, the waiting time is infinite.
If the specified browser window was found, the method returns the corresponding
If the browser window was not found during the timeout, the method returns a stub object with the
Exists property equal to False. So, you can check the
Exists property of the returned object to see whether the browser window was found.
WaitBrowserWindow does not post an error message to the test log if the specified browser window was not found. To check whether the browser window was found, examine the
Exists property of the returned object.
Classic Web Testing
Understanding Web Object Identification and Object Models
Checking Whether an Object Exists
Waiting for an Object, Process or Window Activation