Errors that occur during the test run can be caused by accidental reasons. Such errors can occur a few times, and you may not want to interrupt your tests because of them. However, if a number of errors exceeds some limit, it will mean that something goes wrong and the test item should be stopped.

To configure your project to stop a test item when an error limit is reached and proceed with the next sibling test item:

Note: The approach we describe uses the Log.ErrCount property that returns the number of errors that are posted during the current test item. To get the number of errors occurred during the entire project run, create and use a project variable as an error counter. To learn more about this approach, see Stop Project Run on the N-th Error.

If your project does not have the Events collection, add it:

Add an event control to the Events collection and create a handler for the OnLogError event:
Configure the event handler to compare the number of occurred errors with the number of “allowed” errors and stop the test item, if needed.
- If you use scripts
  
  Add the following code to the event handling routine:
  
  Show Code
  Show CodeHide Code
  In the following code snippets, 5 is the maximum number of “allowed” errors.
  JavaScript, JScript
  
  Python
  
  VBScript
  
  DelphiScript
  
  C++Script, C#Script
  JavaScript, JScript
  
  function GeneralEvents_OnLogError(Sender, LogParams)
  {
    if (Log.ErrCount >= 5)
    {
      Runner.Stop(true);
    }
  }
  
  Python
  
  def GeneralEvents_OnLogError(Sender, LogParams): if Log.ErrCount >= 5: Runner.Stop(True)
  
  VBScript
  
  Sub GeneralEvents_OnLogError(Sender, LogParams)
    If (Log.ErrCount >= 5) Then
       Runner.Stop(True)
    End If
  End Sub
  
  DelphiScript
  
  procedure GeneralEvents_OnLogError(Sender; LogParams);
  begin
    if (Log.ErrCount >= 5) then
    begin
      Runner.Stop(true);
    end;
  end;
  
  C++Script, C#Script
  
  function GeneralEvents_OnLogError(Sender, LogParams)
  {
    if (Log["ErrCount"] >= 5)
    {
      Runner["Stop"](true);
    }
  }
  Specify true as the parameter for the Stop method. Otherwise, it will stop the entire test run.
- If you use keyword tests
  
  Show Instructions
  Show InstructionsHide Instructions
  1. Add the If... Then operation to the event handling keyword test.
  2. Specify the Log.ErrCount code expression for Value1:
  3. Select Greater than or equal to from the Condition drop-down list.
  4. Specify the number of “allowed” in Value2:
  5. Add the Stop Execution operation as a child of the If... Then operation.
  6. In the Stop Execution properties, select the Stop current test only check box, to stop only the current test item.
    
    To avoid recursive calling, make sure that the Error Message text box is empty.
Open the Test Items page of the project editor and make sure that the On error property of all your test items are set to Continue running. Otherwise, TestComplete will stop the entire test run on the first error.

The Runner.Stop(true) script method and the Stop Execution operation stop the test item even if you set On error to Continue running. TestComplete will not run the test item’s further iterations and child test items.

Stop Current Test Item on the N-th Error

See Also