Articles

[Collapse]TestComplete/viewarticle/63445/
 [Expand]General Information/viewarticle/63445/
 [Expand]Using Help System/viewarticle/55799/
 [Expand]Getting Started Tutorial/viewarticle/56246/
 [Collapse]Using TestComplete/viewarticle/57875/
  [Collapse]TestComplete User Interface, Projects and Settings/viewarticle/57876/
   [Expand]TestComplete User Interface/viewarticle/57713/
   [Expand]Managing Projects, Project Suites and Project Items/viewarticle/57268/
   [Collapse]TestComplete Options and Settings/viewarticle/55050/
    [Expand]TestComplete Options/viewarticle/55441/
    [Collapse]Project Properties/viewarticle/55008/
      General Options/viewarticle/55121/
      CLR Bridge Options/viewarticle/55447/
      Debug Services Options/viewarticle/56439/
      Freeze Diagnostics Options/viewarticle/56438/
      Java Bridge Options/viewarticle/55572/
      Object Mapping Options/viewarticle/55262/
     [Expand]Open Applications Options/viewarticle/55209/
      Performance Counters Options/viewarticle/55783/
      Playback Options/viewarticle/55316/
      Visualizer Options/viewarticle/55131/
   [Expand]Settings Required to Use TestComplete/viewarticle/56257/
  [Expand]Creating, Recording and Running Tests/viewarticle/56646/
  [Expand]Test Results/viewarticle/55010/
  [Expand]Enhancing Tests/viewarticle/56964/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/57266/
  [Expand]Extending TestComplete/viewarticle/57655/
  [Expand]Automating TestComplete/viewarticle/57438/
  [Expand]Best Practices/viewarticle/64008/
 [Expand]Testing Types/viewarticle/62721/
 [Expand]Applications Testing/viewarticle/62606/
 [Expand]Working With Application Objects and Controls/viewarticle/55815/
 [Expand]Samples and Tutorials/viewarticle/56239/
 [Expand]References/viewarticle/57878/
 [Expand]Other Tools That Help You Test Better/viewarticle/63442/
 [Expand]TestComplete 10 Licensing Guide/viewarticle/63451/
Updated: 9/23/2014 Applies To: TestComplete 10 Rating: AverageAverageAverageAverageAverage 6 vote(s) Click to rate: PoorNot badAverageGoodExcellent
Project Properties

Project Properties - Playback Options

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 --

  • Runtime

    • Stop on error - If this option is enabled, test execution ends whenever an error message is posted to the test log.

      Note: Do not confuse this option with the Stop on error setting of test items. Using this setting, you can configure TestComplete to behave in a certain way when an error occurs during the test run. For more information, see Stopping Tests on Errors and Exceptions - Overview.
    • 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.

      Note: Do not confuse this option with the Stop on exception setting of test items. Using this setting, you can configure TestComplete to behave in a certain way when an exception occurs during the test run. For more information, see Stopping Tests on Errors and Exceptions - Overview.

      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 the Mouse Before Automated Testing 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.

    Note: The Key pressing delay, Dragging delay and Mouse movement delay options do not affect simulating user actions in mobile applications.

  • 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.

    Note: Handling unexpected windows does not work for windowless objects and for objects in mobile applications.
    • Ignore unexpected window - If this option is enabled, TestComplete simply ignores unexpected windows that occur during test run. At this, the Stop execution, Click on focused control, Press Esc, Press Enter and Send WM_CLOSE options will be simply ignored.
    • Stop execution - Ends the test run immediately.
    • Click on focused control - Simulates a mouse click on the control that has the focus within the unexpected window (it is often the OK button).
    • Press Esc - Simulates an Esc keystroke within the unexpected window (which should normally close it).
    • Press Enter - Simulates an Enter keystroke within the unexpected window.
    • Send WM_CLOSE - Sends the WM_CLOSE message to the unexpected window.

  • 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).

    Note: Handling overlapping windows does not work for windowless objects and for objects in mobile applications. See Handling Unexpected Windows for more information.

    The following option determines TestComplete’s behavior in such situations.

    • Ignore overlapping window - When the option is disabled, TestComplete posts an error to the log and stops the test execution. If this option is enabled, TestComplete performs user actions at recorded coordinates (ignoring windows that overlap the control to be clicked or dragged) and proceeds with the test execution.
      Note: Keep in mind that when the option is enabled, the actions may be simulated on the overlapping window instead of the desired window.

  • Log

    • 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.

      Note: The log saved during the test execution has the Incomplete status and is marked with a special icon. When the test execution is over, the incomplete log is replaced with a generic test log.
    • 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.

See also
Running Tests | Handling Unexpected Windows | Default Project Properties - Playback Options | Project Properties


© 2014 SmartBear Software. All rights reserved.
Email Send feedback on this document