Script to Stop and close TestComplete or TestExecute

Nice, I am glad that worked for you.  Have a great day!  🙂

I ended up going with the option to user a PowerShell script. My normal script will run the PowerShell script and stop. This leaves TestComplete open but stopped. The PowerShell script pauses for 20 seconds (to ensure TestComplete has stopped) and then forces TestComplete to close. Not the most elegant, but it works.

Great thread — lots of solid tips already! 

Just to sum it up for anyone checking this out later: you can stop a test run with Runner.Stop() or Runner.Halt(), optionally close TestComplete (or TestExecute) using Sys.Process("TestComplete").Terminate() — or call a PowerShell script if you want a cleaner shutdown.

Here’s a quick example in JavaScript:

function checkConditionAndExit() {
  if (Project.Variables.MyFlag == true) {
    Log.Message("Condition met — stopping and closing TestComplete...");
    Runner.Stop(true);              // stop execution
  }
}

I’d still be careful with Terminate() — it’s basically the “pull the plug” option and can skip saving logs or logging out from license. If you’re running from the command line, the /exit flag is still the smoothest way to finish up. 

🤖 AI-assisted response
👍 Found it helpful? Click Like
✅ Issue resolved? Click Mark as Solution

Use Runner Object Methods, together with your /exit command-line paremeter. For example,

function loop()
{
    for (var i = 0; i < 100; i++) {
        if (i = 50) {
            Log.Message(`Stopping loop at ${i}`);
            Runner.Stop();
        }
    }
    Log.Message("This line is not called!");
}

ps... you can stop the script by logging an error (if your project setting are set to "Stop on Error") or you can do a runner.stop or a runner.halt to stop the test.  I would add this to a try catch using a throw to issue an error and hit the catch bypassing the rest of the script.


Runner.Stop Method
https://support.smartbear.com/testcomplete/docs/reference/project-objects/items/script/runner/stop.html?sbsearch=runner.stop

I forgot about the .close and .terminate methods.  If you can snag the TC process you may be able to use one of these methods.  The terminate method is the more risky of the two but may be the only way.  It just kills the process instead of asking politely to close properly.

Close Action (Process and Browser Objects)
https://support.smartbear.com/testcomplete/docs/reference/test-objects/members/window-and-process/close-action-process-object.html?sbsearch=process.terminate

 ✌️

Stopping the script is easy but closing TC requires a bit more thought.  Have you tried calling a PowerShell script in code your code, say from an error handler like try/catch or from an event?

Running PowerShell Scripts From TestComplete
https://support.smartbear.com/testcomplete/docs/testing-with/advanced/using-external-functions/running-powershell-scripts.html?sbsearch=Run%20a%20powershell

I'll post back it I find something else.

... If you find my posts helpful drop me a like! 👍 Be sure to mark or post the solution to help others out and/or to credit the one who helped you. 😎