For the complete documentation index, see llms.txt. This page is also available as Markdown.

Debugging Tools

Once Debug mode is active, you can pause and inspect your test executions in real time. Whether you're troubleshooting a failing step or verifying values mid-execution, the debugging tools helps you stay in control and fix issues faster.

Adding and Removing Breakpoints

Breakpoints allow you to pause the test at specific steps.

  • To set a breakpoint, click on the line number of any step in your test.

  • To remove a breakpoint, click the line number again.

This lets you pause test execution exactly where you want to inspect the test behaviour.

Pausing and Controlling Execution

When your test hits a breakpoint or when you pause it manually, you gain access to a set of controls:

  • Pause test

  • Resume test

  • Run current step and move to next

  • Run current step and stay on it

  • Skip current step

  • Stop

Debugging Tools and Information

Mapped Selectors

Shows how each step in your test is resolved into actual selectors during execution and how TestFirst identified elements on the page

Execution Log

You can also access the traditional execution log to review test steps, timing, and outcomes as before. It complements the debug log for full traceability.

Debug Log (Live View)

As your test runs, the debug log updates in real time, showing detailed execution data. This helps you trace the exact behaviour of your test.

Viewing Local Variables

When the test is paused, you can view all local variables and their values. This helps you understand what data is being passed and how your test logic is behaving at each step.

Last updated