Use breakpoints

Relevant for: GUI tests, scripted GUI components, function libraries, user code files, and business process tests

The following steps describe how to set breakpoints, and temporarily enable or disable them. After you finish using them, you can remove them from your document.

Set a breakpoint

To set a breakpoint, do one of the following:

  • Click in the left margin of a step in the document where you want the run to stop.

  • Select the line where you want the run to stop and select Run > Insert/Remove Breakpoint.

The breakpoint symbol is displayed in the left margin adjacent to the selected step.

Note:  

  • If you a run a test using the Run automation method, the test does not stop at breakpoints even if they are saved in the test.
  • If you run a test with breakpoints using the Run automation method, the breakpoints remain visible but are ignored during the test run.
  • If you are running a test from the ALM Test Lab module in hidden mode (as specified in the UFT Remote Agent, UFT will not stop the test at the breakpoints.
  • If you are running a test from the ALM Test Plan module not in hidden mode, the test stops at breakpoints if you select the Run Test Sets in debug mode option in the UFT Remote Agent

For details on Remote Agent settings, see Remote Agent Settings Dialog Box.

Back to top

Enable or disable a breakpoint

To enable/disable a specific breakpoint, do one of the following:

  • Right-click the step containing the breakpoint and select Enable/Disable Breakpoint.

  • In the Breakpoints Pane, select the breakpoint you want to enable or disable and press the Disable/enable breakpoint button .

Back to top

Enable or disable all breakpoints

To enable/disable all breakpoints, select Run > Enable/Disable All Breakpoints. If at least one breakpoint is enabled, UFT disables all breakpoints in the document. Alternatively, if all breakpoints are disabled, UFT enables them.

Back to top

Remove a single breakpoint or all breakpoints

To remove a single breakpoint, click the breakpoint icon in the left margin of the step. The breakpoint symbol is removed from the left margin of the document.

To remove all breakpoints, do one of the following:

  • Select Run > Clear All Breakpoints.

  • In the Breakpoints Pane, click the Remove all button or right-click and select Remove all.

All breakpoint symbols are removed from the left margin of the document.

Back to top

Navigate to a specific breakpoint

  1. In the Breakpoints Pane, select the specific breakpoint to which you want to navigate.

  2. Do one of the following:

    • Double-click the line containing the breakpoint name.

    • Click the Go to source button .

    • Right-click the line containing the breakpoint and select Go to Source.

  3. The cursor flashes in the main document window in the line containing the breakpoint.

    Back to top