Forum Discussion

dhundley's avatar
Regular Contributor
3 years ago

event handler for OnStopTestCase

i'm having a bit of trouble understanding how the OnStopTestCase event handler gets triggered. I'm attaching a few screen shots to show how i think it should work. 


the execution plan screenshot shows that i have several "test items" (i.e keyword tests) but only one has the checkbox checked as a "test case"

the generate events screenshot shows that i have added the handler for OnStopTestCase

the javascript function show the top few lines of the script that i wrote for the event handler. as you can see i put several log messages at the top just to see what text gets put into the log but when my run ended i saw none of these messages anywhere as shown in the successful run messages screen shot.


am i looking in the wrong place for the messages? the script inside the IF statement that follows the log messages did not run at the end of the test case. do i need to use the sender parameter or something? also i tried using OnStopTest but that gets invoked after the end of every "test item" listed in the execution plan even though their "test case" checkbox is unchecked. this is not a script I want to run after every keyword test finishes. only when the parent "SignInOut" is complete. any and all help/suggestions appreciated. 




7 Replies

    • dhundley's avatar
      Regular Contributor

      i have been looking at both those articles for quite a while now and still not "getting" it. When i used testcomplete a couple of years ago (i could be wrong but) i don't remember there being an execution plan in the project with all those checkboxes. were "test cases" identified somehow differently in the past? in the article found at

      it doesn't even show the two handlers for test cases only for tests. is that article outdated because my testcomplete lists both of them under Test Engine Events. 

      The first linked article you posted says this about OnStopTestCase:


      Occurs when TestComplete stops running a test case:

      • When the execution of any project test item marked as a test case is stopped (regardless of whether you run individual test items or the entire project).

      Well, i have marked SignInOut as a test case in my execution plan. all the test items are children of it. i would think that when the last child completes the parent testcase is complete (stops running). 


      as for the second link in your reply aren't you still restricted to use only the event handlers that appear in the "available events" list? 


      Examples would really be helpful here. thanks!

      • Marsha_R's avatar
        Champion Level 3

        What version of TestComplete are you using?

    • dhundley's avatar
      Regular Contributor



      When you say "You can use that to create your own event handlers."


      are you suggesting that i can somehow create a javascript event handler that can be "added" to the list of existing event handlers (such as onstoptest, onstarttest, etc.) that appear under Events -> GeneralEvents and in the Available Events list of either General or Test Engine Events (as shown in the screen shot i attached named Generate Events.png)? if not, please elaborate on what you mean by creating my own event handlers and how that would work.