The Playback options let you specify how TestComplete should process some situations that occur during the test execution.
To view or modify playback options:
Open the Properties page of the project editor and then choose Playback in the list on the left of the page.
You can change the following options --
Stop on error - If this option is enabled, test execution ends whenever an error message is posted to the test log.
Stop on warning - If it is enabled, test execution ends whenever a warning message is posted to the test log.
Stop on window recognition error - Not counting Auto-wait timeout cases, a test at any point may refer to an object that is not available in the system. If the Stop on window recognition error option is enabled, the test run will end whenever TestComplete fails to find a window object specified via the Process.Window, Window.Window, Process.WaitWindow or Window.WaitWindow method. If the option is disabled, TestComplete will simply continue, ignoring the failure.
Error dialog - If the option is enabled and an error is encountered during playback, TestComplete displays a dialog informing you about the error. If the option is disabled, TestComplete continues the test execution without showing information about the error.
The functionality of the dialog is sometimes a little different: In most cases, the dialog describes the occurred error and asks you whether to continue the test execution or stop the test. However, during execution of scripts written in VBScript, JScript, C++Script or C#Script, the dialog only informs you about the error without suggesting to abort the test execution.
Minimize TestComplete - If the option is enabled TestComplete minimizes before the test playback. This stops TestComplete from overlapping the tested applications’ windows.
Use case-sensitive parameters - Sets whether methods that simulate user actions (ClickItem, DblClickItem, SelectItem, etc.) will process their string parameters as case-sensitive. These methods belong to objects that correspond to various controls supported by TestComplete (for instance, Win32ListView).
Count processes of all users - If this option is enabled when launching the tested application, TestComplete will count all instances of the tested application running under different accounts. If the number of instances exceed the Count property of the tested application, new instance will not be launched. If this option is disabled, TestComplete will only count processes of the user for the account that the application is to be launched under. For more information on testing applications under different accounts, see Testing Applications Running Under Another User Account).
Disable mouse - If this option is enabled, the test engine disables the mouse when the test starts. That is, mouse movements will not cause the mouse cursor to move on the screen. This functionality lets you ensure that human intervention will not affect the simulated user actions during the test. The mouse is enabled after the test is over or if you press Ctrl-Alt-Del. See Disabling Mouse Events During Test Execution for more information.
Auto-wait timeout, ms - Default: 10000. When a test acquires a reference to a process or window object, or when it activates an object (for example, opening a minimized window), the object may not be available immediately. Likewise, when a test commands a change in the onscreen state of a window (e.g. minimizing an open window), or when TestComplete attempts to close an unexpected window, the change may not occur instantaneously. Auto-wait timeout is the number of milliseconds allowed for the object to become available, or for the desired change to occur, before a timeout error message is posted to the test log. If the object becomes available or the desired change occurs within the delay allowed, the test proceeds immediately. If the timeout elapses, what happens after the error is posted is determined by the Stop on Error option.
Auto-wait timeout affects the following test methods that return references to new objects:
Delay between events, ms - Milliseconds to wait after the test simulates any user action (click, keystroke, window command, and so on) during playback. The default is 0; any positive integer can be specified to slow down test execution.
Key pressing delay, ms - Milliseconds to wait after each keystroke event is simulated by the test. Valid values range between 0 and 1000. 0 is the default.
Dragging delay, ms - Milliseconds it takes the mouse cursor to pass 20 pixels while performing a dragging operation during test playback. Valid values range between 0 and 1000. 5 is the default.
Mouse movement delay, ms - Milliseconds it takes the mouse cursor to pass 20 pixels during test playback. Valid values range between 0 and 1000. 0 is the default.
On unexpected window - The following options specify how TestComplete should respond to an unexpected window (for instance, an error window from the application). See Handling Unexpected Windows.
On overlapping window - Such an event occurs when one or several windows are in front of the window addressed by the test. By default, TestComplete tries to bring focus to the desired window. However, some overlapping windows cannot be sent to the background (for instance, when the window is modal or has the "Always on top" attribute).
The following option determines TestComplete’s behavior in such situations.
Recreate objects after test stops - A test project may include the ActiveXObjects project item that contains ActiveX objects used in tests. The Recreate objects after test stops setting specifies how the test engine manages these objects. If the setting is enabled, TestComplete stores the initial state of an object, recreates the object after the test run is over and initializes the object’s properties with the stored values. Thus, the changes made to the object during testing are discarded. If the setting is disabled, TestComplete preserves the changes made to the ActiveX object during the test run.
Enabling the option allows you to improve the test stability, as on every test run the objects will be initialized anew. However, if object alterations are important, disable the setting. You should also do this if you release the ActiveX object in your test.
Post image on error - Specifies whether the test engine will post a desktop screenshot to the test log when an error occurs. This option also affects the Log.Error method. If you don’t pass any image as a parameter to this method, and if the option is enabled, the method will post a desktop image to the test log. If the property is disabled, no image will be posted.
Save log every … minutes - Specifies the time interval, in minutes, in which TestComplete automatically saves test results when a script is being executed. This protects the test log against a crash or power outage. If the option is 0, the auto-save functionality is disabled.
Store last … events - Specifies the number of the last event messages that must be posted to the test log before an error message is posted to the log. 0 means that all event messages must be stored.
Use this option to remove unnecessary event messages from the log and reduce its overall size.
The default values of the Playback settings that will be used in new TestComplete projects are specified by the Default Project Properties - Playback Options dialog.
© 2012 SmartBear Software. All rights reserved.