Debugger Domain - DevTools Protocol Version 0.2 (EdgeHTML)
Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing breakpoints, stepping through execution, exploring stack traces, etc.
Enables debugger for the given page. Clients should not assume that the debugging has been enabled until the result for this command is received.
Disables debugger for given page.
Returns possible locations for breakpoint. scriptId in start and end range locations should be the same.
Parameters | Type | Details |
---|---|---|
start | Location | Start of range to search possible breakpoint locations in. |
end | Location | End of range to search possible breakpoint locations in (excluding). When not specified, end of scripts is used as end of range. |
Returns | Type | Details |
---|---|---|
locations | BreakLocation | List of the possible breakpoint locations. |
Activates / deactivates all breakpoints on the page.
Parameters | Type | Details |
---|---|---|
active | boolean |
New value for breakpoints active state. |
Sets JavaScript breakpoint at given location specified either by URL or URL regex. Once this command is issued, all existing parsed scripts will have breakpoints resolved and returned in locations
property. Further matching script parsing will result in subsequent breakpointResolved
events issued. This logical breakpoint will survive page reloads.
Parameters | Type | Details |
---|---|---|
lineNumber | integer |
Line number to set breakpoint at. |
url (optional) | string |
URL of the resources to set breakpoint on. |
urlRegex (optional) | string |
Regex pattern for the URLs of the resources to set breakpoints on. Either url or urlRegex must be specified. |
columnNumber (optional) | integer |
Offset in the line to set breakpoint at. |
condition (optional) | string |
Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true. |
Returns | Type | Details |
---|---|---|
breakpointId | BreakpointId | ID of the created breakpoint for further reference. |
locations | Location[] | List of the locations this breakpoint resolved into upon addition. |
Sets JavaScript breakpoint at a given location.
Parameters | Type | Details |
---|---|---|
location | Location | Location to set breakpoint in. |
condition (optional) | string |
Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true. |
Returns | Type | Details |
---|---|---|
breakpointId | BreakpointId | ID of the created breakpoint for further reference. |
actualLocation | Location | Location this breakpoint resolved into. |
Removes JavaScript breakpoint.
Parameters | Type | Details |
---|---|---|
breakpointId | BreakpointId |
Steps over the statement.
Steps into the function call.
Steps out of the function call.
Stops on the next JavaScript statement.
Resumes JavaScript execution.
Returns source for the script with given id.
Parameters | Type | Details |
---|---|---|
scriptId | Runtime.ScriptId | ID of the script to get source for. |
Returns | Type | Details |
---|---|---|
scriptSource | string |
Script source. |
Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions or no exceptions. Initial pause on exceptions state is none
.
Parameters | Type | Details |
---|---|---|
state | string |
Pause on exceptions mode. Allowed values: none , uncaught , all |
Evaluates expression on a given call frame.
Parameters | Type | Details |
---|---|---|
callFrameId | CallFrameId | Call frame identifier to evaluate on. |
expression | string |
Expression to evaluate. |
Returns | Type | Details |
---|---|---|
result | Runtime.RemoteObject | Object wrapper for the evaluation result. |
Changes value of variable in a callframe. Object-based scopes are not supported and must be mutated manually.
Parameters | Type | Details |
---|---|---|
scopeNumber | integer |
0-based number of scope as was listed in scope chain. Only local , closure , and catch scope types are allowed. Other scopes could be manipulated manually. |
variableName | string |
Variable name. |
newValue | Runtime.CallArgument | New variable value. |
callFrameId | CallFrameId | ID of callframe that holds variable. |
Experimental. Replace previous blackbox patterns with passed ones. Forces backend to skip stepping/pausing in scripts with url matching one of the patterns. The debugger will try to leave blackboxed script by performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
Parameters | Type | Details |
---|---|---|
patterns | string[] |
Array of regexps that will be used to check script url for blackbox state. |
Experimental. Microsoft: Sets the specified debugger property to the specified value.
Parameters | Type | Details |
---|---|---|
debuggerPropertyId | string | Microsoft: The property id (i.e. msDebuggerPropertyId ) to set. |
newValue | string |
Fired when the script is parsed. This event is also fired for all known and uncollected scripts upon enabling debugger.
Parameters | Type | Details |
---|---|---|
scriptId | Runtime.ScriptId | Identifier of the script parsed. |
url | string |
URL or name of the script parsed (if any). |
startLine | integer |
Line offset of the script within the resource with given URL (for script tags). |
startColumn | integer |
Column offset of the script within the resource with given URL. |
endLine | integer |
Last line of the script. |
endColumn | integer |
Length of the last line of the script. |
executionContextId | Runtime.ExecutionContextId | Specifies script creation context. |
sourceMapURL (optional) | string |
URL of source map associated with script (if any). |
length (optional) | integer |
Experimental. This script length. |
msParentId (optional) | string |
Experimental. This is the parent document ID. |
msMimeType (optional) | string |
Experimental. This is the mime type. |
msIsDynamicCode (optional) | boolean |
Experimental. This indicates whether it is dynamic code. |
msLongDocumentId (optional) | integer |
Experimental. This is the long document ID. |
Fired when breakpoint is resolved to an actual script and location.
Parameters | Type | Details |
---|---|---|
breakpointId | BreakpointId | Breakpoint unique identifier. |
location | Location | Actual breakpoint location. |
msLength (optional) | integer |
Experimental. Microsoft: Length of code (i.e. number of characters) at the breakpoint location. |
Fired when the debuggers breaks for a breakpoint or exception.
Parameters | Type | Details |
---|---|---|
callFrames | CallFrame[] | Call stack the debugger stopped on. |
reason | string |
Pause reason. Allowed values: breakpoint , step , exception , other , and EventListener |
data (optional) | object |
Object containing break-specific auxiliary properties. |
hitBreakpoints (optional) | string[] |
Hit breakpoints IDs |
asyncStackTrace (optional) | StackTrace |
JavaScript async stack trace. |
Fired when the debugger resumes execution.
Breakpoint identifier.
Call frame identifier.
Location in the source code.
Properties | Type | Details |
---|---|---|
scriptId | Runtime.ScriptId | Script identifier as reported in the Debugger.scriptParsed . |
lineNumber | integer |
Line number in the script (0-based). |
columnNumber (optional) | integer |
Column number in the script (0-based). |
msLength | integer |
Microsoft: Length of code (i.e. number of characters) at this call frame. |
Break location in the source code.
Properties | Type | Details |
---|---|---|
scriptId | Runtime.ScriptId | Script identifier as reported in the Debugger.scriptParsed . |
lineNumber | integer |
Line number in the script (0-based). |
columnNumber (optional) | integer |
Column number in the script (0-based). |
msLength | integer |
Microsoft: Length of code (i.e. number of characters) at this call frame. |
type (optional) | string |
Allowed values: debuggerStatement, call, return. |
JavaScript call frame. Array of call frames form the call stack.
Properties | Type | Details |
---|---|---|
callFrameId | CallFrameId | Call frame identifier. This identifier is only valid while the debugger is paused. |
functionName | string |
Name of the JavaScript function called on this call frame. |
functionLocation (optional) | Location | Experimental. Location in the source code. |
location | Location | Location in the source code. |
url | string |
JavaScript script name or url. |
scopeChain | Scope[] | Scope chain for this call frame. |
this | Runtime.RemoteObject | this object for this call frame. |
returnValue (optional) | Runtime.RemoteObject | The value being returned, if the function is at return point. |
Scope description.
Properties | Type | Details |
---|---|---|
type | string |
Scope type. Allowed values: global , local , with , closure , catch , block , script , eval , module , and return |
object | Runtime.RemoteObject | Object representing the scope. For global and with scopes it represents the actual object; for the rest of the scopes, it is artificial transient object enumerating scope variables as its properties. |
name (optional) | string |
|
startLocation (optional) | Location | Location in the source code where scope starts. |
endLocation (optional) | Location | Location in the source code where scope ends. |