Run Test Operation

Applies to TestComplete 15.64, last modified on June 12, 2024


Use the Run Test operation to run any test (or several tests) in your project from the given keyword test.

Operation Result

If the operation runs a test specified by the test name, it returns the same value that the called test returns. For information on how to obtain the result value, see Checking Operation Result.

If the operation runs a test or several tests by tags, it does not return any value.

Scripting Analogue

The operation is analogue to running a test from a script.

Child Operations

The operation cannot have child operations.

Operation Parameters

Specify operation parameters when adding the operation

When you add the operation to a keyword test, TestComplete shows the Select Test dialog where you select a test or a tag to run, or a [Tag expression].

If the selected test has parameters or if you have selected [Tag expression], TestComplete then shows the Operation Properties dialog, in which you can specify parameter values or the tag expression.

Tag expression syntax

Modify parameters

To change the test (or tag) to run, click the ellipsis button in the Operation column and select another test or tag in the resulting dialog.

To change the parameters of the called test (if any) or to change the tag expression, click the ellipsis button in the Value column and set the needed values.


  • You can also create the Run Test operation from the Project Explorer. To do this, drag the needed project item (a low-level procedure, network suite job or unit test) from the Project Explorer to the desired location in a keyword test that is open in the Keyword Test Editor.

  • Using the Run Test operation, you can implement recursive test execution. However, the recursive test execution may cause a stack overflow error. If the recursive test execution is part of your test plan, to avoid the error, think through your test run sequence ahead and use the If Then operation to allow or forbid recursive runs.

See Also

Test Actions Category
Specifying Operation Parameters
Checking Operation Result
Run Keyword Test Operation
Run Script Routine Operation

Highlight search results