Skip to main content

Debugger

API for controlling the Playwright debugger. The debugger allows pausing script execution and inspecting the page. Obtain the debugger instance via browser_context.debugger.

Methods​

next​

Added in: v1.59 debugger.next

Resumes script execution and pauses again before the next action. Throws if the debugger is not paused.

Usage

debugger.next()

Returns

request_pause​

Added in: v1.59 debugger.request_pause

Configures the debugger to pause before the next action is executed.

Throws if the debugger is already paused. Use debugger.next() or debugger.run_to() to step while paused.

Note that page.pause() is equivalent to a "debugger" statement — it pauses execution at the call site immediately. On the contrary, debugger.request_pause() is equivalent to "pause on next statement" — it configures the debugger to pause before the next action is executed.

Usage

debugger.request_pause()

Returns

resume​

Added in: v1.59 debugger.resume

Resumes script execution. Throws if the debugger is not paused.

Usage

debugger.resume()

Returns

run_to​

Added in: v1.59 debugger.run_to

Resumes script execution and pauses when an action originates from the given source location. Throws if the debugger is not paused.

Usage

debugger.run_to(location)

Arguments

  • location Dict#

    • file str

    • line int (optional)

    • column int (optional)

    The source location to pause at.

Returns

Properties​

paused_details​

Added in: v1.59 debugger.paused_details

Returns details about the currently paused call. Returns null if the debugger is not paused.

Usage

debugger.paused_details

Returns

Events​

on("pausedstatechanged")​

Added in: v1.59 debugger.on("pausedstatechanged")

Emitted when the debugger pauses or resumes.

Usage

debugger.on("pausedstatechanged", handler)