The Chrome DevTools Protocol.

Audits domain allows investigation of page violations and possible improvements.

Defines events for background web platform features.

The Browser domain defines methods and events for browser managing.

A domain for interacting with Cast, Presentation API, and Remote Playback API functionalities.

This domain is deprecated - use Runtime or Log instead.

This domain exposes CSS read/write operations. All CSS objects (stylesheets, rules, and styles) have an associated id used in subsequent operations on the related object. Each object type has a specific id structure, and those are not interchangeable between objects of different kinds. CSS objects can be loaded using the get*ForNode() calls (which accept a DOM node id). A client can also keep track of stylesheets via the styleSheetAdded/styleSheetRemoved events and subsequently load the required stylesheet contents using the getStyleSheet[Text]() methods.

Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing breakpoints, stepping through execution, exploring stack traces, etc.

This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object that has an id. This id can be used to get additional information on the Node, resolve it into the JavaScript object wrapper, etc. It is important that client receives DOM events only for the nodes that are known to the client. Backend keeps track of the nodes that were sent to the client and never sends the same node twice. It is client's responsibility to collect information about the nodes that were sent to the client.Note that iframe owner elements will return corresponding document elements as their child nodes.

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.

This domain facilitates obtaining document snapshots with DOM, layout, and style information.

Query and modify DOM storage.

This domain emulates different environments for the page.

EventBreakpoints permits setting breakpoints on particular operations and events in targets that run JavaScript but do not have a DOM. JavaScript execution will stop on these operations as if there was a regular breakpoint set.

A domain for letting clients substitute browser's network layer with client code.

This domain provides experimental commands only supported in headless mode.

Input/Output operations for streams produced by DevTools.

Provides access to log entries.

This domain allows detailed inspection of media elements

Network domain allows tracking network activities of the page. It exposes information about http, file, data and other requests and responses, their headers, bodies, timing, etc.

This domain provides various functionality related to drawing atop the inspected page.

Actions and events related to the inspected page belong to the page domain.

Reporting of performance timeline events, as specified in https://w3c.github.io/performance-timeline/#dom-performanceobserver.

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.

This domain is deprecated.

Security

The SystemInfo domain defines methods and events for querying low-level system information.

Supports additional targets discovery and allows to attach to them.

The Tethering domain defines methods and events for browser port binding.

This domain allows inspection of Web Audio API. https://webaudio.github.io/web-audio-api/

This domain allows configuring virtual authenticators to test the WebAuthn API.

Transform a stream into a stream where each chunk is divided by a newline, be it \n or \r\n. \r can be enabled via the allowCR option.

Make an assertion, error will be thrown if expr does not have truthy value.

Make an assertion that actual and expected are equal, deeply. If not deeply equal, then throw.

Make an assertion that actual includes expected. If not then throw.

A node in the accessibility tree.

A single computed AX property.

A single source for a computed AX property.

The loadComplete event mirrors the load complete event sent by the browser to assistive technology when the web page has finished loading.

The nodesUpdated event is sent every time a previously requested node has changed the in tree.

Animation instance.

Event for when an animation has been cancelled.

Event for each animation that has been created.

AnimationEffect instance

Event for animation that has been started.

Keyframes Rule

Keyframe Style

Information about a cookie that is affected by an inspector issue.

Information about the frame affected by an inspector issue.

Information about a request that is affected by an inspector issue.

Details for issues around "Attribution Reporting API" usage. Explainer: https://github.com/WICG/conversion-measurement-api

Details for a request that has been blocked with the BLOCKED_BY_RESPONSE code. Currently only used for COEP/COOP, but may be extended to include some CSP errors in the future.

This issue tracks client hints related issues. It's used to deprecate old features, encourage the use of new ones, and provide general guidance.

This information is currently necessary, as the front-end has a difficult time finding a specific cookie. With this, we can convey specific error information without the cookie.

Details for a CORS related issue, e.g. a warning or error related to CORS RFC1918 enforcement.

This issue tracks information needed to print a deprecation message. The formatting is inherited from the old console.log version, see more at: https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/deprecation.cc TODO(crbug.com/1264960): Re-work format to add i18n support per: https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/public/devtools_protocol/README.md

Depending on the concrete errorType, different properties are set.

An inspector issue reported from the back-end.

This struct holds a list of optional fields with additional information specific to the kind of issue. When adding a new issue code, please also add a new optional field to this type.

Details for issues about documents in Quirks Mode or Limited Quirks Mode that affects page layouting.

Details for a issue arising from an SAB being instantiated in, or transferred to a context that is not cross-origin isolated.

Called with all existing backgroundServiceEvents when enabled, and all new events afterwards if enabled and recording.

A key-value pair for additional event information to pass along.

Called when the recording state for the service has been updated.

Browser window bounds information

Chrome histogram bucket.

Fired when download makes progress. Last call has |done| == true.

Fired when page is about to start a download.

Chrome histogram.

Definition of PermissionDescriptor defined in the Permissions API: https://w3c.github.io/permissions/#dictdef-permissiondescriptor.

Cache identifier.

Cached response

Data entry.

This is fired whenever the outstanding issue/error message changes. |issueMessage| is empty if there is no issue.

This is fired whenever the list of available sinks changes. A sink is a device or a software surface that you can cast to.

Console message.

Issued when new console message is added.

CSS container query rule descriptor.

CSS keyframe rule representation.

CSS keyframes rule representation.

CSS Layer at-rule descriptor.

CSS Layer data.

CSS media rule descriptor.

CSS property declaration data.

CSS rule representation.

CSS style representation.

CSS stylesheet metainformation.

CSS Supports at-rule descriptor.

Properties of a web font: https://www.w3.org/TR/2008/REC-CSS2-20080411/fonts.html#font-descriptions and additional information such as platformFontFamily and fontVariationAxes.

Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded web font

Information about font variation axes for variable fonts

Inherited pseudo element matches from pseudos of an ancestor node.

Inherited CSS rule collection from ancestor node.

Media query descriptor.

Media query expression descriptor.

Information about amount of glyphs that were rendered with given font.

CSS rule collection for a single pseudo style.

Match data for a CSS rule.

CSS coverage information.

Selector list data.

Text range within a resource. All numbers are zero-based.

A descriptor of operation to mutate style declaration text.

Fired whenever an active document stylesheet is added.

Fired whenever a stylesheet is changed as a result of the client operation.

Fired whenever an active document stylesheet is removed.

Data for a simple selector (these are delimited by commas in a selector list).

Database object.

Database error.

Fired when breakpoint is resolved to an actual script and location.

JavaScript call frame. Array of call frames form the call stack.

Debug symbols available for a wasm script.

Location in the source code.

Location range within one script.

Fired when the virtual machine stopped on breakpoint or exception or any other stop criteria.

Scope description.

Fired when virtual machine fails to parse the script.

Fired when virtual machine parses script. This event is also fired for all known and uncollected scripts upon enabling debugger.

Location in the source code.

Search match for resource.

Fired when Element's attribute is modified.

Fired when Element's attribute is removed.

Backend node with a friendly name.

Box model.

Mirrors DOMCharacterDataModified event.

Fired when Container's child node count has changed.

Mirrors DOMNodeInserted event.

Mirrors DOMNodeRemoved event.

Called when distribution is changed.

Fired when Element's inline style is modified via a CSS property modification.

DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes. DOMNode is a base node mirror type.

Called when a pseudo element is added to an element.

Called when a pseudo element is removed from an element.

Rectangle.

A structure holding an RGBA color.

Fired when backend wants to provide client with the missing DOM structure. This happens upon most of the calls requesting node ids.

Called when shadow root is popped from the element.

Called when shadow root is pushed into the element.

CSS Shape Outside details.

Object event listener.

A subset of the full ComputedStyle as defined by the request whitelist.

Document snapshot.

A Node in the DOM tree.

Details of post layout rendered text positions. The exact layout should not be regarded as stable and may change between versions.

Details of an element in the DOM tree with a LayoutObject.

Table of details of an element in the DOM tree with a LayoutObject.

A name/value pair.

Table containing nodes.

Data that is only present on rare nodes.

Table of details of the post layout rendered text positions. The exact layout should not be regarded as stable and may change between versions.

DOM Storage identifier.

Screen orientation.

Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints

Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints Missing optional values will be filled in by the target with what it would normally use.

Authorization challenge for HTTP status code 401 or 407.

Response to an AuthChallenge.

Issued when the domain is enabled with handleAuthRequests set to true. The request is paused until client responds with continueWithAuth.

Response HTTP header entry

Issued when the domain is enabled and the request URL matches the specified filter. The request is paused until the client responds with one of continueRequest, failRequest or fulfillRequest. The stage of the request can be determined by presence of responseErrorReason and responseStatusCode -- the request is at the response stage if either of these fields is present and in the request stage otherwise.

Issued when the target starts or stops needing BeginFrames. Deprecated. Issue beginFrame unconditionally instead and use result from beginFrame to detect whether the frames were suppressed.

Encoding options for a screenshot.

If heap objects tracking has been started then backend may send update for one or more fragments

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.

Sampling profile.

Sampling Heap Profile node. Holds callsite information, allocation statistics and child nodes.

A single sample from a sampling profile.

Database with an array of object stores.

Data entry.

Key.

Key path.

Key range.

Object store.

Object store index.

Emitted only when Input.setInterceptDrags is enabled. Use this data with Input.dispatchDragEvent to restore normal drag and drop behavior.

Fired when remote debugging connection is about to be terminated. Contains detach reason.

Information about a compositing layer.

Serialized fragment of layer picture along with its offset within the layer.

Rectangle where scrolling happens on the main thread.

Sticky position constraints.

Issued when new message was logged.

Log entry.

Violation configuration setting.

Corresponds to kMediaError

Send a list of any errors that need to be delivered.

Corresponds to kMediaEventTriggered

Send events as a list, allowing them to be batched on the browser for less congestion. If batched, events must ALWAYS be in chronological order.

Have one type per entry in MediaLogRecord::Type Corresponds to kMessage

Send a list of any messages that need to be delivered.

This can be called multiple times, and can be used to set / override / remove player properties. A null propValue indicates removal.

Corresponds to kMediaPropertyChange

Called whenever a player is created, or when a new agent joins and receives a list of active players. If an agent is restored, it will receive the full list of player ids and all events again.

Executable module information

Array of heap profile samples.

Heap profile sample.

Authorization challenge for HTTP status code 401 or 407.

Response to an AuthChallenge.

A cookie with was not sent with a request with the corresponding reason.

A cookie which was not stored from a response with the corresponding reason.

Information about the cached resource.

Cookie object

Cookie parameter object

Fired when data chunk was received over the network.

Fired when EventSource message is received.

Request / response headers as keys / values of JSON object.

Information about the request initiator.

Fired when HTTP request has failed to load.

Fired when HTTP request has finished loading.

An options object that may be extended later to better support CORS, CORB and streaming.

An object providing the result of a network resource load.

Post data entry for HTTP request

An object representing a report generated by the Reporting API.

Is sent whenever a new report is added. And after 'enableReportingApi' for all existing reports.

HTTP request data.

Details of an intercepted HTTP request, which must be either allowed, blocked, modified or mocked. Deprecated, use Fetch.requestPaused instead.

Request pattern for interception.

Fired if request ended up loading from cache.

Fired when page is about to send HTTP request.

Fired when additional information about a requestWillBeSent event is available from the network stack. Not every requestWillBeSent event will have an additional requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent or requestWillBeSentExtraInfo will be fired first for the same request.

Fired when resource loading priority is changed

Timing information for the request.

HTTP response data.

Fired when HTTP response is available.

Fired when additional information about a responseReceived event is available from the network stack. Not every responseReceived event will have an additional responseReceivedExtraInfo for it, and responseReceivedExtraInfo may be fired before or after responseReceived.

Security details about a request.

Details of a signed certificate timestamp (SCT).

Information about a signed exchange response.

Information about a signed exchange header. https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#cbor-representation

Information about a signed exchange response.

Fired when a signed exchange was received over the network

Information about a signed exchange signature. https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#rfc.section.3.1

Fired when request for resources within a .wbn file failed.

Fired when handling requests for resources within a .wbn file. Note: this will only be fired for resources that are requested by the webpage.

Fired once when parsing the .wbn file has failed.

Fired once when parsing the .wbn file has succeeded. The event contains the information about the web bundle contents.

Fired exactly once for each Trust Token operation. Depending on the type of the operation and whether the operation succeeded or failed, the event is fired before the corresponding request was sent or after the response was received.

Determines what type of Trust Token operation is executed and depending on the type, some additional parameters. The values are specified in third_party/blink/renderer/core/fetch/trust_token.idl.

Fired when WebSocket is closed.

Fired upon WebSocket creation.

WebSocket message data. This represents an entire WebSocket message, not just a fragmented frame as the name suggests.

Fired when WebSocket message error occurs.

Fired when WebSocket message is received.

Fired when WebSocket message is sent.

Fired when WebSocket handshake response becomes available.

WebSocket request data.

WebSocket response data.

Fired when WebSocket is about to initiate handshake.

Fired when WebTransport is disposed.

Fired when WebTransport handshake is finished.

Fired upon WebTransport creation.

Style information for drawing a box.

Configuration data for the highlighting of Flex container elements.

Configuration data for the highlighting of Flex item elements.

Configuration data for the highlighting of Grid elements.

Configurations for Persistent Grid Highlight

Configuration data for the highlighting of page elements.

Configuration for dual screen hinge

Fired when the node should be inspected. This happens after call to setInspectMode or when user manually inspects an element.

Style information for drawing a line.

Fired when the node should be highlighted. This happens after call to setInspectMode.

Fired when user asks to capture screenshot of some area on the page.

Configuration data for drawing the source order of an elements children.

Indicates whether a frame has been identified as an ad and why.

Error while paring app manifest.

Parsed app manifest properties.

Fired for failed bfcache history navigations if BackForwardCache feature is enabled. Do not assume any ordering with the Page.frameNavigated event. This event is fired only for main-frame history navigation where the document changes (non-same-document navigations), when bfcache navigation fails.

Per-script compilation cache parameters for Page.produceCompilationCache

Issued for every compilation cache generated. Is only available if Page.setGenerateCompilationCache is enabled.

Fired when opening document to write to.

Fired when download makes progress. Last call has |done| == true. Deprecated. Use Browser.downloadProgress instead.

Fired when page is about to start a download. Deprecated. Use Browser.downloadWillBegin instead.

Emitted only when page.interceptFileChooser is enabled.

Generic font families collection.

Default font sizes.

Information about the Frame on the page.

Fired when frame has been attached to its parent.

Fired when frame no longer has a scheduled navigation.

Fired when frame has been detached from its parent.

Fired once navigation of the frame has completed. Frame is now associated with the new loader.

Fired when a renderer-initiated navigation is requested. Navigation may still be cancelled after the event is issued.

Information about the Resource on the page.

Information about the Frame hierarchy along with their cached resources.

Fired when frame schedules a potential navigation.

Fired when frame has started loading.

Fired when frame has stopped loading.

Information about the Frame hierarchy.

The installability error

Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) has been closed.

Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) is about to open.

Layout viewport position and dimensions.

Fired for top level page lifecycle events such as navigation, load, paint, etc.

Fired when same-document navigation happens, e.g. due to history API usage or anchor navigation.

Navigation history entry.

Compressed image data requested by the startScreencast.

Screencast frame metadata.

Fired when the page with currently enabled screencast was shown or hidden `.

Font families collection for a script.

Viewport for capturing screenshot.

Visual viewport position, dimensions, and scale.

Fired when a new window is going to be opened, via window.open(), link click, form submission, etc.

Run-time execution metric.

Current values of the metrics.

See https://github.com/WICG/LargestContentfulPaint and largest_contentful_paint.idl

See https://wicg.github.io/layout-instability/#sec-layout-shift and layout_shift.idl

Sent when a performance timeline event is added. See reportPerformanceTimeline method.

Sent when new profile recording is started using console.profile() call.

Coverage data for a source range.

Coverage data for a JavaScript function.

Specifies a number of samples attributed to a certain source position.

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.

Profile.

Profile node. Holds callsite information, execution statistics and child nodes.

Coverage data for a JavaScript script.

Type profile data collected during runtime for a JavaScript script.

Describes a type collected during runtime.

Source offset and types for a parameter or return value.

Notification is issued every time when binding is called.

Represents function call argument. Either remote object id objectId, primitive value, unserializable primitive value or neither of (for undefined) them should be specified.

Stack entry for runtime errors and assertions.

Issued when console API was called.

Detailed information about exception (or error) that was thrown during script compilation or execution.

Issued when unhandled exception was revoked.

Issued when exception was thrown and unhandled.

Issued when new execution context is created.

Description of an isolated world.

Issued when execution context is destroyed.

Issued when object should be inspected (for example, as a result of inspect() command line API call).

Object internal property descriptor. This property isn't normally visible in JavaScript code.

Object containing abbreviated remote object value.

Object private field descriptor.

Object property descriptor.

Mirror object referencing original JavaScript object.

Call frames for assertions or error messages.

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.

Description of the protocol domain.

There is a certificate error. If overriding certificate errors is enabled, then it should be handled with the handleCertificateError command. Note: this event does not fire if the certificate error has been allowed internally. Only one client per target should override certificate errors at the same time.

Details about the security state of the page certificate.

Information about insecure content on the page.

The security state of the page changed. No longer being sent.

An explanation of an factor contributing to the security state.

Security state information about the page.

The security state of the page changed.

ServiceWorker error message.

ServiceWorker registration.

ServiceWorker version.

A cache's contents have been modified.

A cache has been added/deleted.

The origin's IndexedDB object store has been modified.

The origin's IndexedDB database list has been modified.

One of the interest groups was accessed by the associated page.

Ad advertising element inside an interest group.

The full details of an interest group.

Pair of issuer origin and number of available (signed, but not used) Trust Tokens from that issuer.

Usage for a storage type.

Describes a single graphics processor (GPU).

Provides information about the GPU(s) on the system.

Describes a supported image decoding profile with its associated minimum and maximum resolutions and subsampling.

Represents process info.

Describes the width and height dimensions of an entity.

Describes a supported video decoding profile with its associated minimum and maximum resolutions.

Describes a supported video encoding profile with its associated maximum resolution and maximum framerate.

Issued when attached to target because of auto-attach or attachToTarget command.

Issued when detached from target for any reason (including detachFromTarget command). Can be issued multiple times per target if multiple sessions have been attached to it.

Notifies about a new protocol message received from the session (as reported in attachedToTarget event).

Issued when a target has crashed.

Issued when a possible inspection target is created.

Issued when a target is destroyed.

Issued when some information about a target has changed. This only happens between targetCreated and targetDestroyed.

Informs that port was successfully bound and got a specified connection id.

Contains an bucket of collected trace events. When tracing is stopped collected events will be send as a sequence of dataCollected events followed by tracingComplete event.

Configuration for memory dump. Used only when "memory-infra" category is enabled.

Signals that tracing is stopped and there is no trace buffers pending flush, all data were delivered via dataCollected events.

Protocol object for AudioListener

Notifies that the construction of an AudioListener has finished.

Notifies that a new AudioListener has been created.

Protocol object for AudioNode

Notifies that a new AudioNode has been created.

Notifies that an existing AudioNode has been destroyed.

Protocol object for AudioParam

Notifies that a new AudioParam has been created.

Notifies that an existing AudioParam has been destroyed.

Protocol object for BaseAudioContext

Notifies that existing BaseAudioContext has changed some properties (id stays the same)..

Notifies that a new BaseAudioContext has been created.

Fields in AudioContext that change in real-time.

Notifies that an existing BaseAudioContext will be destroyed.

Notifies that an AudioNode is connected to an AudioParam.

Notifies that an AudioNode is disconnected to an AudioParam.

Notifies that two AudioNodes are connected.

Notifies that AudioNodes are disconnected. The destination can be null, and it means all the outgoing connections from the source are disconnected.

Unique accessibility node identifier.

Values of AXProperty name:

• from 'busy' to 'roledescription': states which apply to every AX node
• from 'live' to 'root': attributes which apply to nodes in live regions
• from 'autocomplete' to 'valuetext': attributes which apply to widgets
• from 'checked' to 'selected': states which apply to widgets
• from 'activedescendant' to 'owns' - relationships between elements other than parent/child/sibling.

Enum of possible native property sources (as a subtype of a particular AXValueSourceType).

Enum of possible property sources.

Enum of possible property types.

Enum indicating the reason a response has been blocked. These reasons are refinements of the net error BLOCKED_BY_RESPONSE.

Represents the failure reason when a federated authentication reason fails. Should be updated alongside RequestIdTokenStatus in third_party/blink/public/mojom/devtools/inspector_issue.mojom to include all cases except for success.

A unique identifier for the type of issue. Each type may use one of the optional fields in InspectorIssueDetails to convey more specific information about the kind of issue.

A unique id for a DevTools inspector issue. Allows other entities (e.g. exceptions, CDP message, console messages, etc.) to reference an issue.

The Background Service that will be associated with the commands/events. Every Background Service operates independently, but they share the same API.

Browser command ids used by executeBrowserCommand.

The state of the browser window.

type of HTTP response cached

Unique identifier of the Cache object.

Stylesheet type: "injected" for stylesheets injected via extension, "user-agent" for user-agent stylesheets, "inspector" for stylesheets created by the inspector (i.e. those holding the "via inspector" rules), "regular" for regular stylesheets.

Unique identifier of Database object.

Breakpoint identifier.

Call frame identifier.

Enum of possible script languages.

Unique DOM node identifier used to reference a node that may not have been pushed to the front-end.

Document compatibility mode.

Unique DOM node identifier.

Pseudo element type.

An array of quad vertices, x immediately followed by y for each point, points clock-wise.

Shadow root type.

CSP Violation type.

DOM breakpoint type.

Index of the string in the strings table.

Index of the string in the strings table.

DOM Storage item.

Enum of image types that can be disabled.

advance: If the scheduler runs out of immediate work, the virtual time base may fast forward to allow the next delayed task (if any) to run; pause: The virtual time base may not advance; pauseIfNetworkFetchesPending: The virtual time base may not advance if there are any pending resource fetches.

Unique request identifier.

Stages of the request to handle. Request will intercept before the request is sent. Response will intercept after the response is received (but before response body is received).

Heap snapshot object id.