One of the possible applications for capturing events is regular saving of the log to HDD to avoid the loss of results against unforeseen situations (blackouts, emergency TestComplete termination, and so on). This is particularly important in big projects, where there are many tests being executed and results being checked regularly.
In this recipe, we will consider how to store the log as each test completes.
To save the results after each test execution is over, it is necessary to perform the following steps:
- Create an event handle for the
OnStopTestevent. - Place the following code into the created handler:
Log.Event("Saving results to disk"); Log.SaveToDisk(); - Create several testing functions with any contents, for example:
function Test1() { Log.Message("Test 1"); } - Add these functions to test items (right-click on the name of the project, and navigate to Edit | Test Items). In the result, the listing of the tests will appear, as follows:
- Launch the whole project for execution by right-clicking on the name of the project and selecting the Run menu item.
In the result, a log will be instanced, thereby the results of each test execution will be saved to HDD (this is easy to verify by checking for the message at the end of each test):
Saving the log to HDD is possible at any given moment of time by invoking the Log.SaveToDisk method.
We are doing so at the end of each test, using the
OnStopTest event. Pay attention that the event is triggered at the end of each test and launched via test items. If you simply launch the function from which you call several tests, the event will fire just once (as each invoked function completes its call), rather than upon each invoked test. For example:
function TestAll()
{
Test1();
Test2();
// OnStopTest
}- More details about adding event handlers can be read about in the Creating event handlers recipe
- Creation of test items is thoroughly dealt with in the Creating a test plan for regular runs recipe in Chapter 4, Running Tests