123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785 |
- # Copyright 2017 The Chromium Authors. All rights reserved.
- # Use of this source code is governed by a BSD-style license that can be
- # found in the LICENSE file.
- version
- major 1
- minor 3
- # This domain is deprecated - use Runtime or Log instead.
- deprecated domain Console
- depends on Runtime
- # Console message.
- type ConsoleMessage extends object
- properties
- # Message source.
- enum source
- xml
- javascript
- network
- console-api
- storage
- appcache
- rendering
- security
- other
- deprecation
- worker
- # Message severity.
- enum level
- log
- warning
- error
- debug
- info
- # Message text.
- string text
- # URL of the message origin.
- optional string url
- # Line number in the resource that generated this message (1-based).
- optional integer line
- # Column number in the resource that generated this message (1-based).
- optional integer column
- # Does nothing.
- command clearMessages
- # Disables console domain, prevents further console messages from being reported to the client.
- command disable
- # Enables console domain, sends the messages collected so far to the client by means of the
- # `messageAdded` notification.
- command enable
- # Issued when new console message is added.
- event messageAdded
- parameters
- # Console message that has been added.
- ConsoleMessage message
- # Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing
- # breakpoints, stepping through execution, exploring stack traces, etc.
- domain Debugger
- depends on Runtime
- # Breakpoint identifier.
- type BreakpointId extends string
- # Call frame identifier.
- type CallFrameId extends string
- # Location in the source code.
- type Location extends object
- properties
- # Script identifier as reported in the `Debugger.scriptParsed`.
- Runtime.ScriptId scriptId
- # Line number in the script (0-based).
- integer lineNumber
- # Column number in the script (0-based).
- optional integer columnNumber
- # Location in the source code.
- experimental type ScriptPosition extends object
- properties
- integer lineNumber
- integer columnNumber
- # Location range within one script.
- experimental type LocationRange extends object
- properties
- Runtime.ScriptId scriptId
- ScriptPosition start
- ScriptPosition end
- # JavaScript call frame. Array of call frames form the call stack.
- type CallFrame extends object
- properties
- # Call frame identifier. This identifier is only valid while the virtual machine is paused.
- CallFrameId callFrameId
- # Name of the JavaScript function called on this call frame.
- string functionName
- # Location in the source code.
- optional Location functionLocation
- # Location in the source code.
- Location location
- # JavaScript script name or url.
- # Deprecated in favor of using the `location.scriptId` to resolve the URL via a previously
- # sent `Debugger.scriptParsed` event.
- deprecated string url
- # Scope chain for this call frame.
- array of Scope scopeChain
- # `this` object for this call frame.
- Runtime.RemoteObject this
- # The value being returned, if the function is at return point.
- optional Runtime.RemoteObject returnValue
- # Valid only while the VM is paused and indicates whether this frame
- # can be restarted or not. Note that a `true` value here does not
- # guarantee that Debugger#restartFrame with this CallFrameId will be
- # successful, but it is very likely.
- experimental optional boolean canBeRestarted
- # Scope description.
- type Scope extends object
- properties
- # Scope type.
- enum type
- global
- local
- with
- closure
- catch
- block
- script
- eval
- module
- wasm-expression-stack
- # 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.
- Runtime.RemoteObject object
- optional string name
- # Location in the source code where scope starts
- optional Location startLocation
- # Location in the source code where scope ends
- optional Location endLocation
- # Search match for resource.
- type SearchMatch extends object
- properties
- # Line number in resource content.
- number lineNumber
- # Line with match content.
- string lineContent
- type BreakLocation extends object
- properties
- # Script identifier as reported in the `Debugger.scriptParsed`.
- Runtime.ScriptId scriptId
- # Line number in the script (0-based).
- integer lineNumber
- # Column number in the script (0-based).
- optional integer columnNumber
- optional enum type
- debuggerStatement
- call
- return
- # Continues execution until specific location is reached.
- command continueToLocation
- parameters
- # Location to continue to.
- Location location
- optional enum targetCallFrames
- any
- current
- # Disables debugger for given page.
- command disable
- # Enables debugger for the given page. Clients should not assume that the debugging has been
- # enabled until the result for this command is received.
- command enable
- parameters
- # The maximum size in bytes of collected scripts (not referenced by other heap objects)
- # the debugger can hold. Puts no limit if parameter is omitted.
- experimental optional number maxScriptsCacheSize
- returns
- # Unique identifier of the debugger.
- experimental Runtime.UniqueDebuggerId debuggerId
- # Evaluates expression on a given call frame.
- command evaluateOnCallFrame
- parameters
- # Call frame identifier to evaluate on.
- CallFrameId callFrameId
- # Expression to evaluate.
- string expression
- # String object group name to put result into (allows rapid releasing resulting object handles
- # using `releaseObjectGroup`).
- optional string objectGroup
- # Specifies whether command line API should be available to the evaluated expression, defaults
- # to false.
- optional boolean includeCommandLineAPI
- # In silent mode exceptions thrown during evaluation are not reported and do not pause
- # execution. Overrides `setPauseOnException` state.
- optional boolean silent
- # Whether the result is expected to be a JSON object that should be sent by value.
- optional boolean returnByValue
- # Whether preview should be generated for the result.
- experimental optional boolean generatePreview
- # Whether to throw an exception if side effect cannot be ruled out during evaluation.
- optional boolean throwOnSideEffect
- # Terminate execution after timing out (number of milliseconds).
- experimental optional Runtime.TimeDelta timeout
- returns
- # Object wrapper for the evaluation result.
- Runtime.RemoteObject result
- # Exception details.
- optional Runtime.ExceptionDetails exceptionDetails
- # Returns possible locations for breakpoint. scriptId in start and end range locations should be
- # the same.
- command getPossibleBreakpoints
- parameters
- # Start of range to search possible breakpoint locations in.
- Location start
- # End of range to search possible breakpoint locations in (excluding). When not specified, end
- # of scripts is used as end of range.
- optional Location end
- # Only consider locations which are in the same (non-nested) function as start.
- optional boolean restrictToFunction
- returns
- # List of the possible breakpoint locations.
- array of BreakLocation locations
- # Returns source for the script with given id.
- command getScriptSource
- parameters
- # Id of the script to get source for.
- Runtime.ScriptId scriptId
- returns
- # Script source (empty in case of Wasm bytecode).
- string scriptSource
- # Wasm bytecode.
- optional binary bytecode
- experimental type WasmDisassemblyChunk extends object
- properties
- # The next chunk of disassembled lines.
- array of string lines
- # The bytecode offsets describing the start of each line.
- array of integer bytecodeOffsets
- experimental command disassembleWasmModule
- parameters
- # Id of the script to disassemble
- Runtime.ScriptId scriptId
- returns
- # For large modules, return a stream from which additional chunks of
- # disassembly can be read successively.
- optional string streamId
- # The total number of lines in the disassembly text.
- integer totalNumberOfLines
- # The offsets of all function bodies, in the format [start1, end1,
- # start2, end2, ...] where all ends are exclusive.
- array of integer functionBodyOffsets
- # The first chunk of disassembly.
- WasmDisassemblyChunk chunk
- # Disassemble the next chunk of lines for the module corresponding to the
- # stream. If disassembly is complete, this API will invalidate the streamId
- # and return an empty chunk. Any subsequent calls for the now invalid stream
- # will return errors.
- experimental command nextWasmDisassemblyChunk
- parameters
- string streamId
- returns
- # The next chunk of disassembly.
- WasmDisassemblyChunk chunk
- # This command is deprecated. Use getScriptSource instead.
- deprecated command getWasmBytecode
- parameters
- # Id of the Wasm script to get source for.
- Runtime.ScriptId scriptId
- returns
- # Script source.
- binary bytecode
- # Returns stack trace with given `stackTraceId`.
- experimental command getStackTrace
- parameters
- Runtime.StackTraceId stackTraceId
- returns
- Runtime.StackTrace stackTrace
- # Stops on the next JavaScript statement.
- command pause
- experimental deprecated command pauseOnAsyncCall
- parameters
- # Debugger will pause when async call with given stack trace is started.
- Runtime.StackTraceId parentStackTraceId
- # Removes JavaScript breakpoint.
- command removeBreakpoint
- parameters
- BreakpointId breakpointId
- # Restarts particular call frame from the beginning. The old, deprecated
- # behavior of `restartFrame` is to stay paused and allow further CDP commands
- # after a restart was scheduled. This can cause problems with restarting, so
- # we now continue execution immediatly after it has been scheduled until we
- # reach the beginning of the restarted frame.
- #
- # To stay back-wards compatible, `restartFrame` now expects a `mode`
- # parameter to be present. If the `mode` parameter is missing, `restartFrame`
- # errors out.
- #
- # The various return values are deprecated and `callFrames` is always empty.
- # Use the call frames from the `Debugger#paused` events instead, that fires
- # once V8 pauses at the beginning of the restarted function.
- command restartFrame
- parameters
- # Call frame identifier to evaluate on.
- CallFrameId callFrameId
- # The `mode` parameter must be present and set to 'StepInto', otherwise
- # `restartFrame` will error out.
- experimental optional enum mode
- # Pause at the beginning of the restarted function
- StepInto
- returns
- # New stack trace.
- deprecated array of CallFrame callFrames
- # Async stack trace, if any.
- deprecated optional Runtime.StackTrace asyncStackTrace
- # Async stack trace, if any.
- deprecated optional Runtime.StackTraceId asyncStackTraceId
- # Resumes JavaScript execution.
- command resume
- parameters
- # Set to true to terminate execution upon resuming execution. In contrast
- # to Runtime.terminateExecution, this will allows to execute further
- # JavaScript (i.e. via evaluation) until execution of the paused code
- # is actually resumed, at which point termination is triggered.
- # If execution is currently not paused, this parameter has no effect.
- optional boolean terminateOnResume
- # Searches for given string in script content.
- command searchInContent
- parameters
- # Id of the script to search in.
- Runtime.ScriptId scriptId
- # String to search for.
- string query
- # If true, search is case sensitive.
- optional boolean caseSensitive
- # If true, treats string parameter as regex.
- optional boolean isRegex
- returns
- # List of search matches.
- array of SearchMatch result
- # Enables or disables async call stacks tracking.
- command setAsyncCallStackDepth
- parameters
- # Maximum depth of async call stacks. Setting to `0` will effectively disable collecting async
- # call stacks (default).
- integer maxDepth
- # Replace previous blackbox patterns with passed ones. Forces backend to skip stepping/pausing in
- # scripts with url matching one of the patterns. VM will try to leave blackboxed script by
- # performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
- experimental command setBlackboxPatterns
- parameters
- # Array of regexps that will be used to check script url for blackbox state.
- array of string patterns
- # Makes backend skip steps in the script in blackboxed ranges. VM will try leave blacklisted
- # scripts by performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
- # Positions array contains positions where blackbox state is changed. First interval isn't
- # blackboxed. Array should be sorted.
- experimental command setBlackboxedRanges
- parameters
- # Id of the script.
- Runtime.ScriptId scriptId
- array of ScriptPosition positions
- # Sets JavaScript breakpoint at a given location.
- command setBreakpoint
- parameters
- # Location to set breakpoint in.
- Location location
- # Expression to use as a breakpoint condition. When specified, debugger will only stop on the
- # breakpoint if this expression evaluates to true.
- optional string condition
- returns
- # Id of the created breakpoint for further reference.
- BreakpointId breakpointId
- # Location this breakpoint resolved into.
- Location actualLocation
- # Sets instrumentation breakpoint.
- command setInstrumentationBreakpoint
- parameters
- # Instrumentation name.
- enum instrumentation
- beforeScriptExecution
- beforeScriptWithSourceMapExecution
- returns
- # Id of the created breakpoint for further reference.
- BreakpointId breakpointId
- # 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.
- command setBreakpointByUrl
- parameters
- # Line number to set breakpoint at.
- integer lineNumber
- # URL of the resources to set breakpoint on.
- optional string url
- # Regex pattern for the URLs of the resources to set breakpoints on. Either `url` or
- # `urlRegex` must be specified.
- optional string urlRegex
- # Script hash of the resources to set breakpoint on.
- optional string scriptHash
- # Offset in the line to set breakpoint at.
- optional integer columnNumber
- # Expression to use as a breakpoint condition. When specified, debugger will only stop on the
- # breakpoint if this expression evaluates to true.
- optional string condition
- returns
- # Id of the created breakpoint for further reference.
- BreakpointId breakpointId
- # List of the locations this breakpoint resolved into upon addition.
- array of Location locations
- # Sets JavaScript breakpoint before each call to the given function.
- # If another function was created from the same source as a given one,
- # calling it will also trigger the breakpoint.
- experimental command setBreakpointOnFunctionCall
- parameters
- # Function object id.
- Runtime.RemoteObjectId objectId
- # Expression to use as a breakpoint condition. When specified, debugger will
- # stop on the breakpoint if this expression evaluates to true.
- optional string condition
- returns
- # Id of the created breakpoint for further reference.
- BreakpointId breakpointId
- # Activates / deactivates all breakpoints on the page.
- command setBreakpointsActive
- parameters
- # New value for breakpoints active state.
- boolean active
- # 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`.
- command setPauseOnExceptions
- parameters
- # Pause on exceptions mode.
- enum state
- none
- uncaught
- all
- # Changes return value in top frame. Available only at return break position.
- experimental command setReturnValue
- parameters
- # New return value.
- Runtime.CallArgument newValue
- # Edits JavaScript source live.
- #
- # In general, functions that are currently on the stack can not be edited with
- # a single exception: If the edited function is the top-most stack frame and
- # that is the only activation of that function on the stack. In this case
- # the live edit will be successful and a `Debugger.restartFrame` for the
- # top-most function is automatically triggered.
- command setScriptSource
- parameters
- # Id of the script to edit.
- Runtime.ScriptId scriptId
- # New content of the script.
- string scriptSource
- # If true the change will not actually be applied. Dry run may be used to get result
- # description without actually modifying the code.
- optional boolean dryRun
- # If true, then `scriptSource` is allowed to change the function on top of the stack
- # as long as the top-most stack frame is the only activation of that function.
- experimental optional boolean allowTopFrameEditing
- returns
- # New stack trace in case editing has happened while VM was stopped.
- deprecated optional array of CallFrame callFrames
- # Whether current call stack was modified after applying the changes.
- deprecated optional boolean stackChanged
- # Async stack trace, if any.
- deprecated optional Runtime.StackTrace asyncStackTrace
- # Async stack trace, if any.
- deprecated optional Runtime.StackTraceId asyncStackTraceId
- # Whether the operation was successful or not. Only `Ok` denotes a
- # successful live edit while the other enum variants denote why
- # the live edit failed.
- experimental enum status
- Ok
- CompileError
- BlockedByActiveGenerator
- BlockedByActiveFunction
- # Exception details if any. Only present when `status` is `CompileError`.
- optional Runtime.ExceptionDetails exceptionDetails
- # Makes page not interrupt on any pauses (breakpoint, exception, dom exception etc).
- command setSkipAllPauses
- parameters
- # New value for skip pauses state.
- boolean skip
- # Changes value of variable in a callframe. Object-based scopes are not supported and must be
- # mutated manually.
- command setVariableValue
- parameters
- # 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.
- integer scopeNumber
- # Variable name.
- string variableName
- # New variable value.
- Runtime.CallArgument newValue
- # Id of callframe that holds variable.
- CallFrameId callFrameId
- # Steps into the function call.
- command stepInto
- parameters
- # Debugger will pause on the execution of the first async task which was scheduled
- # before next pause.
- experimental optional boolean breakOnAsyncCall
- # The skipList specifies location ranges that should be skipped on step into.
- experimental optional array of LocationRange skipList
- # Steps out of the function call.
- command stepOut
- # Steps over the statement.
- command stepOver
- parameters
- # The skipList specifies location ranges that should be skipped on step over.
- experimental optional array of LocationRange skipList
- # Fired when breakpoint is resolved to an actual script and location.
- event breakpointResolved
- parameters
- # Breakpoint unique identifier.
- BreakpointId breakpointId
- # Actual breakpoint location.
- Location location
- # Fired when the virtual machine stopped on breakpoint or exception or any other stop criteria.
- event paused
- parameters
- # Call stack the virtual machine stopped on.
- array of CallFrame callFrames
- # Pause reason.
- enum reason
- ambiguous
- assert
- CSPViolation
- debugCommand
- DOM
- EventListener
- exception
- instrumentation
- OOM
- other
- promiseRejection
- XHR
- # Object containing break-specific auxiliary properties.
- optional object data
- # Hit breakpoints IDs
- optional array of string hitBreakpoints
- # Async stack trace, if any.
- optional Runtime.StackTrace asyncStackTrace
- # Async stack trace, if any.
- experimental optional Runtime.StackTraceId asyncStackTraceId
- # Never present, will be removed.
- experimental deprecated optional Runtime.StackTraceId asyncCallStackTraceId
- # Fired when the virtual machine resumed execution.
- event resumed
- # Enum of possible script languages.
- type ScriptLanguage extends string
- enum
- JavaScript
- WebAssembly
- # Debug symbols available for a wasm script.
- type DebugSymbols extends object
- properties
- # Type of the debug symbols.
- enum type
- None
- SourceMap
- EmbeddedDWARF
- ExternalDWARF
- # URL of the external symbol source.
- optional string externalURL
- # Fired when virtual machine fails to parse the script.
- event scriptFailedToParse
- parameters
- # Identifier of the script parsed.
- Runtime.ScriptId scriptId
- # URL or name of the script parsed (if any).
- string url
- # Line offset of the script within the resource with given URL (for script tags).
- integer startLine
- # Column offset of the script within the resource with given URL.
- integer startColumn
- # Last line of the script.
- integer endLine
- # Length of the last line of the script.
- integer endColumn
- # Specifies script creation context.
- Runtime.ExecutionContextId executionContextId
- # Content hash of the script, SHA-256.
- string hash
- # Embedder-specific auxiliary data.
- optional object executionContextAuxData
- # URL of source map associated with script (if any).
- optional string sourceMapURL
- # True, if this script has sourceURL.
- optional boolean hasSourceURL
- # True, if this script is ES6 module.
- optional boolean isModule
- # This script length.
- optional integer length
- # JavaScript top stack frame of where the script parsed event was triggered if available.
- experimental optional Runtime.StackTrace stackTrace
- # If the scriptLanguage is WebAssembly, the code section offset in the module.
- experimental optional integer codeOffset
- # The language of the script.
- experimental optional Debugger.ScriptLanguage scriptLanguage
- # The name the embedder supplied for this script.
- experimental optional string embedderName
- # Fired when virtual machine parses script. This event is also fired for all known and uncollected
- # scripts upon enabling debugger.
- event scriptParsed
- parameters
- # Identifier of the script parsed.
- Runtime.ScriptId scriptId
- # URL or name of the script parsed (if any).
- string url
- # Line offset of the script within the resource with given URL (for script tags).
- integer startLine
- # Column offset of the script within the resource with given URL.
- integer startColumn
- # Last line of the script.
- integer endLine
- # Length of the last line of the script.
- integer endColumn
- # Specifies script creation context.
- Runtime.ExecutionContextId executionContextId
- # Content hash of the script, SHA-256.
- string hash
- # Embedder-specific auxiliary data.
- optional object executionContextAuxData
- # True, if this script is generated as a result of the live edit operation.
- experimental optional boolean isLiveEdit
- # URL of source map associated with script (if any).
- optional string sourceMapURL
- # True, if this script has sourceURL.
- optional boolean hasSourceURL
- # True, if this script is ES6 module.
- optional boolean isModule
- # This script length.
- optional integer length
- # JavaScript top stack frame of where the script parsed event was triggered if available.
- experimental optional Runtime.StackTrace stackTrace
- # If the scriptLanguage is WebAssembly, the code section offset in the module.
- experimental optional integer codeOffset
- # The language of the script.
- experimental optional Debugger.ScriptLanguage scriptLanguage
- # If the scriptLanguage is WebASsembly, the source of debug symbols for the module.
- experimental optional Debugger.DebugSymbols debugSymbols
- # The name the embedder supplied for this script.
- experimental optional string embedderName
- experimental domain HeapProfiler
- depends on Runtime
- # Heap snapshot object id.
- type HeapSnapshotObjectId extends string
- # Sampling Heap Profile node. Holds callsite information, allocation statistics and child nodes.
- type SamplingHeapProfileNode extends object
- properties
- # Function location.
- Runtime.CallFrame callFrame
- # Allocations size in bytes for the node excluding children.
- number selfSize
- # Node id. Ids are unique across all profiles collected between startSampling and stopSampling.
- integer id
- # Child nodes.
- array of SamplingHeapProfileNode children
- # A single sample from a sampling profile.
- type SamplingHeapProfileSample extends object
- properties
- # Allocation size in bytes attributed to the sample.
- number size
- # Id of the corresponding profile tree node.
- integer nodeId
- # Time-ordered sample ordinal number. It is unique across all profiles retrieved
- # between startSampling and stopSampling.
- number ordinal
- # Sampling profile.
- type SamplingHeapProfile extends object
- properties
- SamplingHeapProfileNode head
- array of SamplingHeapProfileSample samples
- # Enables console to refer to the node with given id via $x (see Command Line API for more details
- # $x functions).
- command addInspectedHeapObject
- parameters
- # Heap snapshot object id to be accessible by means of $x command line API.
- HeapSnapshotObjectId heapObjectId
- command collectGarbage
- command disable
- command enable
- command getHeapObjectId
- parameters
- # Identifier of the object to get heap object id for.
- Runtime.RemoteObjectId objectId
- returns
- # Id of the heap snapshot object corresponding to the passed remote object id.
- HeapSnapshotObjectId heapSnapshotObjectId
- command getObjectByHeapObjectId
- parameters
- HeapSnapshotObjectId objectId
- # Symbolic group name that can be used to release multiple objects.
- optional string objectGroup
- returns
- # Evaluation result.
- Runtime.RemoteObject result
- command getSamplingProfile
- returns
- # Return the sampling profile being collected.
- SamplingHeapProfile profile
- command startSampling
- parameters
- # Average sample interval in bytes. Poisson distribution is used for the intervals. The
- # default value is 32768 bytes.
- optional number samplingInterval
- command startTrackingHeapObjects
- parameters
- optional boolean trackAllocations
- command stopSampling
- returns
- # Recorded sampling heap profile.
- SamplingHeapProfile profile
- command stopTrackingHeapObjects
- parameters
- # If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken
- # when the tracking is stopped.
- optional boolean reportProgress
- # Deprecated in favor of `exposeInternals`.
- deprecated optional boolean treatGlobalObjectsAsRoots
- # If true, numerical values are included in the snapshot
- optional boolean captureNumericValue
- # If true, exposes internals of the snapshot.
- experimental optional boolean exposeInternals
- command takeHeapSnapshot
- parameters
- # If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken.
- optional boolean reportProgress
- # If true, a raw snapshot without artificial roots will be generated.
- # Deprecated in favor of `exposeInternals`.
- deprecated optional boolean treatGlobalObjectsAsRoots
- # If true, numerical values are included in the snapshot
- optional boolean captureNumericValue
- # If true, exposes internals of the snapshot.
- experimental optional boolean exposeInternals
- event addHeapSnapshotChunk
- parameters
- string chunk
- # If heap objects tracking has been started then backend may send update for one or more fragments
- event heapStatsUpdate
- parameters
- # An array of triplets. Each triplet describes a fragment. The first integer is the fragment
- # index, the second integer is a total count of objects for the fragment, the third integer is
- # a total size of the objects for the fragment.
- array of integer statsUpdate
- # If heap objects tracking has been started then backend regularly sends a current value for last
- # seen object id and corresponding timestamp. If the were changes in the heap since last event
- # then one or more heapStatsUpdate events will be sent before a new lastSeenObjectId event.
- event lastSeenObjectId
- parameters
- integer lastSeenObjectId
- number timestamp
- event reportHeapSnapshotProgress
- parameters
- integer done
- integer total
- optional boolean finished
- event resetProfiles
- domain Profiler
- depends on Runtime
- depends on Debugger
- # Profile node. Holds callsite information, execution statistics and child nodes.
- type ProfileNode extends object
- properties
- # Unique id of the node.
- integer id
- # Function location.
- Runtime.CallFrame callFrame
- # Number of samples where this node was on top of the call stack.
- optional integer hitCount
- # Child node ids.
- optional array of integer children
- # The reason of being not optimized. The function may be deoptimized or marked as don't
- # optimize.
- optional string deoptReason
- # An array of source position ticks.
- optional array of PositionTickInfo positionTicks
- # Profile.
- type Profile extends object
- properties
- # The list of profile nodes. First item is the root node.
- array of ProfileNode nodes
- # Profiling start timestamp in microseconds.
- number startTime
- # Profiling end timestamp in microseconds.
- number endTime
- # Ids of samples top nodes.
- optional array of integer samples
- # Time intervals between adjacent samples in microseconds. The first delta is relative to the
- # profile startTime.
- optional array of integer timeDeltas
- # Specifies a number of samples attributed to a certain source position.
- type PositionTickInfo extends object
- properties
- # Source line number (1-based).
- integer line
- # Number of samples attributed to the source line.
- integer ticks
- # Coverage data for a source range.
- type CoverageRange extends object
- properties
- # JavaScript script source offset for the range start.
- integer startOffset
- # JavaScript script source offset for the range end.
- integer endOffset
- # Collected execution count of the source range.
- integer count
- # Coverage data for a JavaScript function.
- type FunctionCoverage extends object
- properties
- # JavaScript function name.
- string functionName
- # Source ranges inside the function with coverage data.
- array of CoverageRange ranges
- # Whether coverage data for this function has block granularity.
- boolean isBlockCoverage
- # Coverage data for a JavaScript script.
- type ScriptCoverage extends object
- properties
- # JavaScript script id.
- Runtime.ScriptId scriptId
- # JavaScript script name or url.
- string url
- # Functions contained in the script that has coverage data.
- array of FunctionCoverage functions
- # Describes a type collected during runtime.
- experimental type TypeObject extends object
- properties
- # Name of a type collected with type profiling.
- string name
- # Source offset and types for a parameter or return value.
- experimental type TypeProfileEntry extends object
- properties
- # Source offset of the parameter or end of function for return values.
- integer offset
- # The types for this parameter or return value.
- array of TypeObject types
- # Type profile data collected during runtime for a JavaScript script.
- experimental type ScriptTypeProfile extends object
- properties
- # JavaScript script id.
- Runtime.ScriptId scriptId
- # JavaScript script name or url.
- string url
- # Type profile entries for parameters and return values of the functions in the script.
- array of TypeProfileEntry entries
- command disable
- command enable
- # Collect coverage data for the current isolate. The coverage data may be incomplete due to
- # garbage collection.
- command getBestEffortCoverage
- returns
- # Coverage data for the current isolate.
- array of ScriptCoverage result
- # Changes CPU profiler sampling interval. Must be called before CPU profiles recording started.
- command setSamplingInterval
- parameters
- # New sampling interval in microseconds.
- integer interval
- command start
- # Enable precise code coverage. Coverage data for JavaScript executed before enabling precise code
- # coverage may be incomplete. Enabling prevents running optimized code and resets execution
- # counters.
- command startPreciseCoverage
- parameters
- # Collect accurate call counts beyond simple 'covered' or 'not covered'.
- optional boolean callCount
- # Collect block-based coverage.
- optional boolean detailed
- # Allow the backend to send updates on its own initiative
- optional boolean allowTriggeredUpdates
- returns
- # Monotonically increasing time (in seconds) when the coverage update was taken in the backend.
- number timestamp
- # Enable type profile.
- experimental command startTypeProfile
- command stop
- returns
- # Recorded profile.
- Profile profile
- # Disable precise code coverage. Disabling releases unnecessary execution count records and allows
- # executing optimized code.
- command stopPreciseCoverage
- # Disable type profile. Disabling releases type profile data collected so far.
- experimental command stopTypeProfile
- # Collect coverage data for the current isolate, and resets execution counters. Precise code
- # coverage needs to have started.
- command takePreciseCoverage
- returns
- # Coverage data for the current isolate.
- array of ScriptCoverage result
- # Monotonically increasing time (in seconds) when the coverage update was taken in the backend.
- number timestamp
- # Collect type profile.
- experimental command takeTypeProfile
- returns
- # Type profile for all scripts since startTypeProfile() was turned on.
- array of ScriptTypeProfile result
- event consoleProfileFinished
- parameters
- string id
- # Location of console.profileEnd().
- Debugger.Location location
- Profile profile
- # Profile title passed as an argument to console.profile().
- optional string title
- # Sent when new profile recording is started using console.profile() call.
- event consoleProfileStarted
- parameters
- string id
- # Location of console.profile().
- Debugger.Location location
- # Profile title passed as an argument to console.profile().
- optional string title
- # Reports coverage delta since the last poll (either from an event like this, or from
- # `takePreciseCoverage` for the current isolate. May only be sent if precise code
- # coverage has been started. This event can be trigged by the embedder to, for example,
- # trigger collection of coverage data immediately at a certain point in time.
- experimental event preciseCoverageDeltaUpdate
- parameters
- # Monotonically increasing time (in seconds) when the coverage update was taken in the backend.
- number timestamp
- # Identifier for distinguishing coverage events.
- string occasion
- # Coverage data for the current isolate.
- array of ScriptCoverage result
- # Runtime domain exposes JavaScript runtime by means of remote evaluation and mirror objects.
- # Evaluation results are returned as mirror object that expose object type, string representation
- # and unique identifier that can be used for further object reference. Original objects are
- # maintained in memory unless they are either explicitly released or are released along with the
- # other objects in their object group.
- domain Runtime
- # Unique script identifier.
- type ScriptId extends string
- # Represents the value serialiazed by the WebDriver BiDi specification
- # https://w3c.github.io/webdriver-bidi.
- type WebDriverValue extends object
- properties
- enum type
- undefined
- null
- string
- number
- boolean
- bigint
- regexp
- date
- symbol
- array
- object
- function
- map
- set
- weakmap
- weakset
- error
- proxy
- promise
- typedarray
- arraybuffer
- node
- window
- optional any value
- optional string objectId
- # Unique object identifier.
- type RemoteObjectId extends string
- # Primitive value which cannot be JSON-stringified. Includes values `-0`, `NaN`, `Infinity`,
- # `-Infinity`, and bigint literals.
- type UnserializableValue extends string
- # Mirror object referencing original JavaScript object.
- type RemoteObject extends object
- properties
- # Object type.
- enum type
- object
- function
- undefined
- string
- number
- boolean
- symbol
- bigint
- # Object subtype hint. Specified for `object` type values only.
- # NOTE: If you change anything here, make sure to also update
- # `subtype` in `ObjectPreview` and `PropertyPreview` below.
- optional enum subtype
- array
- null
- node
- regexp
- date
- map
- set
- weakmap
- weakset
- iterator
- generator
- error
- proxy
- promise
- typedarray
- arraybuffer
- dataview
- webassemblymemory
- wasmvalue
- # Object class (constructor) name. Specified for `object` type values only.
- optional string className
- # Remote object value in case of primitive values or JSON values (if it was requested).
- optional any value
- # Primitive value which can not be JSON-stringified does not have `value`, but gets this
- # property.
- optional UnserializableValue unserializableValue
- # String representation of the object.
- optional string description
- # WebDriver BiDi representation of the value.
- experimental optional WebDriverValue webDriverValue
- # Unique object identifier (for non-primitive values).
- optional RemoteObjectId objectId
- # Preview containing abbreviated property values. Specified for `object` type values only.
- experimental optional ObjectPreview preview
- experimental optional CustomPreview customPreview
- experimental type CustomPreview extends object
- properties
- # The JSON-stringified result of formatter.header(object, config) call.
- # It contains json ML array that represents RemoteObject.
- string header
- # If formatter returns true as a result of formatter.hasBody call then bodyGetterId will
- # contain RemoteObjectId for the function that returns result of formatter.body(object, config) call.
- # The result value is json ML array.
- optional RemoteObjectId bodyGetterId
- # Object containing abbreviated remote object value.
- experimental type ObjectPreview extends object
- properties
- # Object type.
- enum type
- object
- function
- undefined
- string
- number
- boolean
- symbol
- bigint
- # Object subtype hint. Specified for `object` type values only.
- optional enum subtype
- array
- null
- node
- regexp
- date
- map
- set
- weakmap
- weakset
- iterator
- generator
- error
- proxy
- promise
- typedarray
- arraybuffer
- dataview
- webassemblymemory
- wasmvalue
- # String representation of the object.
- optional string description
- # True iff some of the properties or entries of the original object did not fit.
- boolean overflow
- # List of the properties.
- array of PropertyPreview properties
- # List of the entries. Specified for `map` and `set` subtype values only.
- optional array of EntryPreview entries
- experimental type PropertyPreview extends object
- properties
- # Property name.
- string name
- # Object type. Accessor means that the property itself is an accessor property.
- enum type
- object
- function
- undefined
- string
- number
- boolean
- symbol
- accessor
- bigint
- # User-friendly property value string.
- optional string value
- # Nested value preview.
- optional ObjectPreview valuePreview
- # Object subtype hint. Specified for `object` type values only.
- optional enum subtype
- array
- null
- node
- regexp
- date
- map
- set
- weakmap
- weakset
- iterator
- generator
- error
- proxy
- promise
- typedarray
- arraybuffer
- dataview
- webassemblymemory
- wasmvalue
- experimental type EntryPreview extends object
- properties
- # Preview of the key. Specified for map-like collection entries.
- optional ObjectPreview key
- # Preview of the value.
- ObjectPreview value
- # Object property descriptor.
- type PropertyDescriptor extends object
- properties
- # Property name or symbol description.
- string name
- # The value associated with the property.
- optional RemoteObject value
- # True if the value associated with the property may be changed (data descriptors only).
- optional boolean writable
- # A function which serves as a getter for the property, or `undefined` if there is no getter
- # (accessor descriptors only).
- optional RemoteObject get
- # A function which serves as a setter for the property, or `undefined` if there is no setter
- # (accessor descriptors only).
- optional RemoteObject set
- # True if the type of this property descriptor may be changed and if the property may be
- # deleted from the corresponding object.
- boolean configurable
- # True if this property shows up during enumeration of the properties on the corresponding
- # object.
- boolean enumerable
- # True if the result was thrown during the evaluation.
- optional boolean wasThrown
- # True if the property is owned for the object.
- optional boolean isOwn
- # Property symbol object, if the property is of the `symbol` type.
- optional RemoteObject symbol
- # Object internal property descriptor. This property isn't normally visible in JavaScript code.
- type InternalPropertyDescriptor extends object
- properties
- # Conventional property name.
- string name
- # The value associated with the property.
- optional RemoteObject value
- # Object private field descriptor.
- experimental type PrivatePropertyDescriptor extends object
- properties
- # Private property name.
- string name
- # The value associated with the private property.
- optional RemoteObject value
- # A function which serves as a getter for the private property,
- # or `undefined` if there is no getter (accessor descriptors only).
- optional RemoteObject get
- # A function which serves as a setter for the private property,
- # or `undefined` if there is no setter (accessor descriptors only).
- optional RemoteObject set
- # Represents function call argument. Either remote object id `objectId`, primitive `value`,
- # unserializable primitive value or neither of (for undefined) them should be specified.
- type CallArgument extends object
- properties
- # Primitive value or serializable javascript object.
- optional any value
- # Primitive value which can not be JSON-stringified.
- optional UnserializableValue unserializableValue
- # Remote object handle.
- optional RemoteObjectId objectId
- # Id of an execution context.
- type ExecutionContextId extends integer
- # Description of an isolated world.
- type ExecutionContextDescription extends object
- properties
- # Unique id of the execution context. It can be used to specify in which execution context
- # script evaluation should be performed.
- ExecutionContextId id
- # Execution context origin.
- string origin
- # Human readable name describing given context.
- string name
- # A system-unique execution context identifier. Unlike the id, this is unique across
- # multiple processes, so can be reliably used to identify specific context while backend
- # performs a cross-process navigation.
- experimental string uniqueId
- # Embedder-specific auxiliary data.
- optional object auxData
- # Detailed information about exception (or error) that was thrown during script compilation or
- # execution.
- type ExceptionDetails extends object
- properties
- # Exception id.
- integer exceptionId
- # Exception text, which should be used together with exception object when available.
- string text
- # Line number of the exception location (0-based).
- integer lineNumber
- # Column number of the exception location (0-based).
- integer columnNumber
- # Script ID of the exception location.
- optional ScriptId scriptId
- # URL of the exception location, to be used when the script was not reported.
- optional string url
- # JavaScript stack trace if available.
- optional StackTrace stackTrace
- # Exception object if available.
- optional RemoteObject exception
- # Identifier of the context where exception happened.
- optional ExecutionContextId executionContextId
- # Dictionary with entries of meta data that the client associated
- # with this exception, such as information about associated network
- # requests, etc.
- experimental optional object exceptionMetaData
- # Number of milliseconds since epoch.
- type Timestamp extends number
- # Number of milliseconds.
- type TimeDelta extends number
- # Stack entry for runtime errors and assertions.
- type CallFrame extends object
- properties
- # JavaScript function name.
- string functionName
- # JavaScript script id.
- ScriptId scriptId
- # JavaScript script name or url.
- string url
- # JavaScript script line number (0-based).
- integer lineNumber
- # JavaScript script column number (0-based).
- integer columnNumber
- # Call frames for assertions or error messages.
- type StackTrace extends object
- properties
- # String label of this stack trace. For async traces this may be a name of the function that
- # initiated the async call.
- optional string description
- # JavaScript function name.
- array of CallFrame callFrames
- # Asynchronous JavaScript stack trace that preceded this stack, if available.
- optional StackTrace parent
- # Asynchronous JavaScript stack trace that preceded this stack, if available.
- experimental optional StackTraceId parentId
- # Unique identifier of current debugger.
- experimental type UniqueDebuggerId extends string
- # If `debuggerId` is set stack trace comes from another debugger and can be resolved there. This
- # allows to track cross-debugger calls. See `Runtime.StackTrace` and `Debugger.paused` for usages.
- experimental type StackTraceId extends object
- properties
- string id
- optional UniqueDebuggerId debuggerId
- # Add handler to promise with given promise object id.
- command awaitPromise
- parameters
- # Identifier of the promise.
- RemoteObjectId promiseObjectId
- # Whether the result is expected to be a JSON object that should be sent by value.
- optional boolean returnByValue
- # Whether preview should be generated for the result.
- optional boolean generatePreview
- returns
- # Promise result. Will contain rejected value if promise was rejected.
- RemoteObject result
- # Exception details if stack strace is available.
- optional ExceptionDetails exceptionDetails
- # Calls function with given declaration on the given object. Object group of the result is
- # inherited from the target object.
- command callFunctionOn
- parameters
- # Declaration of the function to call.
- string functionDeclaration
- # Identifier of the object to call function on. Either objectId or executionContextId should
- # be specified.
- optional RemoteObjectId objectId
- # Call arguments. All call arguments must belong to the same JavaScript world as the target
- # object.
- optional array of CallArgument arguments
- # In silent mode exceptions thrown during evaluation are not reported and do not pause
- # execution. Overrides `setPauseOnException` state.
- optional boolean silent
- # Whether the result is expected to be a JSON object which should be sent by value.
- optional boolean returnByValue
- # Whether preview should be generated for the result.
- experimental optional boolean generatePreview
- # Whether execution should be treated as initiated by user in the UI.
- optional boolean userGesture
- # Whether execution should `await` for resulting value and return once awaited promise is
- # resolved.
- optional boolean awaitPromise
- # Specifies execution context which global object will be used to call function on. Either
- # executionContextId or objectId should be specified.
- optional ExecutionContextId executionContextId
- # Symbolic group name that can be used to release multiple objects. If objectGroup is not
- # specified and objectId is, objectGroup will be inherited from object.
- optional string objectGroup
- # Whether to throw an exception if side effect cannot be ruled out during evaluation.
- experimental optional boolean throwOnSideEffect
- # Whether the result should contain `webDriverValue`, serialized according to
- # https://w3c.github.io/webdriver-bidi. This is mutually exclusive with `returnByValue`, but
- # resulting `objectId` is still provided.
- experimental optional boolean generateWebDriverValue
- returns
- # Call result.
- RemoteObject result
- # Exception details.
- optional ExceptionDetails exceptionDetails
- # Compiles expression.
- command compileScript
- parameters
- # Expression to compile.
- string expression
- # Source url to be set for the script.
- string sourceURL
- # Specifies whether the compiled script should be persisted.
- boolean persistScript
- # Specifies in which execution context to perform script run. If the parameter is omitted the
- # evaluation will be performed in the context of the inspected page.
- optional ExecutionContextId executionContextId
- returns
- # Id of the script.
- optional ScriptId scriptId
- # Exception details.
- optional ExceptionDetails exceptionDetails
- # Disables reporting of execution contexts creation.
- command disable
- # Discards collected exceptions and console API calls.
- command discardConsoleEntries
- # Enables reporting of execution contexts creation by means of `executionContextCreated` event.
- # When the reporting gets enabled the event will be sent immediately for each existing execution
- # context.
- command enable
- # Evaluates expression on global object.
- command evaluate
- parameters
- # Expression to evaluate.
- string expression
- # Symbolic group name that can be used to release multiple objects.
- optional string objectGroup
- # Determines whether Command Line API should be available during the evaluation.
- optional boolean includeCommandLineAPI
- # In silent mode exceptions thrown during evaluation are not reported and do not pause
- # execution. Overrides `setPauseOnException` state.
- optional boolean silent
- # Specifies in which execution context to perform evaluation. If the parameter is omitted the
- # evaluation will be performed in the context of the inspected page.
- # This is mutually exclusive with `uniqueContextId`, which offers an
- # alternative way to identify the execution context that is more reliable
- # in a multi-process environment.
- optional ExecutionContextId contextId
- # Whether the result is expected to be a JSON object that should be sent by value.
- optional boolean returnByValue
- # Whether preview should be generated for the result.
- experimental optional boolean generatePreview
- # Whether execution should be treated as initiated by user in the UI.
- optional boolean userGesture
- # Whether execution should `await` for resulting value and return once awaited promise is
- # resolved.
- optional boolean awaitPromise
- # Whether to throw an exception if side effect cannot be ruled out during evaluation.
- # This implies `disableBreaks` below.
- experimental optional boolean throwOnSideEffect
- # Terminate execution after timing out (number of milliseconds).
- experimental optional TimeDelta timeout
- # Disable breakpoints during execution.
- experimental optional boolean disableBreaks
- # Setting this flag to true enables `let` re-declaration and top-level `await`.
- # Note that `let` variables can only be re-declared if they originate from
- # `replMode` themselves.
- experimental optional boolean replMode
- # The Content Security Policy (CSP) for the target might block 'unsafe-eval'
- # which includes eval(), Function(), setTimeout() and setInterval()
- # when called with non-callable arguments. This flag bypasses CSP for this
- # evaluation and allows unsafe-eval. Defaults to true.
- experimental optional boolean allowUnsafeEvalBlockedByCSP
- # An alternative way to specify the execution context to evaluate in.
- # Compared to contextId that may be reused across processes, this is guaranteed to be
- # system-unique, so it can be used to prevent accidental evaluation of the expression
- # in context different than intended (e.g. as a result of navigation across process
- # boundaries).
- # This is mutually exclusive with `contextId`.
- experimental optional string uniqueContextId
- # Whether the result should be serialized according to https://w3c.github.io/webdriver-bidi.
- experimental optional boolean generateWebDriverValue
- returns
- # Evaluation result.
- RemoteObject result
- # Exception details.
- optional ExceptionDetails exceptionDetails
- # Returns the isolate id.
- experimental command getIsolateId
- returns
- # The isolate id.
- string id
- # Returns the JavaScript heap usage.
- # It is the total usage of the corresponding isolate not scoped to a particular Runtime.
- experimental command getHeapUsage
- returns
- # Used heap size in bytes.
- number usedSize
- # Allocated heap size in bytes.
- number totalSize
- # Returns properties of a given object. Object group of the result is inherited from the target
- # object.
- command getProperties
- parameters
- # Identifier of the object to return properties for.
- RemoteObjectId objectId
- # If true, returns properties belonging only to the element itself, not to its prototype
- # chain.
- optional boolean ownProperties
- # If true, returns accessor properties (with getter/setter) only; internal properties are not
- # returned either.
- experimental optional boolean accessorPropertiesOnly
- # Whether preview should be generated for the results.
- experimental optional boolean generatePreview
- # If true, returns non-indexed properties only.
- experimental optional boolean nonIndexedPropertiesOnly
- returns
- # Object properties.
- array of PropertyDescriptor result
- # Internal object properties (only of the element itself).
- optional array of InternalPropertyDescriptor internalProperties
- # Object private properties.
- experimental optional array of PrivatePropertyDescriptor privateProperties
- # Exception details.
- optional ExceptionDetails exceptionDetails
- # Returns all let, const and class variables from global scope.
- command globalLexicalScopeNames
- parameters
- # Specifies in which execution context to lookup global scope variables.
- optional ExecutionContextId executionContextId
- returns
- array of string names
- command queryObjects
- parameters
- # Identifier of the prototype to return objects for.
- RemoteObjectId prototypeObjectId
- # Symbolic group name that can be used to release the results.
- optional string objectGroup
- returns
- # Array with objects.
- RemoteObject objects
- # Releases remote object with given id.
- command releaseObject
- parameters
- # Identifier of the object to release.
- RemoteObjectId objectId
- # Releases all remote objects that belong to a given group.
- command releaseObjectGroup
- parameters
- # Symbolic object group name.
- string objectGroup
- # Tells inspected instance to run if it was waiting for debugger to attach.
- command runIfWaitingForDebugger
- # Runs script with given id in a given context.
- command runScript
- parameters
- # Id of the script to run.
- ScriptId scriptId
- # Specifies in which execution context to perform script run. If the parameter is omitted the
- # evaluation will be performed in the context of the inspected page.
- optional ExecutionContextId executionContextId
- # Symbolic group name that can be used to release multiple objects.
- optional string objectGroup
- # In silent mode exceptions thrown during evaluation are not reported and do not pause
- # execution. Overrides `setPauseOnException` state.
- optional boolean silent
- # Determines whether Command Line API should be available during the evaluation.
- optional boolean includeCommandLineAPI
- # Whether the result is expected to be a JSON object which should be sent by value.
- optional boolean returnByValue
- # Whether preview should be generated for the result.
- optional boolean generatePreview
- # Whether execution should `await` for resulting value and return once awaited promise is
- # resolved.
- optional boolean awaitPromise
- returns
- # Run result.
- RemoteObject result
- # Exception details.
- optional ExceptionDetails exceptionDetails
- # Enables or disables async call stacks tracking.
- command setAsyncCallStackDepth
- redirect Debugger
- parameters
- # Maximum depth of async call stacks. Setting to `0` will effectively disable collecting async
- # call stacks (default).
- integer maxDepth
- experimental command setCustomObjectFormatterEnabled
- parameters
- boolean enabled
- experimental command setMaxCallStackSizeToCapture
- parameters
- integer size
- # Terminate current or next JavaScript execution.
- # Will cancel the termination when the outer-most script execution ends.
- experimental command terminateExecution
- # If executionContextId is empty, adds binding with the given name on the
- # global objects of all inspected contexts, including those created later,
- # bindings survive reloads.
- # Binding function takes exactly one argument, this argument should be string,
- # in case of any other input, function throws an exception.
- # Each binding function call produces Runtime.bindingCalled notification.
- experimental command addBinding
- parameters
- string name
- # If specified, the binding would only be exposed to the specified
- # execution context. If omitted and `executionContextName` is not set,
- # the binding is exposed to all execution contexts of the target.
- # This parameter is mutually exclusive with `executionContextName`.
- # Deprecated in favor of `executionContextName` due to an unclear use case
- # and bugs in implementation (crbug.com/1169639). `executionContextId` will be
- # removed in the future.
- deprecated optional ExecutionContextId executionContextId
- # If specified, the binding is exposed to the executionContext with
- # matching name, even for contexts created after the binding is added.
- # See also `ExecutionContext.name` and `worldName` parameter to
- # `Page.addScriptToEvaluateOnNewDocument`.
- # This parameter is mutually exclusive with `executionContextId`.
- experimental optional string executionContextName
- # This method does not remove binding function from global object but
- # unsubscribes current runtime agent from Runtime.bindingCalled notifications.
- experimental command removeBinding
- parameters
- string name
- # This method tries to lookup and populate exception details for a
- # JavaScript Error object.
- # Note that the stackTrace portion of the resulting exceptionDetails will
- # only be populated if the Runtime domain was enabled at the time when the
- # Error was thrown.
- experimental command getExceptionDetails
- parameters
- # The error object for which to resolve the exception details.
- RemoteObjectId errorObjectId
- returns
- optional ExceptionDetails exceptionDetails
- # Notification is issued every time when binding is called.
- experimental event bindingCalled
- parameters
- string name
- string payload
- # Identifier of the context where the call was made.
- ExecutionContextId executionContextId
- # Issued when console API was called.
- event consoleAPICalled
- parameters
- # Type of the call.
- enum type
- log
- debug
- info
- error
- warning
- dir
- dirxml
- table
- trace
- clear
- startGroup
- startGroupCollapsed
- endGroup
- assert
- profile
- profileEnd
- count
- timeEnd
- # Call arguments.
- array of RemoteObject args
- # Identifier of the context where the call was made.
- ExecutionContextId executionContextId
- # Call timestamp.
- Timestamp timestamp
- # Stack trace captured when the call was made. The async stack chain is automatically reported for
- # the following call types: `assert`, `error`, `trace`, `warning`. For other types the async call
- # chain can be retrieved using `Debugger.getStackTrace` and `stackTrace.parentId` field.
- optional StackTrace stackTrace
- # Console context descriptor for calls on non-default console context (not console.*):
- # 'anonymous#unique-logger-id' for call on unnamed context, 'name#unique-logger-id' for call
- # on named context.
- experimental optional string context
- # Issued when unhandled exception was revoked.
- event exceptionRevoked
- parameters
- # Reason describing why exception was revoked.
- string reason
- # The id of revoked exception, as reported in `exceptionThrown`.
- integer exceptionId
- # Issued when exception was thrown and unhandled.
- event exceptionThrown
- parameters
- # Timestamp of the exception.
- Timestamp timestamp
- ExceptionDetails exceptionDetails
- # Issued when new execution context is created.
- event executionContextCreated
- parameters
- # A newly created execution context.
- ExecutionContextDescription context
- # Issued when execution context is destroyed.
- event executionContextDestroyed
- parameters
- # Id of the destroyed context
- ExecutionContextId executionContextId
- # Issued when all executionContexts were cleared in browser
- event executionContextsCleared
- # Issued when object should be inspected (for example, as a result of inspect() command line API
- # call).
- event inspectRequested
- parameters
- RemoteObject object
- object hints
- # Identifier of the context where the call was made.
- experimental optional ExecutionContextId executionContextId
- # This domain is deprecated.
- deprecated domain Schema
- # Description of the protocol domain.
- type Domain extends object
- properties
- # Domain name.
- string name
- # Domain version.
- string version
- # Returns supported domains.
- command getDomains
- returns
- # List of supported domains.
- array of Domain domains
|