Alert Method (Page Objects)

Applies to TestComplete 15.63, last modified on April 10, 2024


Use the Alert method to get access to an alert that a tested web page shows using the JavaScript alert function. To learn more, see Handle JavaScript Popups and Browser Dialogs.



TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Result An Alert object

Applies To

The method is applied to the following object:

View Mode

To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.

Result Value

The Alert object that corresponds to an alert that the web page is showing.

If the page is not showing any alerts, the method will return a stub object and post an error message to the test log. If the Error handling > On error or the Error handling > On object recognition error property is set to Stop current item or Stop project, TestComplete will stop the test run when the error is posted to the test log.


To avoid errors when accessing the alert, you can use the WaitAlert method. Then, use the Exists property of the returned object to check whether it is a stub object or an actual Alert object.

See Also

WaitAlert Method (Page Objects)
Handle JavaScript Popups and Browser Dialogs

Highlight search results