Skip to main content
JavaScript debugger. Breakpoints: set (by url/scriptId or original source via source map; line 1-based; optional condition or logMessage), remove, enable, disable, list; exceptions (none|uncaught|all); dom (subtree-modified|attribute-modified|node-removed on a ref/selector); event (listener breakpoints, e.g. “click”); xhr (URL substring). Execution: pause, resume, stepInto, stepOver, stepOut, continueTo. Inspection while paused: stack (sync+async, mapped to original sources), scope (variables of frame/scope), variables (all scopes of a frame), evaluate/watch (expressions in a frame), setVariable. blackbox ignores library scripts while stepping.
The tool names stay the same across browsers. See browser selection and Firefox and Zen exceptions before choosing an operation.

Parameters

integer
Target tab id from browser_tabs, which lists tabs across all windows. Defaults to the agent’s most recently opened usable tab, or the only usable tab. Otherwise select a listed tabId.
enum
required
One of: list, set, remove, enable, disable, exceptions, dom, event, xhr, pause, resume, stepInto, stepOver, stepOut, continueTo, stack, scope, variables, evaluate, watch, setVariable, blackbox, breakOnAsync.
string
Script URL (exact or substring) for set/continueTo
string
 
string
Original source path (source-mapped) for set/continueTo
integer
1-based
integer
 
string
 
string
Logpoint: log this expression instead of pausing
string
 
boolean
 
enum
For exceptions One of: none, uncaught, all.
string
Element ref from browser_snapshot, e.g. “e12”
string
 
enum
One of: subtree-modified, attribute-modified, node-removed.
string
 
string
Optional event target interface, e.g. “xmlhttprequest”, “window”
string
For xhr breakpoints
boolean
For dom/event/xhr: remove instead of set
integer
 
integer
 
string
Variable name for setVariable
string
 
string[]
 
string[]
Blackbox regexes, e.g. [“node_modules”, “vendor\.js”]
integer
Range: 0 to 3.
integer
 
integer
For breakOnAsync: async stack depth (default 8)

Example

Conditional breakpoint in the original source
Break on uncaught exceptions
Break when a request URL contains /checkout
While paused: stack, then step