Debug an automated test using breakpoints

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Pause a test to troubleshoot failures or unexpected behavior by adding a breakpoint for a particular test step.

    Avant de commencer

    Role required: admin

    Procédure

    1. Navigate to All > Automated Test Framework (ATF) > Tests.
    2. Select the test you want to run.
    3. Select Test Steps related list to list out all the test steps for the selected test.
    4. Right-click the test step where you want to add or remove a breakpoint.
    5. Select Add/Remove Breakpoint from the list.
      Image showing how to add a breakpoint
      The test step gets marked for the modified breakpoint.
      Remarque :
      The breakpoint mark on a step states that if the breakpoint is active and the test is run using Debug Test, the test pauses just before the breakpoint test step. The breakpoints are not considered if you click Run Test to run the test.

      The breakpoints you set on a test are user-specific. Other users can't see and modify your breakpoints on a test, and vice versa.

      Image showing multiple breakpoints
      Remarque :
      You can set multiple breakpoints for a test but can have only 1 breakpoint every test step.
    6. Facultatif : Click the Breakpoint related list to show all the test steps within a test that have breakpoints.
    7. Click Debug Test to run the test with breakpoints.
      The Debug Test modal displays.Image showing debug test modal
      • Safari – the browser used to run the client-side steps of the selected test
      • Pause before rollback – Option to pause the test just before rollback happens after the completion of the test
    8. Analyze and debug the steps at which breakpoints have been implemented.
      Image showing paused minutes and other options
      Remarque :
      Every breakpoint causes the running of the test to pause for 10 minutes. You can debug the test step within the allocated 10 minutes and then the test starts running again until it reaches the next breakpoint.
      The following options display only when the test is paused for a breakpoint:
      • Continue: Test execution continues until the next breakpoint.
      • Step over: Test pauses at every step. If you don’t want to pause in the current step, select the Step over option to jump to the next step.