Debugging a Test
|CloudTest debugging is performed by first applying one or more breakpoints via the Clip Editor and then subsequently using the Composition Editor’s Debug tab to play and step through the composition. Alternately, with your composition open in the Debug tab, click Load to display the test contents in the Composition Tree widget, and then click to navigate to the location where you'd like to add a breakpoint. Breakpoints can be added to items displayed in the Clip Editors Container.
While in Debug play mode, the Composition Tree presents the visual cues to correlate progress with specific clip elements in your test shown in the Clip Editors Container. The debugging widgets work together to show one synchronized debug view.
Once breakpoints are inserted the remaining debugging tasks take place in the Composition Editor, Debug tab. Breakpoints can be set ahead of time for any clip element that fails validation, is an error, or is a failure by checking one or more options in the Debug Options drop-down.
As debug play progresses, the orange “caret” bar progresses in the Composition List widget, while the corresponding clip element displays an orange caret that moves in tandem within the Clip Editors Container.
|Working with Breakpoints in the Clip Editor or Clip Editors Container
Breakpoints can be added, enabled and disabled in place, and removed using the following simple instructions.
Note: A breakpoint is different from a “stop” of a composition because there is no stop at the API level.
To add a breakpoint, right-click an item in the Clip Editor, List view and choose Add Breakpoint to insert the breakpoint at this place in the test.
|Or, right-click an item in the Icon view.|
|Expand a container in either view to apply a breakpoint to one of its children.|
|Once added, the Breakpoint icon appears enabled on the clip element’s surface in Icon view (and it appears next to the Scope icon in List view).|
|Toggle a Breakpoint On/Off
|Remove a Breakpoint
When playing in Debug mode the composition will stop at enabled breakpoints, as well as follow “steps” defined via the toolbar.
Note: The Status Log will indicate Debug mode when playing from this tab.
|Using Steps to Debug
Use the Step buttons on the toolbar to play one element at a time to skip over, go back, etc. as indicated by the button.
Step Into a Selection
Step Back to a Selection
Step Out of a Selection
Resuming after a Break
|Using Debug Widgets in a Custom DashboardCustom Debug dashboards can be created via the Debugging category in the Widget Type list of the Widget Selection Panel.|