> For the complete documentation index, see [llms.txt](https://docs.testfirst.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testfirst.com/testfirst-editor/running-and-debugging-tests/debugging-tools.md).

# 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.&#x20;

### **Adding and Removing Breakpoints** <a href="#h_01jsnp0n9z8n7e1bqmtgsk5ph2" id="h_01jsnp0n9z8n7e1bqmtgsk5ph2"></a>

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** <a href="#h_01jsnp1ayzgqaxrszk94e61bms" id="h_01jsnp1ayzgqaxrszk94e61bms"></a>

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

* **Pause test**&#x20;
* **Resume test**&#x20;
* **Run current step and move to next**&#x20;
* **Run current step and stay on it**&#x20;
* **Skip current step**&#x20;
* **Stop**&#x20;

### **Debugging Tools and Information** <a href="#h_01jsnppejm6pkbxgh28jmvqze2" id="h_01jsnppejm6pkbxgh28jmvqze2"></a>

#### **Mapped Selectors**  <a href="#h_01jsnppejm46k1wksj677mnphh" id="h_01jsnppejm46k1wksj677mnphh"></a>

<figure><img src="/files/LgD6J2yTb1e51w1eMYOy" alt=""><figcaption></figcaption></figure>

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

#### **Execution Log** <a href="#h_01jsnppejm46k1wksj677mnphh" id="h_01jsnppejm46k1wksj677mnphh"></a>

<figure><img src="/files/woJu2LBlIhRYW24zT38E" alt=""><figcaption></figcaption></figure>

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)** <a href="#h_01jsnppejmga1ey0tnd4dqzyv8" id="h_01jsnppejmga1ey0tnd4dqzyv8"></a>

<figure><img src="/files/K7FrfTILAgXSFFj6eWOH" alt=""><figcaption></figcaption></figure>

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.\ <br>

#### **Viewing Local Variables** <a href="#h_01jsnppejmqe392cx9q5v5rcry" id="h_01jsnppejmqe392cx9q5v5rcry"></a>

<figure><img src="/files/Mt1h6ingAIRF4ph5cZbp" alt=""><figcaption></figcaption></figure>

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

&#x20;
