View as markdown
Copy for LLM Open in ChatGPT Open in Claude Open in Perplexity

DOMDebugger

DOM debugging allows setting breakpoints on particular DOM operations and events. JavaScript execution will stop on these operations as if there was a regular breakpoint set.

Dependencies: DOM, Runtime

Commands

DOMDebugger.getEventListeners

Returns event listeners of the given object.

Parameters
Name Type Description
objectId Runtime.RemoteObjectId Identifier of the object to return listeners for.
depth (optional) integer The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the
entire subtree or provide an integer larger than 0.
pierce (optional) boolean Whether or not iframes and shadow roots should be traversed when returning the subtree
(default is false). Reports listeners for all contexts if pierce is enabled.
Return Object
Name Type Description
listeners array<EventListener> Array of relevant listeners.

DOMDebugger.removeDOMBreakpoint

Removes DOM breakpoint that was set using `setDOMBreakpoint`.

Parameters
Name Type Description
nodeId DOM.NodeId Identifier of the node to remove breakpoint from.
type DOMBreakpointType Type of the breakpoint to remove.

DOMDebugger.removeEventListenerBreakpoint

Removes breakpoint on particular DOM event.

Parameters
Name Type Description
eventName string Event name.
targetName (optional) Experimental string EventTarget interface name.

DOMDebugger.removeInstrumentationBreakpoint

Experimental Deprecated

Removes breakpoint on particular native event.

Redirects to: EventBreakpoints

Parameters
Name Type Description
eventName string Instrumentation name to stop on.

DOMDebugger.removeXHRBreakpoint

Removes breakpoint from XMLHttpRequest.

Parameters
Name Type Description
url string Resource URL substring.

DOMDebugger.setBreakOnCSPViolation

Experimental

Sets breakpoint on particular CSP violations.

Parameters
Name Type Description
violationTypes array<CSPViolationType> CSP Violations to stop upon.

DOMDebugger.setDOMBreakpoint

Sets breakpoint on particular operation with DOM.

Parameters
Name Type Description
nodeId DOM.NodeId Identifier of the node to set breakpoint on.
type DOMBreakpointType Type of the operation to stop upon.

DOMDebugger.setEventListenerBreakpoint

Sets breakpoint on particular DOM event.

Parameters
Name Type Description
eventName string DOM Event name to stop on (any DOM event will do).
targetName (optional) Experimental string EventTarget interface name to stop on. If equal to `"*"` or not provided, will stop on any
EventTarget.

DOMDebugger.setInstrumentationBreakpoint

Experimental Deprecated

Sets breakpoint on particular native event.

Redirects to: EventBreakpoints

Parameters
Name Type Description
eventName string Instrumentation name to stop on.

DOMDebugger.setXHRBreakpoint

Sets breakpoint on XMLHttpRequest.

Parameters
Name Type Description
url string Resource URL substring. All XHRs having this substring in the URL will get stopped upon.

Types

DOMBreakpointType

(string)

DOM breakpoint type.

Allowed Values
  • subtree-modified
  • attribute-modified
  • node-removed

CSPViolationType

(string) Experimental

CSP Violation type.

Allowed Values
  • trustedtype-sink-violation
  • trustedtype-policy-violation

EventListener

(object)

Object event listener.

Properties
Name Type Description
type string `EventListener`'s type.
useCapture boolean `EventListener`'s useCapture.
passive boolean `EventListener`'s passive flag.
once boolean `EventListener`'s once flag.
scriptId Runtime.ScriptId Script id of the handler code.
lineNumber integer Line number in the script (0-based).
columnNumber integer Column number in the script (0-based).
handler (optional) Runtime.RemoteObject Event handler function value.
originalHandler (optional) Runtime.RemoteObject Event original handler function value.
backendNodeId (optional) DOM.BackendNodeId Node the listener is added to (if any).

Summary