Stopping Project Run After the N-th Error

Some errors can be caused by accidentally reasons. Such errors can occur a few times during the project run, and you may want not to stop the test because of them. But, if a number of errors exceeds some limit, it will mean that something goes wrong, and the current project must be stopped. This topic describes how you can stop the entire project run when the specific number of errors occurs. To do this, perform the steps below.

1. Open the project properties and select Playback on the list on the left of the page. Disable the Stop on error and Error dialog options. Otherwise, TestComplete stops the entire test run right after the first error or exception occurs.

   

2. Open the Variables page of the project editor and create an integer variable. Let’s call this variable ErrorCounter. It will store the number of errors occurred during the project run.

   

3. Create the OnLogError event handler (to learn how to do this, see Creating Event Handlers for TestComplete Events). This event handler will be used to count every error that is posted to the test log during the test run.

4. In the event handler, create test commands that will increase the project variable, and when it reaches the limit, stop the current test item. To do this:

   • If you use scripts, insert the following code into the event handling routine:

     Show Code

     Show CodeHide Code

     In the following code snippet, 5 is the maximum number of “allowed” errors.

     JavaScript, JScript

     Python

     VBScript

     DelphiScript

     C++Script, C#Script

     JavaScript, JScript

     function GeneralEvents_OnLogError(Sender, LogParams)
     {
       Project.Variables.ErrorCounter++;
       if (Project.Variables.ErrorCounter >= 5)
        {
            Runner.Stop(true);
        }
     }

     Python

     def GeneralEvents_OnLogError(Sender, LogParams):
       Project.Variables.ErrorCounter+=1
       if Project.Variables.ErrorCounter >= 5: 
            Runner.Stop(True)

     VBScript

     Sub GeneralEvents_OnLogError(Sender, LogParams)
       Project.Variables.ErrorCounter = Project.Variables.ErrorCounter + 1
       If (Project.Variables.ErrorCounter >= 5) Then
          Runner.Stop(True)
       End If
     End Sub

     DelphiScript

     procedure GeneralEvents_OnLogError(Sender; LogParams);
     begin
       Project.Variables.ErrorCounter := Project.Variables.ErrorCounter + 1;
       if (Project.Variables.ErrorCounter >= 5) then
       begin
          Runner.Stop(true);
       end;
     end;

     C++Script, C#Script

     function GeneralEvents_OnLogError(Sender, LogParams)
     {
       Project["Variables"]["ErrorCounter"]++;
       if (Project["Variables"]["ErrorCounter"] >= 5)
        {
            Runner["Stop"](true);
        }
     }

     Note that it is important to specify true as the parameter for the Stop method. Otherwise, it will stop the entire test run.

   • If you use keyword tests, do the following:

     Show Instructions

     Show InstructionsHide Instructions

     • Add the If... Then operation to the event handling keyword test. Specify the created variable for Value1, select Greater than or equal to from the Condition drop-down list and specify the limit of the errors for Value2.

       

     • Add the Stop Execution operation as a child of the If... Then operation.

       

     • In the Stop Execution properties, select the Stop current test only check box, to stop only the current test item. Otherwise, TestComplete stops the entire test run.

       

       Important: To avoid recursive calling, make sure that the Error Message text box is empty.

5. Open the Test Items page of the project editor and set the Stop on Error property of all your test items to Project. It allows you to stop the entire project when the test item is stopped.

   

6. Open the Test Items page of the project suite editor and disable the Stop on Error property of the current project. Otherwise, TestComplete will stop the project suite.

   

See Also

Controlling Test Execution Flow
Stopping Tests on Errors and Exceptions - Overview
OnLogError Event
Runner.Stop Method
Stop Execution Operation