Roll protocol to r1501779 — 2025-08-15T04:33:26.000Z
@@ domains/Target.pdl:27 @@ domain Target
experimental boolean canAccessOpener
# Frame id of originating window (is only set if target has an opener).
experimental optional Page.FrameId openerFrameId
+ # Id of the parent frame, only present for the "iframe" targets.
+ experimental optional Page.FrameId parentFrameId
experimental optional Browser.BrowserContextID browserContextId
# Provides additional details for specific target types. For example, for
# the type of "page", this may be set to "prerender".
Roll protocol to r1501221 — 2025-08-14T06:10:27.000Z
@@ browser_protocol.pdl:54 @@ include domains/Target.pdl
include domains/Tethering.pdl
include domains/Tracing.pdl
include domains/WebAudio.pdl
-include domains/WebAuthn.pdl
\ No newline at end of file
+include domains/WebAuthn.pdl
diff --git a/pdl/domains/Emulation.pdl b/pdl/domains/Emulation.pdl
index 861b76ed..13daa510 100644
--- a/pdl/domains/Emulation.pdl
+++ b/pdl/domains/Emulation.pdl
@@ -160,6 +160,56 @@ domain Emulation
properties
optional boolean available
+ experimental type WorkAreaInsets extends object
+ properties
+ # Work area top inset in pixels. Default is 0;
+ optional integer top
+ # Work area left inset in pixels. Default is 0;
+ optional integer left
+ # Work area bottom inset in pixels. Default is 0;
+ optional integer bottom
+ # Work area right inset in pixels. Default is 0;
+ optional integer right
+
+ experimental type ScreenId extends string
+
+ # Screen information similar to the one returned by window.getScreenDetails() method,
+ # see https://w3c.github.io/window-management/#screendetailed.
+ experimental type ScreenInfo extends object
+ properties
+ # Offset of the left edge of the screen.
+ integer left
+ # Offset of the top edge of the screen.
+ integer top
+ # Width of the screen.
+ integer width
+ # Height of the screen.
+ integer height
+ # Offset of the left edge of the available screen area.
+ integer availLeft
+ # Offset of the top edge of the available screen area.
+ integer availTop
+ # Width of the available screen area.
+ integer availWidth
+ # Height of the available screen area.
+ integer availHeight
+ # Specifies the screen's device pixel ratio.
+ number devicePixelRatio
+ # Specifies the screen's orientation.
+ ScreenOrientation orientation
+ # Specifies the screen's color depth in bits.
+ integer colorDepth
+ # Indicates whether the device has multiple screens.
+ boolean isExtended
+ # Indicates whether the screen is internal to the device or external, attached to the device.
+ boolean isInternal
+ # Indicates whether the screen is set as the the operating system primary screen.
+ boolean isPrimary
+ # Specifies the descriptive label for the screen.
+ string label
+ # Specifies the unique identifier of the screen.
+ ScreenId id
+
# Tells whether emulation is supported.
deprecated command canEmulate
returns
@@ -520,3 +570,39 @@ domain Emulation
# This will cause an element of size 100svh to be `difference` pixels smaller than an element
# of size 100lvh.
integer difference
+
+ # Returns device's screen configuration.
+ experimental command getScreenInfos
+ returns
+ array of ScreenInfo screenInfos
+
+ # Add a new screen to the device. Only supported in headless mode.
+ experimental command addScreen
+ parameters
+ # Offset of the left edge of the screen in pixels.
+ integer left
+ # Offset of the top edge of the screen in pixels.
+ integer top
+ # The width of the screen in pixels.
+ integer width
+ # The height of the screen in pixels.
+ integer height
+ # Specifies the screen's work area. Default is entire screen.
+ optional WorkAreaInsets workAreaInsets
+ # Specifies the screen's device pixel ratio. Default is 1.
+ optional number devicePixelRatio
+ # Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270. Default is 0.
+ optional integer rotation
+ # Specifies the screen's color depth in bits. Default is 24.
+ optional integer colorDepth
+ # Specifies the descriptive label for the screen. Default is none.
+ optional string label
+ # Indicates whether the screen is internal to the device or external, attached to the device. Default is false.
+ optional boolean isInternal
+ returns
+ ScreenInfo screenInfo
+
+ # Remove screen from the device. Only supported in headless mode.
+ experimental command removeScreen
+ parameters
+ ScreenId screenId
ci: generate after split (#330) — 2025-08-13T10:53:00.000Z
@@ browser_protocol.pdl:8 @@ version
major 1
minor 3
-experimental domain Accessibility
- depends on DOM
-
- # Unique accessibility node identifier.
- type AXNodeId extends string
-
- # Enum of possible property types.
- type AXValueType extends string
- enum
- boolean
- tristate
- booleanOrUndefined
- idref
- idrefList
- integer
- node
- nodeList
- number
- string
- computedString
- token
- tokenList
- domRelation
- role
- internalRole
- valueUndefined
-
- # Enum of possible property sources.
- type AXValueSourceType extends string
- enum
- attribute
- implicit
- style
- contents
- placeholder
- relatedElement
-
- # Enum of possible native property sources (as a subtype of a particular AXValueSourceType).
- type AXValueNativeSourceType extends string
- enum
- description
- figcaption
- label
- labelfor
- labelwrapped
- legend
- rubyannotation
- tablecaption
- title
- other
-
- # A single source for a computed AX property.
- type AXValueSource extends object
- properties
- # What type of source this is.
- AXValueSourceType type
- # The value of this property source.
- optional AXValue value
- # The name of the relevant attribute, if any.
- optional string attribute
- # The value of the relevant attribute, if any.
- optional AXValue attributeValue
- # Whether this source is superseded by a higher priority source.
- optional boolean superseded
- # The native markup source for this value, e.g. a `<label>` element.
- optional AXValueNativeSourceType nativeSource
- # The value, such as a node or node list, of the native source.
- optional AXValue nativeSourceValue
- # Whether the value for this property is invalid.
- optional boolean invalid
- # Reason for the value being invalid, if it is.
- optional string invalidReason
-
- type AXRelatedNode extends object
- properties
- # The BackendNodeId of the related DOM node.
- DOM.BackendNodeId backendDOMNodeId
- # The IDRef value provided, if any.
- optional string idref
- # The text alternative of this node in the current context.
- optional string text
-
- type AXProperty extends object
- properties
- # The name of this property.
- AXPropertyName name
- # The value of this property.
- AXValue value
-
- # A single computed AX property.
- type AXValue extends object
- properties
- # The type of this value.
- AXValueType type
- # The computed value of this property.
- optional any value
- # One or more related nodes, if applicable.
- optional array of AXRelatedNode relatedNodes
- # The sources which contributed to the computation of this property.
- optional array of AXValueSource sources
-
- # 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.
- type AXPropertyName extends string
- enum
- actions
- busy
- disabled
- editable
- focusable
- focused
- hidden
- hiddenRoot
- invalid
- keyshortcuts
- settable
- roledescription
- live
- atomic
- relevant
- root
- autocomplete
- hasPopup
- level
- multiselectable
- orientation
- multiline
- readonly
- required
- valuemin
- valuemax
- valuetext
- checked
- expanded
- modal
- pressed
- selected
- activedescendant
- controls
- describedby
- details
- errormessage
- flowto
- labelledby
- owns
- url
-
- # A node in the accessibility tree.
- type AXNode extends object
- properties
- # Unique identifier for this node.
- AXNodeId nodeId
- # Whether this node is ignored for accessibility
- boolean ignored
- # Collection of reasons why this node is hidden.
- optional array of AXProperty ignoredReasons
- # This `Node`'s role, whether explicit or implicit.
- optional AXValue role
- # This `Node`'s Chrome raw role.
- optional AXValue chromeRole
- # The accessible name for this `Node`.
- optional AXValue name
- # The accessible description for this `Node`.
- optional AXValue description
- # The value for this `Node`.
- optional AXValue value
- # All other properties
- optional array of AXProperty properties
- # ID for this node's parent.
- optional AXNodeId parentId
- # IDs for each of this node's child nodes.
- optional array of AXNodeId childIds
- # The backend ID for the associated DOM node, if any.
- optional DOM.BackendNodeId backendDOMNodeId
- # The frame ID for the frame associated with this nodes document.
- optional Page.FrameId frameId
-
- # Disables the accessibility domain.
- command disable
-
- # Enables the accessibility domain which causes `AXNodeId`s to remain consistent between method calls.
- # This turns on accessibility for the page, which can impact performance until accessibility is disabled.
- command enable
-
- # Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
- experimental command getPartialAXTree
- parameters
- # Identifier of the node to get the partial accessibility tree for.
- optional DOM.NodeId nodeId
- # Identifier of the backend node to get the partial accessibility tree for.
- optional DOM.BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper to get the partial accessibility tree for.
- optional Runtime.RemoteObjectId objectId
- # Whether to fetch this node's ancestors, siblings and children. Defaults to true.
- optional boolean fetchRelatives
- returns
- # The `Accessibility.AXNode` for this DOM node, if it exists, plus its ancestors, siblings and
- # children, if requested.
- array of AXNode nodes
-
- # Fetches the entire accessibility tree for the root Document
- experimental command getFullAXTree
- parameters
- # The maximum depth at which descendants of the root node should be retrieved.
- # If omitted, the full tree is returned.
- optional integer depth
- # The frame for whose document the AX tree should be retrieved.
- # If omitted, the root frame is used.
- optional Page.FrameId frameId
- returns
- array of AXNode nodes
-
- # Fetches the root node.
- # Requires `enable()` to have been called previously.
- experimental command getRootAXNode
- parameters
- # The frame in whose document the node resides.
- # If omitted, the root frame is used.
- optional Page.FrameId frameId
- returns
- AXNode node
-
- # Fetches a node and all ancestors up to and including the root.
- # Requires `enable()` to have been called previously.
- experimental command getAXNodeAndAncestors
- parameters
- # Identifier of the node to get.
- optional DOM.NodeId nodeId
- # Identifier of the backend node to get.
- optional DOM.BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper to get.
- optional Runtime.RemoteObjectId objectId
- returns
- array of AXNode nodes
-
- # Fetches a particular accessibility node by AXNodeId.
- # Requires `enable()` to have been called previously.
- experimental command getChildAXNodes
- parameters
- AXNodeId id
- # The frame in whose document the node resides.
- # If omitted, the root frame is used.
- optional Page.FrameId frameId
- returns
- array of AXNode nodes
-
- # Query a DOM node's accessibility subtree for accessible name and role.
- # This command computes the name and role for all nodes in the subtree, including those that are
- # ignored for accessibility, and returns those that match the specified name and role. If no DOM
- # node is specified, or the DOM node does not exist, the command returns an error. If neither
- # `accessibleName` or `role` is specified, it returns all the accessibility nodes in the subtree.
- experimental command queryAXTree
- parameters
- # Identifier of the node for the root to query.
- optional DOM.NodeId nodeId
- # Identifier of the backend node for the root to query.
- optional DOM.BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper for the root to query.
- optional Runtime.RemoteObjectId objectId
- # Find nodes with this computed name.
- optional string accessibleName
- # Find nodes with this computed role.
- optional string role
- returns
- # A list of `Accessibility.AXNode` matching the specified attributes,
- # including nodes that are ignored for accessibility.
- array of AXNode nodes
-
- # The loadComplete event mirrors the load complete event sent by the browser to assistive
- # technology when the web page has finished loading.
- experimental event loadComplete
- parameters
- # New document root node.
- AXNode root
-
- # The nodesUpdated event is sent every time a previously requested node has changed the in tree.
- experimental event nodesUpdated
- parameters
- # Updated node data.
- array of AXNode nodes
-
-experimental domain Animation
- depends on Runtime
- depends on DOM
-
- # Animation instance.
- type Animation extends object
- properties
- # `Animation`'s id.
- string id
- # `Animation`'s name.
- string name
- # `Animation`'s internal paused state.
- boolean pausedState
- # `Animation`'s play state.
- string playState
- # `Animation`'s playback rate.
- number playbackRate
- # `Animation`'s start time.
- # Milliseconds for time based animations and
- # percentage [0 - 100] for scroll driven animations
- # (i.e. when viewOrScrollTimeline exists).
- number startTime
- # `Animation`'s current time.
- number currentTime
- # Animation type of `Animation`.
- enum type
- CSSTransition
- CSSAnimation
- WebAnimation
- # `Animation`'s source animation node.
- optional AnimationEffect source
- # A unique ID for `Animation` representing the sources that triggered this CSS
- # animation/transition.
- optional string cssId
- # View or scroll timeline
- optional ViewOrScrollTimeline viewOrScrollTimeline
-
- # Timeline instance
- type ViewOrScrollTimeline extends object
- properties
- # Scroll container node
- optional DOM.BackendNodeId sourceNodeId
- # Represents the starting scroll position of the timeline
- # as a length offset in pixels from scroll origin.
- optional number startOffset
- # Represents the ending scroll position of the timeline
- # as a length offset in pixels from scroll origin.
- optional number endOffset
- # The element whose principal box's visibility in the
- # scrollport defined the progress of the timeline.
- # Does not exist for animations with ScrollTimeline
- optional DOM.BackendNodeId subjectNodeId
- # Orientation of the scroll
- DOM.ScrollOrientation axis
-
- # AnimationEffect instance
- type AnimationEffect extends object
- properties
- # `AnimationEffect`'s delay.
- number delay
- # `AnimationEffect`'s end delay.
- number endDelay
- # `AnimationEffect`'s iteration start.
- number iterationStart
- # `AnimationEffect`'s iterations.
- number iterations
- # `AnimationEffect`'s iteration duration.
- # Milliseconds for time based animations and
- # percentage [0 - 100] for scroll driven animations
- # (i.e. when viewOrScrollTimeline exists).
- number duration
- # `AnimationEffect`'s playback direction.
- string direction
- # `AnimationEffect`'s fill mode.
- string fill
- # `AnimationEffect`'s target node.
- optional DOM.BackendNodeId backendNodeId
- # `AnimationEffect`'s keyframes.
- optional KeyframesRule keyframesRule
- # `AnimationEffect`'s timing function.
- string easing
-
- # Keyframes Rule
- type KeyframesRule extends object
- properties
- # CSS keyframed animation's name.
- optional string name
- # List of animation keyframes.
- array of KeyframeStyle keyframes
-
- # Keyframe Style
- type KeyframeStyle extends object
- properties
- # Keyframe's time offset.
- string offset
- # `AnimationEffect`'s timing function.
- string easing
-
- # Disables animation domain notifications.
- command disable
-
- # Enables animation domain notifications.
- command enable
-
- # Returns the current time of the an animation.
- command getCurrentTime
- parameters
- # Id of animation.
- string id
- returns
- # Current time of the page.
- number currentTime
-
- # Gets the playback rate of the document timeline.
- command getPlaybackRate
- returns
- # Playback rate for animations on page.
- number playbackRate
-
- # Releases a set of animations to no longer be manipulated.
- command releaseAnimations
- parameters
- # List of animation ids to seek.
- array of string animations
-
- # Gets the remote object of the Animation.
- command resolveAnimation
- parameters
- # Animation id.
- string animationId
- returns
- # Corresponding remote object.
- Runtime.RemoteObject remoteObject
-
- # Seek a set of animations to a particular time within each animation.
- command seekAnimations
- parameters
- # List of animation ids to seek.
- array of string animations
- # Set the current time of each animation.
- number currentTime
-
- # Sets the paused state of a set of animations.
- command setPaused
- parameters
- # Animations to set the pause state of.
- array of string animations
- # Paused state to set to.
- boolean paused
-
- # Sets the playback rate of the document timeline.
- command setPlaybackRate
- parameters
- # Playback rate for animations on page
- number playbackRate
-
- # Sets the timing of an animation node.
- command setTiming
- parameters
- # Animation id.
- string animationId
- # Duration of the animation.
- number duration
- # Delay of the animation.
- number delay
-
- # Event for when an animation has been cancelled.
- event animationCanceled
- parameters
- # Id of the animation that was cancelled.
- string id
-
- # Event for each animation that has been created.
- event animationCreated
- parameters
- # Id of the animation that was created.
- string id
-
- # Event for animation that has been started.
- event animationStarted
- parameters
- # Animation that was started.
- Animation animation
-
- # Event for animation that has been updated.
- event animationUpdated
- parameters
- # Animation that was updated.
- Animation animation
-
-# Audits domain allows investigation of page violations and possible improvements.
-experimental domain Audits
- depends on Network
-
- # Information about a cookie that is affected by an inspector issue.
- type AffectedCookie extends object
- properties
- # The following three properties uniquely identify a cookie
- string name
- string path
- string domain
-
- # Information about a request that is affected by an inspector issue.
- type AffectedRequest extends object
- properties
- # The unique request id.
- optional Network.RequestId requestId
- string url
-
- # Information about the frame affected by an inspector issue.
- type AffectedFrame extends object
- properties
- Page.FrameId frameId
-
- type CookieExclusionReason extends string
- enum
- ExcludeSameSiteUnspecifiedTreatedAsLax
- ExcludeSameSiteNoneInsecure
- ExcludeSameSiteLax
- ExcludeSameSiteStrict
- ExcludeInvalidSameParty
- ExcludeSamePartyCrossPartyContext
- ExcludeDomainNonASCII
- ExcludeThirdPartyCookieBlockedInFirstPartySet
- ExcludeThirdPartyPhaseout
- ExcludePortMismatch
- ExcludeSchemeMismatch
-
- type CookieWarningReason extends string
- enum
- WarnSameSiteUnspecifiedCrossSiteContext
- WarnSameSiteNoneInsecure
- WarnSameSiteUnspecifiedLaxAllowUnsafe
- WarnSameSiteStrictLaxDowngradeStrict
- WarnSameSiteStrictCrossDowngradeStrict
- WarnSameSiteStrictCrossDowngradeLax
- WarnSameSiteLaxCrossDowngradeStrict
- WarnSameSiteLaxCrossDowngradeLax
- WarnAttributeValueExceedsMaxSize
- WarnDomainNonASCII
- WarnThirdPartyPhaseout
- WarnCrossSiteRedirectDowngradeChangesInclusion
- WarnDeprecationTrialMetadata
- WarnThirdPartyCookieHeuristic
-
- type CookieOperation extends string
- enum
- SetCookie
- ReadCookie
-
- # Represents the category of insight that a cookie issue falls under.
- type InsightType extends string
- enum
- # Cookie domain has an entry in third-party cookie migration readiness
- # list:
- # https://github.com/privacysandbox/privacy-sandbox-dev-support/blob/main/3pc-migration-readiness.md
- GitHubResource
- # Cookie is exempted due to a grace period:
- # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
- GracePeriod
- # Cookie is exempted due a heuristics-based exemptiuon:
- # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/heuristics-based-exception
- Heuristics
-
- # Information about the suggested solution to a cookie issue.
- type CookieIssueInsight extends object
- properties
- InsightType type
- # Link to table entry in third-party cookie migration readiness list.
- optional string tableEntryUrl
-
- # 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.
- type CookieIssueDetails extends object
- properties
- # If AffectedCookie is not set then rawCookieLine contains the raw
- # Set-Cookie header string. This hints at a problem where the
- # cookie line is syntactically or semantically malformed in a way
- # that no valid cookie could be created.
- optional AffectedCookie cookie
- optional string rawCookieLine
- array of CookieWarningReason cookieWarningReasons
- array of CookieExclusionReason cookieExclusionReasons
- # Optionally identifies the site-for-cookies and the cookie url, which
- # may be used by the front-end as additional context.
- CookieOperation operation
- optional string siteForCookies
- optional string cookieUrl
- optional AffectedRequest request
- # The recommended solution to the issue.
- optional CookieIssueInsight insight
-
- type MixedContentResolutionStatus extends string
- enum
- MixedContentBlocked
- MixedContentAutomaticallyUpgraded
- MixedContentWarning
-
- type MixedContentResourceType extends string
- enum
- AttributionSrc
- Audio
- Beacon
- CSPReport
- Download
- EventSource
- Favicon
- Font
- Form
- Frame
- Image
- Import
- JSON
- Manifest
- Ping
- PluginData
- PluginResource
- Prefetch
- Resource
- Script
- ServiceWorker
- SharedWorker
- SpeculationRules
- Stylesheet
- Track
- Video
- Worker
- XMLHttpRequest
- XSLT
-
- type MixedContentIssueDetails extends object
- properties
- # The type of resource causing the mixed content issue (css, js, iframe,
- # form,...). Marked as optional because it is mapped to from
- # blink::mojom::RequestContextType, which will be replaced
- # by network::mojom::RequestDestination
- optional MixedContentResourceType resourceType
- # The way the mixed content issue is being resolved.
- MixedContentResolutionStatus resolutionStatus
- # The unsafe http url causing the mixed content issue.
- string insecureURL
- # The url responsible for the call to an unsafe url.
- string mainResourceURL
- # The mixed content request.
- # Does not always exist (e.g. for unsafe form submission urls).
- optional AffectedRequest request
- # Optional because not every mixed content issue is necessarily linked to a frame.
- optional AffectedFrame frame
-
- # Enum indicating the reason a response has been blocked. These reasons are
- # refinements of the net error BLOCKED_BY_RESPONSE.
- type BlockedByResponseReason extends string
- enum
- CoepFrameResourceNeedsCoepHeader
- CoopSandboxedIFrameCannotNavigateToCoopPage
- CorpNotSameOrigin
- CorpNotSameOriginAfterDefaultedToSameOriginByCoep
- CorpNotSameOriginAfterDefaultedToSameOriginByDip
- CorpNotSameOriginAfterDefaultedToSameOriginByCoepAndDip
- CorpNotSameSite
- SRIMessageSignatureMismatch
-
- # 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.
- type BlockedByResponseIssueDetails extends object
- properties
- AffectedRequest request
- optional AffectedFrame parentFrame
- optional AffectedFrame blockedFrame
- BlockedByResponseReason reason
-
- type HeavyAdResolutionStatus extends string
- enum
- HeavyAdBlocked
- HeavyAdWarning
-
- type HeavyAdReason extends string
- enum
- NetworkTotalLimit
- CpuTotalLimit
- CpuPeakLimit
-
- type HeavyAdIssueDetails extends object
- properties
- # The resolution status, either blocking the content or warning.
- HeavyAdResolutionStatus resolution
- # The reason the ad was blocked, total network or cpu or peak cpu.
- HeavyAdReason reason
- # The frame that was blocked.
- AffectedFrame frame
-
- type ContentSecurityPolicyViolationType extends string
- enum
- kInlineViolation
- kEvalViolation
- kURLViolation
- kSRIViolation
- kTrustedTypesSinkViolation
- kTrustedTypesPolicyViolation
- kWasmEvalViolation
-
- type SourceCodeLocation extends object
- properties
- optional Runtime.ScriptId scriptId
- string url
- integer lineNumber
- integer columnNumber
-
- type ContentSecurityPolicyIssueDetails extends object
- properties
- # The url not included in allowed sources.
- optional string blockedURL
- # Specific directive that is violated, causing the CSP issue.
- string violatedDirective
- boolean isReportOnly
- ContentSecurityPolicyViolationType contentSecurityPolicyViolationType
- optional AffectedFrame frameAncestor
- optional SourceCodeLocation sourceCodeLocation
- optional DOM.BackendNodeId violatingNodeId
-
- type SharedArrayBufferIssueType extends string
- enum
- TransferIssue
- CreationIssue
-
- # Details for a issue arising from an SAB being instantiated in, or
- # transferred to a context that is not cross-origin isolated.
- type SharedArrayBufferIssueDetails extends object
- properties
- SourceCodeLocation sourceCodeLocation
- boolean isWarning
- SharedArrayBufferIssueType type
-
- type LowTextContrastIssueDetails extends object
- properties
- DOM.BackendNodeId violatingNodeId
- string violatingNodeSelector
- number contrastRatio
- number thresholdAA
- number thresholdAAA
- string fontSize
- string fontWeight
-
- # Details for a CORS related issue, e.g. a warning or error related to
- # CORS RFC1918 enforcement.
- type CorsIssueDetails extends object
- properties
- Network.CorsErrorStatus corsErrorStatus
- boolean isWarning
- AffectedRequest request
- optional SourceCodeLocation location
- optional string initiatorOrigin
- optional Network.IPAddressSpace resourceIPAddressSpace
- optional Network.ClientSecurityState clientSecurityState
-
- type AttributionReportingIssueType extends string
- enum
- PermissionPolicyDisabled
- UntrustworthyReportingOrigin
- InsecureContext
- # TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
- InvalidHeader
- InvalidRegisterTriggerHeader
- SourceAndTriggerHeaders
- SourceIgnored
- TriggerIgnored
- OsSourceIgnored
- OsTriggerIgnored
- InvalidRegisterOsSourceHeader
- InvalidRegisterOsTriggerHeader
- WebAndOsHeaders
- NoWebOrOsSupport
- NavigationRegistrationWithoutTransientUserActivation
- InvalidInfoHeader
- NoRegisterSourceHeader
- NoRegisterTriggerHeader
- NoRegisterOsSourceHeader
- NoRegisterOsTriggerHeader
- NavigationRegistrationUniqueScopeAlreadySet
-
- type SharedDictionaryError extends string
- enum
- UseErrorCrossOriginNoCorsRequest
- UseErrorDictionaryLoadFailure
- UseErrorMatchingDictionaryNotUsed
- UseErrorUnexpectedContentDictionaryHeader
- WriteErrorCossOriginNoCorsRequest
- WriteErrorDisallowedBySettings
- WriteErrorExpiredResponse
- WriteErrorFeatureDisabled
- WriteErrorInsufficientResources
- WriteErrorInvalidMatchField
- WriteErrorInvalidStructuredHeader
- WriteErrorNavigationRequest
- WriteErrorNoMatchField
- WriteErrorNonListMatchDestField
- WriteErrorNonSecureContext
- WriteErrorNonStringIdField
- WriteErrorNonStringInMatchDestList
- WriteErrorNonStringMatchField
- WriteErrorNonTokenTypeField
- WriteErrorRequestAborted
- WriteErrorShuttingDown
- WriteErrorTooLongIdField
- WriteErrorUnsupportedType
-
- type SRIMessageSignatureError extends string
- enum
- MissingSignatureHeader
- MissingSignatureInputHeader
- InvalidSignatureHeader
- InvalidSignatureInputHeader
- SignatureHeaderValueIsNotByteSequence
- SignatureHeaderValueIsParameterized
- SignatureHeaderValueIsIncorrectLength
- SignatureInputHeaderMissingLabel
- SignatureInputHeaderValueNotInnerList
- SignatureInputHeaderValueMissingComponents
- SignatureInputHeaderInvalidComponentType
- SignatureInputHeaderInvalidComponentName
- SignatureInputHeaderInvalidHeaderComponentParameter
- SignatureInputHeaderInvalidDerivedComponentParameter
- SignatureInputHeaderKeyIdLength
- SignatureInputHeaderInvalidParameter
- SignatureInputHeaderMissingRequiredParameters
- ValidationFailedSignatureExpired
- ValidationFailedInvalidLength
- ValidationFailedSignatureMismatch
- ValidationFailedIntegrityMismatch
-
- type UnencodedDigestError extends string
- enum
- MalformedDictionary
- UnknownAlgorithm
- IncorrectDigestType
- IncorrectDigestLength
-
- # Details for issues around "Attribution Reporting API" usage.
- # Explainer: https://github.com/WICG/attribution-reporting-api
- type AttributionReportingIssueDetails extends object
- properties
- AttributionReportingIssueType violationType
- optional AffectedRequest request
- optional DOM.BackendNodeId violatingNodeId
- optional string invalidParameter
-
-# Details for issues about documents in Quirks Mode
-# or Limited Quirks Mode that affects page layouting.
- type QuirksModeIssueDetails extends object
- properties
- # If false, it means the document's mode is "quirks"
- # instead of "limited-quirks".
- boolean isLimitedQuirksMode
- DOM.BackendNodeId documentNodeId
- string url
- Page.FrameId frameId
- Network.LoaderId loaderId
-
- deprecated type NavigatorUserAgentIssueDetails extends object
- properties
- string url
- optional SourceCodeLocation location
-
- type SharedDictionaryIssueDetails extends object
- properties
- SharedDictionaryError sharedDictionaryError
- AffectedRequest request
-
- type SRIMessageSignatureIssueDetails extends object
- properties
- SRIMessageSignatureError error
- string signatureBase
- array of string integrityAssertions
- AffectedRequest request
-
- type UnencodedDigestIssueDetails extends object
- properties
- UnencodedDigestError error
- AffectedRequest request
-
- type GenericIssueErrorType extends string
- enum
- FormLabelForNameError
- FormDuplicateIdForInputError
- FormInputWithNoLabelError
- FormAutocompleteAttributeEmptyError
- FormEmptyIdAndNameAttributesForInputError
- FormAriaLabelledByToNonExistingId
- FormInputAssignedAutocompleteValueToIdOrNameAttributeError
- FormLabelHasNeitherForNorNestedInput
- FormLabelForMatchesNonExistingIdError
- FormInputHasWrongButWellIntendedAutocompleteValueError
- ResponseWasBlockedByORB
-
- # Depending on the concrete errorType, different properties are set.
- type GenericIssueDetails extends object
- properties
- # Issues with the same errorType are aggregated in the frontend.
- GenericIssueErrorType errorType
- optional Page.FrameId frameId
- optional DOM.BackendNodeId violatingNodeId
- optional string violatingNodeAttribute
- optional AffectedRequest request
-
- # This issue tracks information needed to print a deprecation message.
- # https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
- type DeprecationIssueDetails extends object
- properties
- optional AffectedFrame affectedFrame
- SourceCodeLocation sourceCodeLocation
- # One of the deprecation names from third_party/blink/renderer/core/frame/deprecation/deprecation.json5
- string type
-
- # This issue warns about sites in the redirect chain of a finished navigation
- # that may be flagged as trackers and have their state cleared if they don't
- # receive a user interaction. Note that in this context 'site' means eTLD+1.
- # For example, if the URL `https://example.test:80/bounce` was in the
- # redirect chain, the site reported would be `example.test`.
- type BounceTrackingIssueDetails extends object
- properties
- array of string trackingSites
-
- # This issue warns about third-party sites that are accessing cookies on the
- # current page, and have been permitted due to having a global metadata grant.
- # Note that in this context 'site' means eTLD+1. For example, if the URL
- # `https://example.test:80/web_page` was accessing cookies, the site reported
- # would be `example.test`.
- type CookieDeprecationMetadataIssueDetails extends object
- properties
- array of string allowedSites
- number optOutPercentage
- boolean isOptOutTopLevel
- CookieOperation operation
-
- type ClientHintIssueReason extends string
- enum
- # Items in the accept-ch meta tag allow list must be valid origins.
- # No special values (e.g. self, none, and *) are permitted.
- MetaTagAllowListInvalidOrigin
- # Only accept-ch meta tags in the original HTML sent from the server
- # are respected. Any injected via javascript (or other means) are ignored.
- MetaTagModifiedHTML
-
- type FederatedAuthRequestIssueDetails extends object
- properties
- FederatedAuthRequestIssueReason federatedAuthRequestIssueReason
-
- # 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.
- type FederatedAuthRequestIssueReason extends string
- enum
- ShouldEmbargo
- TooManyRequests
- WellKnownHttpNotFound
- WellKnownNoResponse
- WellKnownInvalidResponse
- WellKnownListEmpty
- WellKnownInvalidContentType
- ConfigNotInWellKnown
- WellKnownTooBig
- ConfigHttpNotFound
- ConfigNoResponse
- ConfigInvalidResponse
- ConfigInvalidContentType
- ClientMetadataHttpNotFound
- ClientMetadataNoResponse
- ClientMetadataInvalidResponse
- ClientMetadataInvalidContentType
- IdpNotPotentiallyTrustworthy
- DisabledInSettings
- DisabledInFlags
- ErrorFetchingSignin
- InvalidSigninResponse
- AccountsHttpNotFound
- AccountsNoResponse
- AccountsInvalidResponse
- AccountsListEmpty
- AccountsInvalidContentType
- IdTokenHttpNotFound
- IdTokenNoResponse
- IdTokenInvalidResponse
- IdTokenIdpErrorResponse
- IdTokenCrossSiteIdpErrorResponse
- IdTokenInvalidRequest
- IdTokenInvalidContentType
- ErrorIdToken
- Canceled
- RpPageNotVisible
- SilentMediationFailure
- ThirdPartyCookiesBlocked
- NotSignedInWithIdp
- MissingTransientUserActivation
- ReplacedByActiveMode
- InvalidFieldsSpecified
- RelyingPartyOriginIsOpaque
- TypeNotMatching
- UiDismissedNoEmbargo
- CorsError
- SuppressedBySegmentationPlatform
-
- type FederatedAuthUserInfoRequestIssueDetails extends object
- properties
- FederatedAuthUserInfoRequestIssueReason federatedAuthUserInfoRequestIssueReason
-
- # Represents the failure reason when a getUserInfo() call fails.
- # Should be updated alongside FederatedAuthUserInfoRequestResult in
- # third_party/blink/public/mojom/devtools/inspector_issue.mojom.
- type FederatedAuthUserInfoRequestIssueReason extends string
- enum
- NotSameOrigin
- NotIframe
- NotPotentiallyTrustworthy
- NoApiPermission
- NotSignedInWithIdp
- NoAccountSharingPermission
- InvalidConfigOrWellKnown
- InvalidAccountsResponse
- NoReturningUserFromFetchedAccounts
-
- # This issue tracks client hints related issues. It's used to deprecate old
- # features, encourage the use of new ones, and provide general guidance.
- type ClientHintIssueDetails extends object
- properties
- SourceCodeLocation sourceCodeLocation
- ClientHintIssueReason clientHintIssueReason
-
- type FailedRequestInfo extends object
- properties
- # The URL that failed to load.
- string url
- # The failure message for the failed request.
- string failureMessage
- optional Network.RequestId requestId
-
- type PartitioningBlobURLInfo extends string
- enum
- BlockedCrossPartitionFetching
- EnforceNoopenerForNavigation
-
- type PartitioningBlobURLIssueDetails extends object
- properties
- # The BlobURL that failed to load.
- string url
- # Additional information about the Partitioning Blob URL issue.
- PartitioningBlobURLInfo partitioningBlobURLInfo
-
- type ElementAccessibilityIssueReason extends string
- enum
- DisallowedSelectChild
- DisallowedOptGroupChild
- NonPhrasingContentOptionChild
- InteractiveContentOptionChild
- InteractiveContentLegendChild
- InteractiveContentSummaryDescendant
-
- # This issue warns about errors in the select or summary element content model.
- type ElementAccessibilityIssueDetails extends object
- properties
- DOM.BackendNodeId nodeId
- ElementAccessibilityIssueReason elementAccessibilityIssueReason
- boolean hasDisallowedAttributes
-
- type StyleSheetLoadingIssueReason extends string
- enum
- LateImportRule
- RequestFailed
-
- # This issue warns when a referenced stylesheet couldn't be loaded.
- type StylesheetLoadingIssueDetails extends object
- properties
- # Source code position that referenced the failing stylesheet.
- SourceCodeLocation sourceCodeLocation
- # Reason why the stylesheet couldn't be loaded.
- StyleSheetLoadingIssueReason styleSheetLoadingIssueReason
- # Contains additional info when the failure was due to a request.
- optional FailedRequestInfo failedRequestInfo
-
- type PropertyRuleIssueReason extends string
- enum
- InvalidSyntax
- InvalidInitialValue
- InvalidInherits
- InvalidName
-
- # This issue warns about errors in property rules that lead to property
- # registrations being ignored.
- type PropertyRuleIssueDetails extends object
- properties
- # Source code position of the property rule.
- SourceCodeLocation sourceCodeLocation
- # Reason why the property rule was discarded.
- PropertyRuleIssueReason propertyRuleIssueReason
- # The value of the property rule property that failed to parse
- optional string propertyValue
-
- type UserReidentificationIssueType extends string
- enum
- BlockedFrameNavigation
- BlockedSubresource
- NoisedCanvasReadback
-
- # This issue warns about uses of APIs that may be considered misuse to
- # re-identify users.
- type UserReidentificationIssueDetails extends object
- properties
- UserReidentificationIssueType type
- # Applies to BlockedFrameNavigation and BlockedSubresource issue types.
- optional AffectedRequest request
- # Applies to NoisedCanvasReadback issue type.
- optional SourceCodeLocation sourceCodeLocation
-
- # 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.
- type InspectorIssueCode extends string
- enum
- CookieIssue
- MixedContentIssue
- BlockedByResponseIssue
- HeavyAdIssue
- ContentSecurityPolicyIssue
- SharedArrayBufferIssue
- LowTextContrastIssue
- CorsIssue
- AttributionReportingIssue
- QuirksModeIssue
- PartitioningBlobURLIssue
- # Deprecated
- NavigatorUserAgentIssue
- GenericIssue
- DeprecationIssue
- ClientHintIssue
- FederatedAuthRequestIssue
- BounceTrackingIssue
- CookieDeprecationMetadataIssue
- StylesheetLoadingIssue
- FederatedAuthUserInfoRequestIssue
- PropertyRuleIssue
- SharedDictionaryIssue
- ElementAccessibilityIssue
- SRIMessageSignatureIssue
- UnencodedDigestIssue
- UserReidentificationIssue
-
- # 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.
- type InspectorIssueDetails extends object
- properties
- optional CookieIssueDetails cookieIssueDetails
- optional MixedContentIssueDetails mixedContentIssueDetails
- optional BlockedByResponseIssueDetails blockedByResponseIssueDetails
- optional HeavyAdIssueDetails heavyAdIssueDetails
- optional ContentSecurityPolicyIssueDetails contentSecurityPolicyIssueDetails
- optional SharedArrayBufferIssueDetails sharedArrayBufferIssueDetails
- optional LowTextContrastIssueDetails lowTextContrastIssueDetails
- optional CorsIssueDetails corsIssueDetails
- optional AttributionReportingIssueDetails attributionReportingIssueDetails
- optional QuirksModeIssueDetails quirksModeIssueDetails
- optional PartitioningBlobURLIssueDetails partitioningBlobURLIssueDetails
- deprecated optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
- optional GenericIssueDetails genericIssueDetails
- optional DeprecationIssueDetails deprecationIssueDetails
- optional ClientHintIssueDetails clientHintIssueDetails
- optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
- optional BounceTrackingIssueDetails bounceTrackingIssueDetails
- optional CookieDeprecationMetadataIssueDetails cookieDeprecationMetadataIssueDetails
- optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
- optional PropertyRuleIssueDetails propertyRuleIssueDetails
- optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
- optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
- optional ElementAccessibilityIssueDetails elementAccessibilityIssueDetails
- optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
- optional UnencodedDigestIssueDetails unencodedDigestIssueDetails
- optional UserReidentificationIssueDetails userReidentificationIssueDetails
-
- # A unique id for a DevTools inspector issue. Allows other entities (e.g.
- # exceptions, CDP message, console messages, etc.) to reference an issue.
- type IssueId extends string
-
- # An inspector issue reported from the back-end.
- type InspectorIssue extends object
- properties
- InspectorIssueCode code
- InspectorIssueDetails details
- # A unique id for this issue. May be omitted if no other entity (e.g.
- # exception, CDP message, etc.) is referencing this issue.
- optional IssueId issueId
-
- # Returns the response body and size if it were re-encoded with the specified settings. Only
- # applies to images.
- command getEncodedResponse
- parameters
- # Identifier of the network request to get content for.
- Network.RequestId requestId
- # The encoding to use.
- enum encoding
- webp
- jpeg
- png
- # The quality of the encoding (0-1). (defaults to 1)
- optional number quality
- # Whether to only return the size information (defaults to false).
- optional boolean sizeOnly
- returns
- # The encoded body as a base64 string. Omitted if sizeOnly is true.
- optional binary body
- # Size before re-encoding.
- integer originalSize
- # Size after re-encoding.
- integer encodedSize
-
- # Disables issues domain, prevents further issues from being reported to the client.
- command disable
-
- # Enables issues domain, sends the issues collected so far to the client by means of the
- # `issueAdded` event.
- command enable
-
- # Runs the contrast check for the target page. Found issues are reported
- # using Audits.issueAdded event.
- command checkContrast
- parameters
- # Whether to report WCAG AAA level issues. Default is false.
- optional boolean reportAAA
-
- # Runs the form issues check for the target page. Found issues are reported
- # using Audits.issueAdded event.
- command checkFormsIssues
- returns
- array of GenericIssueDetails formIssues
-
- event issueAdded
- parameters
- InspectorIssue issue
-
-# Defines commands and events for browser extensions.
-experimental domain Extensions
- # Storage areas.
- type StorageArea extends string
- enum
- session
- local
- sync
- managed
- # Installs an unpacked extension from the filesystem similar to
- # --load-extension CLI flags. Returns extension ID once the extension
- # has been installed. Available if the client is connected using the
- # --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
- # flag is set.
- command loadUnpacked
- parameters
- # Absolute file path.
- string path
- returns
- # Extension id.
- string id
- # Uninstalls an unpacked extension (others not supported) from the profile.
- # Available if the client is connected using the --remote-debugging-pipe flag
- # and the --enable-unsafe-extension-debugging.
- command uninstall
- parameters
- # Extension id.
- string id
- # Gets data from extension storage in the given `storageArea`. If `keys` is
- # specified, these are used to filter the result.
- command getStorageItems
- parameters
- # ID of extension.
- string id
- # StorageArea to retrieve data from.
- StorageArea storageArea
- # Keys to retrieve.
- optional array of string keys
- returns
- object data
- # Removes `keys` from extension storage in the given `storageArea`.
- command removeStorageItems
- parameters
- # ID of extension.
- string id
- # StorageArea to remove data from.
- StorageArea storageArea
- # Keys to remove.
- array of string keys
- # Clears extension storage in the given `storageArea`.
- command clearStorageItems
- parameters
- # ID of extension.
- string id
- # StorageArea to remove data from.
- StorageArea storageArea
- # Sets `values` in extension storage in the given `storageArea`. The provided `values`
- # will be merged with existing values in the storage area.
- command setStorageItems
- parameters
- # ID of extension.
- string id
- # StorageArea to set data in.
- StorageArea storageArea
- # Values to set.
- object values
-
-# Defines commands and events for Autofill.
-experimental domain Autofill
- type CreditCard extends object
- properties
- # 16-digit credit card number.
- string number
- # Name of the credit card owner.
- string name
- # 2-digit expiry month.
- string expiryMonth
- # 4-digit expiry year.
- string expiryYear
- # 3-digit card verification code.
- string cvc
-
- type AddressField extends object
- properties
- # address field name, for example GIVEN_NAME.
- string name
- # address field value, for example Jon Doe.
- string value
-
- # A list of address fields.
- type AddressFields extends object
- properties
- array of AddressField fields
-
- type Address extends object
- properties
- # fields and values defining an address.
- array of AddressField fields
-
- # Defines how an address can be displayed like in chrome://settings/addresses.
- # Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
- # The following address UI for instance:
- # [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
- # should allow the receiver to render:
- # Jon Doe
- # Munich 81456
- type AddressUI extends object
- properties
- # A two dimension array containing the representation of values from an address profile.
- array of AddressFields addressFields
-
- # Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
- type FillingStrategy extends string
- enum
- autocompleteAttribute
- autofillInferred
-
- type FilledField extends object
- properties
- # The type of the field, e.g text, password etc.
- string htmlType
- # the html id
- string id
- # the html name
- string name
- # the field value
- string value
- # The actual field type, e.g FAMILY_NAME
- string autofillType
- # The filling strategy
- FillingStrategy fillingStrategy
- # The frame the field belongs to
- Page.FrameId frameId
- # The form field's DOM node
- DOM.BackendNodeId fieldId
-
- # Emitted when an address form is filled.
- event addressFormFilled
- parameters
- # Information about the fields that were filled
- array of FilledField filledFields
- # An UI representation of the address used to fill the form.
- # Consists of a 2D array where each child represents an address/profile line.
- AddressUI addressUi
-
- # Trigger autofill on a form identified by the fieldId.
- # If the field and related form cannot be autofilled, returns an error.
- command trigger
- parameters
- # Identifies a field that serves as an anchor for autofill.
- DOM.BackendNodeId fieldId
- # Identifies the frame that field belongs to.
- optional Page.FrameId frameId
- # Credit card information to fill out the form. Credit card data is not saved.
- CreditCard card
-
- # Set addresses so that developers can verify their forms implementation.
- command setAddresses
- # Test addresses for the available countries.
- parameters
- array of Address addresses
-
- # Disables autofill domain notifications.
- command disable
-
- # Enables autofill domain notifications.
- command enable
-
-# Defines events for background web platform features.
-experimental domain BackgroundService
- # The Background Service that will be associated with the commands/events.
- # Every Background Service operates independently, but they share the same
- # API.
- type ServiceName extends string
- enum
- backgroundFetch
- backgroundSync
- pushMessaging
- notifications
- paymentHandler
- periodicBackgroundSync
-
- # Enables event updates for the service.
- command startObserving
- parameters
- ServiceName service
-
- # Disables event updates for the service.
- command stopObserving
- parameters
- ServiceName service
-
- # Set the recording state for the service.
- command setRecording
- parameters
- boolean shouldRecord
- ServiceName service
-
- # Clears all stored data for the service.
- command clearEvents
- parameters
- ServiceName service
-
- # Called when the recording state for the service has been updated.
- event recordingStateChanged
- parameters
- boolean isRecording
- ServiceName service
-
- # A key-value pair for additional event information to pass along.
- type EventMetadata extends object
- properties
- string key
- string value
-
- type BackgroundServiceEvent extends object
- properties
- # Timestamp of the event (in seconds).
- Network.TimeSinceEpoch timestamp
- # The origin this event belongs to.
- string origin
- # The Service Worker ID that initiated the event.
- ServiceWorker.RegistrationID serviceWorkerRegistrationId
- # The Background Service this event belongs to.
- ServiceName service
- # A description of the event.
- string eventName
- # An identifier that groups related events together.
- string instanceId
- # A list of event-specific information.
- array of EventMetadata eventMetadata
- # Storage key this event belongs to.
- string storageKey
-
- # Called with all existing backgroundServiceEvents when enabled, and all new
- # events afterwards if enabled and recording.
- event backgroundServiceEventReceived
- parameters
- BackgroundServiceEvent backgroundServiceEvent
-
-# The Browser domain defines methods and events for browser managing.
-domain Browser
- experimental type BrowserContextID extends string
- experimental type WindowID extends integer
-
- # The state of the browser window.
- experimental type WindowState extends string
- enum
- normal
- minimized
- maximized
- fullscreen
-
- # Browser window bounds information
- experimental type Bounds extends object
- properties
- # The offset from the left edge of the screen to the window in pixels.
- optional integer left
- # The offset from the top edge of the screen to the window in pixels.
- optional integer top
- # The window width in pixels.
- optional integer width
- # The window height in pixels.
- optional integer height
- # The window state. Default to normal.
- optional WindowState windowState
-
- experimental type PermissionType extends string
- enum
- ar
- audioCapture
- automaticFullscreen
- backgroundFetch
- backgroundSync
- cameraPanTiltZoom
- capturedSurfaceControl
- clipboardReadWrite
- clipboardSanitizedWrite
- displayCapture
- durableStorage
- geolocation
- handTracking
- idleDetection
- keyboardLock
- localFonts
- localNetworkAccess
- midi
- midiSysex
- nfc
- notifications
- paymentHandler
- periodicBackgroundSync
- pointerLock
- protectedMediaIdentifier
- sensors
- smartCard
- speakerSelection
- storageAccess
- topLevelStorageAccess
- videoCapture
- vr
- wakeLockScreen
- wakeLockSystem
- webAppInstallation
- webPrinting
- windowManagement
-
- experimental type PermissionSetting extends string
- enum
- granted
- denied
- prompt
-
- # Definition of PermissionDescriptor defined in the Permissions API:
- # https://w3c.github.io/permissions/#dom-permissiondescriptor.
- experimental type PermissionDescriptor extends object
- properties
- # Name of permission.
- # See https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/permissions/permission_descriptor.idl for valid permission names.
- string name
- # For "midi" permission, may also specify sysex control.
- optional boolean sysex
- # For "push" permission, may specify userVisibleOnly.
- # Note that userVisibleOnly = true is the only currently supported type.
- optional boolean userVisibleOnly
- # For "clipboard" permission, may specify allowWithoutSanitization.
- optional boolean allowWithoutSanitization
- # For "fullscreen" permission, must specify allowWithoutGesture:true.
- optional boolean allowWithoutGesture
- # For "camera" permission, may specify panTiltZoom.
- optional boolean panTiltZoom
-
- # Browser command ids used by executeBrowserCommand.
- experimental type BrowserCommandId extends string
- enum
- openTabSearch
- closeTabSearch
- openGlic
-
- # Set permission settings for given origin.
- experimental command setPermission
- parameters
- # Descriptor of permission to override.
- PermissionDescriptor permission
- # Setting of the permission.
- PermissionSetting setting
- # Origin the permission applies to, all origins if not specified.
- optional string origin
- # Context to override. When omitted, default browser context is used.
- optional BrowserContextID browserContextId
-
- # Grant specific permissions to the given origin and reject all others.
- experimental command grantPermissions
- parameters
- array of PermissionType permissions
- # Origin the permission applies to, all origins if not specified.
- optional string origin
- # BrowserContext to override permissions. When omitted, default browser context is used.
- optional BrowserContextID browserContextId
-
- # Reset all permission management for all origins.
- command resetPermissions
- parameters
- # BrowserContext to reset permissions. When omitted, default browser context is used.
- optional BrowserContextID browserContextId
-
- # Set the behavior when downloading a file.
- experimental command setDownloadBehavior
- parameters
- # Whether to allow all or deny all download requests, or use default Chrome behavior if
- # available (otherwise deny). |allowAndName| allows download and names files according to
- # their download guids.
- enum behavior
- deny
- allow
- allowAndName
- default
- # BrowserContext to set download behavior. When omitted, default browser context is used.
- optional BrowserContextID browserContextId
- # The default path to save downloaded files to. This is required if behavior is set to 'allow'
- # or 'allowAndName'.
- optional string downloadPath
- # Whether to emit download events (defaults to false).
- optional boolean eventsEnabled
-
- # Cancel a download if in progress
- experimental command cancelDownload
- parameters
- # Global unique identifier of the download.
- string guid
- # BrowserContext to perform the action in. When omitted, default browser context is used.
- optional BrowserContextID browserContextId
-
- # Fired when page is about to start a download.
- experimental event downloadWillBegin
- parameters
- # Id of the frame that caused the download to begin.
- Page.FrameId frameId
- # Global unique identifier of the download.
- string guid
- # URL of the resource being downloaded.
- string url
- # Suggested file name of the resource (the actual name of the file saved on disk may differ).
- string suggestedFilename
-
- # Fired when download makes progress. Last call has |done| == true.
- experimental event downloadProgress
- parameters
- # Global unique identifier of the download.
- string guid
- # Total expected bytes to download.
- number totalBytes
- # Total bytes received.
- number receivedBytes
- # Download status.
- enum state
- inProgress
- completed
- canceled
- # If download is "completed", provides the path of the downloaded file.
- # Depending on the platform, it is not guaranteed to be set, nor the file
- # is guaranteed to exist.
- experimental optional string filePath
-
- # Close browser gracefully.
- command close
-
- # Crashes browser on the main thread.
- experimental command crash
-
- # Crashes GPU process.
- experimental command crashGpuProcess
-
- # Returns version information.
- command getVersion
- returns
- # Protocol version.
- string protocolVersion
- # Product name.
- string product
- # Product revision.
- string revision
- # User-Agent.
- string userAgent
- # V8 version.
- string jsVersion
-
- # Returns the command line switches for the browser process if, and only if
- # --enable-automation is on the commandline.
- experimental command getBrowserCommandLine
- returns
- # Commandline parameters
- array of string arguments
-
- # Chrome histogram bucket.
- experimental type Bucket extends object
- properties
- # Minimum value (inclusive).
- integer low
- # Maximum value (exclusive).
- integer high
- # Number of samples.
- integer count
-
- # Chrome histogram.
- experimental type Histogram extends object
- properties
- # Name.
- string name
- # Sum of sample values.
- integer sum
- # Total number of samples.
- integer count
- # Buckets.
- array of Bucket buckets
-
- # Get Chrome histograms.
- experimental command getHistograms
- parameters
- # Requested substring in name. Only histograms which have query as a
- # substring in their name are extracted. An empty or absent query returns
- # all histograms.
- optional string query
- # If true, retrieve delta since last delta call.
- optional boolean delta
-
- returns
- # Histograms.
- array of Histogram histograms
-
- # Get a Chrome histogram by name.
- experimental command getHistogram
- parameters
- # Requested histogram name.
- string name
- # If true, retrieve delta since last delta call.
- optional boolean delta
- returns
- # Histogram.
- Histogram histogram
-
- # Get position and size of the browser window.
- experimental command getWindowBounds
- parameters
- # Browser window id.
- WindowID windowId
- returns
- # Bounds information of the window. When window state is 'minimized', the restored window
- # position and size are returned.
- Bounds bounds
-
- # Get the browser window that contains the devtools target.
- experimental command getWindowForTarget
- parameters
- # Devtools agent host id. If called as a part of the session, associated targetId is used.
- optional Target.TargetID targetId
- returns
- # Browser window id.
- WindowID windowId
- # Bounds information of the window. When window state is 'minimized', the restored window
- # position and size are returned.
- Bounds bounds
-
- # Set position and/or size of the browser window.
- experimental command setWindowBounds
- parameters
- # Browser window id.
- WindowID windowId
- # New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
- # with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
- Bounds bounds
-
- # Set size of the browser contents resizing browser window as necessary.
- experimental command setContentsSize
- parameters
- # Browser window id.
- WindowID windowId
- # The window contents width in DIP. Assumes current width if omitted.
- # Must be specified if 'height' is omitted.
- optional integer width
- # The window contents height in DIP. Assumes current height if omitted.
- # Must be specified if 'width' is omitted.
- optional integer height
-
- # Set dock tile details, platform-specific.
- experimental command setDockTile
- parameters
- optional string badgeLabel
- # Png encoded image.
- optional binary image
-
- # Invoke custom browser commands used by telemetry.
- experimental command executeBrowserCommand
- parameters
- BrowserCommandId commandId
-
- # Allows a site to use privacy sandbox features that require enrollment
- # without the site actually being enrolled. Only supported on page targets.
- command addPrivacySandboxEnrollmentOverride
- parameters
- string url
-
- experimental type PrivacySandboxAPI extends string
- enum
- BiddingAndAuctionServices
- TrustedKeyValue
-
- # Configures encryption keys used with a given privacy sandbox API to talk
- # to a trusted coordinator. Since this is intended for test automation only,
- # coordinatorOrigin must be a .test domain. No existing coordinator
- # configuration for the origin may exist.
- command addPrivacySandboxCoordinatorKeyConfig
- parameters
- PrivacySandboxAPI api
- string coordinatorOrigin
- string keyConfig
- # BrowserContext to perform the action in. When omitted, default browser
- # context is used.
- optional BrowserContextID browserContextId
-
-
-# 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.
-experimental domain CSS
- depends on DOM
- depends on Page
-
- type StyleSheetId extends string
-
- # 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.
- type StyleSheetOrigin extends string
- enum
- injected
- user-agent
- inspector
- regular
-
- # CSS rule collection for a single pseudo style.
- type PseudoElementMatches extends object
- properties
- # Pseudo element type.
- DOM.PseudoType pseudoType
- # Pseudo element custom ident.
- optional string pseudoIdentifier
- # Matches of CSS rules applicable to the pseudo style.
- array of RuleMatch matches
-
- # CSS style coming from animations with the name of the animation.
- type CSSAnimationStyle extends object
- properties
- # The name of the animation.
- optional string name
- # The style coming from the animation.
- CSSStyle style
-
- # Inherited CSS rule collection from ancestor node.
- type InheritedStyleEntry extends object
- properties
- # The ancestor node's inline style, if any, in the style inheritance chain.
- optional CSSStyle inlineStyle
- # Matches of CSS rules matching the ancestor node in the style inheritance chain.
- array of RuleMatch matchedCSSRules
-
- # Inherited CSS style collection for animated styles from ancestor node.
- type InheritedAnimatedStyleEntry extends object
- properties
- # Styles coming from the animations of the ancestor, if any, in the style inheritance chain.
- optional array of CSSAnimationStyle animationStyles
- # The style coming from the transitions of the ancestor, if any, in the style inheritance chain.
- optional CSSStyle transitionsStyle
-
- # Inherited pseudo element matches from pseudos of an ancestor node.
- type InheritedPseudoElementMatches extends object
- properties
- # Matches of pseudo styles from the pseudos of an ancestor node.
- array of PseudoElementMatches pseudoElements
-
- # Match data for a CSS rule.
- type RuleMatch extends object
- properties
- # CSS rule in the match.
- CSSRule rule
- # Matching selector indices in the rule's selectorList selectors (0-based).
- array of integer matchingSelectors
-
- # Data for a simple selector (these are delimited by commas in a selector list).
- type Value extends object
- properties
- # Value text.
- string text
- # Value range in the underlying resource (if available).
- optional SourceRange range
- # Specificity of the selector.
- experimental optional Specificity specificity
-
- # Specificity:
- # https://drafts.csswg.org/selectors/#specificity-rules
- experimental type Specificity extends object
- properties
- # The a component, which represents the number of ID selectors.
- integer a
- # The b component, which represents the number of class selectors, attributes selectors, and
- # pseudo-classes.
- integer b
- # The c component, which represents the number of type selectors and pseudo-elements.
- integer c
-
- # Selector list data.
- type SelectorList extends object
- properties
- # Selectors in the list.
- array of Value selectors
- # Rule selector text.
- string text
-
- # CSS stylesheet metainformation.
- type CSSStyleSheetHeader extends object
- properties
- # The stylesheet identifier.
- StyleSheetId styleSheetId
- # Owner frame identifier.
- Page.FrameId frameId
- # Stylesheet resource URL. Empty if this is a constructed stylesheet created using
- # new CSSStyleSheet() (but non-empty if this is a constructed stylesheet imported
- # as a CSS module script).
- string sourceURL
- # URL of source map associated with the stylesheet (if any).
- optional string sourceMapURL
- # Stylesheet origin.
- StyleSheetOrigin origin
- # Stylesheet title.
- string title
- # The backend id for the owner node of the stylesheet.
- optional DOM.BackendNodeId ownerNode
- # Denotes whether the stylesheet is disabled.
- boolean disabled
- # Whether the sourceURL field value comes from the sourceURL comment.
- optional boolean hasSourceURL
- # Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
- # document.written STYLE tags.
- boolean isInline
- # Whether this stylesheet is mutable. Inline stylesheets become mutable
- # after they have been modified via CSSOM API.
- # `<link>` element's stylesheets become mutable only if DevTools modifies them.
- # Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
- boolean isMutable
- # True if this stylesheet is created through new CSSStyleSheet() or imported as a
- # CSS module script.
- boolean isConstructed
- # Line offset of the stylesheet within the resource (zero based).
- number startLine
- # Column offset of the stylesheet within the resource (zero based).
- number startColumn
- # Size of the content (in characters).
- number length
- # Line offset of the end of the stylesheet within the resource (zero based).
- number endLine
- # Column offset of the end of the stylesheet within the resource (zero based).
- number endColumn
- # If the style sheet was loaded from a network resource, this indicates when the resource failed to load
- experimental optional boolean loadingFailed
-
- # CSS rule representation.
- type CSSRule extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Rule selector data.
- SelectorList selectorList
- # Array of selectors from ancestor style rules, sorted by distance from the current rule.
- experimental optional array of string nestingSelectors
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated style declaration.
- CSSStyle style
- # Media list array (for rules involving media queries). The array enumerates media queries
- # starting with the innermost one, going outwards.
- optional array of CSSMedia media
- # Container query list array (for rules involving container queries).
- # The array enumerates container queries starting with the innermost one, going outwards.
- experimental optional array of CSSContainerQuery containerQueries
- # @supports CSS at-rule array.
- # The array enumerates @supports at-rules starting with the innermost one, going outwards.
- experimental optional array of CSSSupports supports
- # Cascade layer array. Contains the layer hierarchy that this rule belongs to starting
- # with the innermost layer and going outwards.
- experimental optional array of CSSLayer layers
- # @scope CSS at-rule array.
- # The array enumerates @scope at-rules starting with the innermost one, going outwards.
- experimental optional array of CSSScope scopes
- # The array keeps the types of ancestor CSSRules from the innermost going outwards.
- experimental optional array of CSSRuleType ruleTypes
- # @starting-style CSS at-rule array.
- # The array enumerates @starting-style at-rules starting with the innermost one, going outwards.
- experimental optional array of CSSStartingStyle startingStyles
-
- # Enum indicating the type of a CSS rule, used to represent the order of a style rule's ancestors.
- # This list only contains rule types that are collected during the ancestor rule collection.
- experimental type CSSRuleType extends string
- enum
- MediaRule
- SupportsRule
- ContainerRule
- LayerRule
- ScopeRule
- StyleRule
- StartingStyleRule
-
- # CSS coverage information.
- type RuleUsage extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- StyleSheetId styleSheetId
- # Offset of the start of the rule (including selector) from the beginning of the stylesheet.
- number startOffset
- # Offset of the end of the rule body from the beginning of the stylesheet.
- number endOffset
- # Indicates whether the rule was actually used by some element in the page.
- boolean used
-
- # Text range within a resource. All numbers are zero-based.
- type SourceRange extends object
- properties
- # Start line of range.
- integer startLine
- # Start column of range (inclusive).
- integer startColumn
- # End line of range
- integer endLine
- # End column of range (exclusive).
- integer endColumn
-
- type ShorthandEntry extends object
- properties
- # Shorthand name.
- string name
- # Shorthand value.
- string value
- # Whether the property has "!important" annotation (implies `false` if absent).
- optional boolean important
-
- type CSSComputedStyleProperty extends object
- properties
- # Computed style property name.
- string name
- # Computed style property value.
- string value
-
- # CSS style representation.
- type CSSStyle extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # CSS properties in the style.
- array of CSSProperty cssProperties
- # Computed values for all shorthands found in the style.
- array of ShorthandEntry shorthandEntries
- # Style declaration text (if available).
- optional string cssText
- # Style declaration range in the enclosing stylesheet (if available).
- optional SourceRange range
-
- # CSS property declaration data.
- type CSSProperty extends object
- properties
- # The property name.
- string name
- # The property value.
- string value
- # Whether the property has "!important" annotation (implies `false` if absent).
- optional boolean important
- # Whether the property is implicit (implies `false` if absent).
- optional boolean implicit
- # The full property text as specified in the style.
- optional string text
- # Whether the property is understood by the browser (implies `true` if absent).
- optional boolean parsedOk
- # Whether the property is disabled by the user (present for source-based properties only).
- optional boolean disabled
- # The entire property range in the enclosing style declaration (if available).
- optional SourceRange range
- # Parsed longhand components of this property if it is a shorthand.
- # This field will be empty if the given property is not a shorthand.
- experimental optional array of CSSProperty longhandProperties
-
- # CSS media rule descriptor.
- type CSSMedia extends object
- properties
- # Media query text.
- string text
- # Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
- # specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
- # stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
- # stylesheet's STYLE tag.
- enum source
- mediaRule
- importRule
- linkedSheet
- inlineSheet
- # URL of the document containing the media query description.
- optional string sourceURL
- # The associated rule (@media or @import) header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
- # Array of media queries.
- optional array of MediaQuery mediaList
-
- # Media query descriptor.
- type MediaQuery extends object
- properties
- # Array of media query expressions.
- array of MediaQueryExpression expressions
- # Whether the media query condition is satisfied.
- boolean active
-
- # Media query expression descriptor.
- type MediaQueryExpression extends object
- properties
- # Media query expression value.
- number value
- # Media query expression units.
- string unit
- # Media query expression feature.
- string feature
- # The associated range of the value text in the enclosing stylesheet (if available).
- optional SourceRange valueRange
- # Computed length of media query expression (if applicable).
- optional number computedLength
-
- # CSS container query rule descriptor.
- experimental type CSSContainerQuery extends object
- properties
- # Container query text.
- string text
- # The associated rule header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
- # Optional name for the container.
- optional string name
- # Optional physical axes queried for the container.
- optional DOM.PhysicalAxes physicalAxes
- # Optional logical axes queried for the container.
- optional DOM.LogicalAxes logicalAxes
- # true if the query contains scroll-state() queries.
- optional boolean queriesScrollState
- # true if the query contains anchored() queries.
- optional boolean queriesAnchored
-
- # CSS Supports at-rule descriptor.
- experimental type CSSSupports extends object
- properties
- # Supports rule text.
- string text
- # Whether the supports condition is satisfied.
- boolean active
- # The associated rule header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
-
- # CSS Scope at-rule descriptor.
- experimental type CSSScope extends object
- properties
- # Scope rule text.
- string text
- # The associated rule header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
-
- # CSS Layer at-rule descriptor.
- experimental type CSSLayer extends object
- properties
- # Layer name.
- string text
- # The associated rule header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
-
- # CSS Starting Style at-rule descriptor.
- experimental type CSSStartingStyle extends object
- properties
- # The associated rule header range in the enclosing stylesheet (if
- # available).
- optional SourceRange range
- # Identifier of the stylesheet containing this object (if exists).
- optional StyleSheetId styleSheetId
-
- # CSS Layer data.
- experimental type CSSLayerData extends object
- properties
- # Layer name.
- string name
- # Direct sub-layers
- optional array of CSSLayerData subLayers
- # Layer order. The order determines the order of the layer in the cascade order.
- # A higher number has higher priority in the cascade order.
- number order
-
- # Information about amount of glyphs that were rendered with given font.
- type PlatformFontUsage extends object
- properties
- # Font's family name reported by platform.
- string familyName
- # Font's PostScript name reported by platform.
- string postScriptName
- # Indicates if the font was downloaded or resolved locally.
- boolean isCustomFont
- # Amount of glyphs that were rendered with this font.
- number glyphCount
-
- # Information about font variation axes for variable fonts
- type FontVariationAxis extends object
- properties
- # The font-variation-setting tag (a.k.a. "axis tag").
- string tag
- # Human-readable variation name in the default language (normally, "en").
- string name
- # The minimum value (inclusive) the font supports for this tag.
- number minValue
- # The maximum value (inclusive) the font supports for this tag.
- number maxValue
- # The default value.
- number defaultValue
-
- # 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.
- type FontFace extends object
- properties
- # The font-family.
- string fontFamily
- # The font-style.
- string fontStyle
- # The font-variant.
- string fontVariant
- # The font-weight.
- string fontWeight
- # The font-stretch.
- string fontStretch
- # The font-display.
- string fontDisplay
- # The unicode-range.
- string unicodeRange
- # The src.
- string src
- # The resolved platform font family
- string platformFontFamily
- # Available variation settings (a.k.a. "axes").
- optional array of FontVariationAxis fontVariationAxes
-
- # CSS try rule representation.
- type CSSTryRule extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated style declaration.
- CSSStyle style
-
- # CSS @position-try rule representation.
- type CSSPositionTryRule extends object
- properties
- # The prelude dashed-ident name
- Value name
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated style declaration.
- CSSStyle style
- boolean active
-
- # CSS keyframes rule representation.
- type CSSKeyframesRule extends object
- properties
- # Animation name.
- Value animationName
- # List of keyframes.
- array of CSSKeyframeRule keyframes
-
- # Representation of a custom property registration through CSS.registerProperty
- type CSSPropertyRegistration extends object
- properties
- string propertyName
- optional Value initialValue
- boolean inherits
- string syntax
-
-
- # CSS font-palette-values rule representation.
- type CSSFontPaletteValuesRule extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated font palette name.
- Value fontPaletteName
- # Associated style declaration.
- CSSStyle style
-
- # CSS property at-rule representation.
- type CSSPropertyRule extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated property name.
- Value propertyName
- # Associated style declaration.
- CSSStyle style
-
- # CSS function argument representation.
- type CSSFunctionParameter extends object
- properties
- # The parameter name.
- string name
- # The parameter type.
- string type
-
- # CSS function conditional block representation.
- type CSSFunctionConditionNode extends object
- properties
- # Media query for this conditional block. Only one type of condition should be set.
- optional CSSMedia media
- # Container query for this conditional block. Only one type of condition should be set.
- optional CSSContainerQuery containerQueries
- # @supports CSS at-rule condition. Only one type of condition should be set.
- optional CSSSupports supports
- # Block body.
- array of CSSFunctionNode children
- # The condition text.
- string conditionText
-
- # Section of the body of a CSS function rule.
- type CSSFunctionNode extends object
- properties
- # A conditional block. If set, style should not be set.
- optional CSSFunctionConditionNode condition
- # Values set by this node. If set, condition should not be set.
- optional CSSStyle style
-
- # CSS function at-rule representation.
- type CSSFunctionRule extends object
- properties
- # Name of the function.
- Value name
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # List of parameters.
- array of CSSFunctionParameter parameters
- # Function body.
- array of CSSFunctionNode children
-
- # CSS keyframe rule representation.
- type CSSKeyframeRule extends object
- properties
- # The css style sheet identifier (absent for user agent stylesheet and user-specified
- # stylesheet rules) this rule came from.
- optional StyleSheetId styleSheetId
- # Parent stylesheet's origin.
- StyleSheetOrigin origin
- # Associated key text.
- Value keyText
- # Associated style declaration.
- CSSStyle style
-
- # A descriptor of operation to mutate style declaration text.
- type StyleDeclarationEdit extends object
- properties
- # The css style sheet identifier.
- StyleSheetId styleSheetId
- # The range of the style text in the enclosing stylesheet.
- SourceRange range
- # New style text.
- string text
-
- # Inserts a new rule with the given `ruleText` in a stylesheet with given `styleSheetId`, at the
- # position specified by `location`.
- command addRule
- parameters
- # The css style sheet identifier where a new rule should be inserted.
- StyleSheetId styleSheetId
- # The text of a new rule.
- string ruleText
- # Text position of a new rule in the target style sheet.
- SourceRange location
- # NodeId for the DOM node in whose context custom property declarations for registered properties should be
- # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
- # incorrect results if the declaration contains a var() for example.
- experimental optional DOM.NodeId nodeForPropertySyntaxValidation
- returns
- # The newly created rule.
- CSSRule rule
-
- # Returns all class names from specified stylesheet.
- command collectClassNames
- parameters
- StyleSheetId styleSheetId
- returns
- # Class name list.
- array of string classNames
-
- # Creates a new special "via-inspector" stylesheet in the frame with given `frameId`.
- command createStyleSheet
- parameters
- # Identifier of the frame where "via-inspector" stylesheet should be created.
- Page.FrameId frameId
- # If true, creates a new stylesheet for every call. If false,
- # returns a stylesheet previously created by a call with force=false
- # for the frame's document if it exists or creates a new stylesheet
- # (default: false).
- optional boolean force
- returns
- # Identifier of the created "via-inspector" stylesheet.
- StyleSheetId styleSheetId
-
- # Disables the CSS agent for the given page.
- command disable
-
- # Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been
- # enabled until the result of this command is received.
- command enable
-
- # Ensures that the given node will have specified pseudo-classes whenever its style is computed by
- # the browser.
- command forcePseudoState
- parameters
- # The element id for which to force the pseudo state.
- DOM.NodeId nodeId
- # Element pseudo classes to force when computing the element's style.
- array of string forcedPseudoClasses
-
- # Ensures that the given node is in its starting-style state.
- command forceStartingStyle
- parameters
- # The element id for which to force the starting-style state.
- DOM.NodeId nodeId
- # Boolean indicating if this is on or off.
- boolean forced
-
- command getBackgroundColors
- parameters
- # Id of the node to get background colors for.
- DOM.NodeId nodeId
- returns
- # The range of background colors behind this element, if it contains any visible text. If no
- # visible text is present, this will be undefined. In the case of a flat background color,
- # this will consist of simply that color. In the case of a gradient, this will consist of each
- # of the color stops. For anything more complicated, this will be an empty array. Images will
- # be ignored (as if the image had failed to load).
- optional array of string backgroundColors
- # The computed font size for this node, as a CSS computed value string (e.g. '12px').
- optional string computedFontSize
- # The computed font weight for this node, as a CSS computed value string (e.g. 'normal' or
- # '100').
- optional string computedFontWeight
-
- # Returns the computed style for a DOM node identified by `nodeId`.
- command getComputedStyleForNode
- parameters
- DOM.NodeId nodeId
- returns
- # Computed style for the specified DOM node.
- array of CSSComputedStyleProperty computedStyle
-
- # Resolve the specified values in the context of the provided element.
- # For example, a value of '1em' is evaluated according to the computed
- # 'font-size' of the element and a value 'calc(1px + 2px)' will be
- # resolved to '3px'.
- # If the `propertyName` was specified the `values` are resolved as if
- # they were property's declaration. If a value cannot be parsed according
- # to the provided property syntax, the value is parsed using combined
- # syntax as if null `propertyName` was provided. If the value cannot be
- # resolved even then, return the provided value without any changes.
- experimental command resolveValues
- parameters
- # Cascade-dependent keywords (revert/revert-layer) do not work.
- array of string values
- # Id of the node in whose context the expression is evaluated
- DOM.NodeId nodeId
- # Only longhands and custom property names are accepted.
- optional string propertyName
- # Pseudo element type, only works for pseudo elements that generate
- # elements in the tree, such as ::before and ::after.
- optional DOM.PseudoType pseudoType
- # Pseudo element custom ident.
- optional string pseudoIdentifier
- returns
- array of string results
-
- experimental command getLonghandProperties
- parameters
- string shorthandName
- string value
- returns
- array of CSSProperty longhandProperties
-
- # Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
- # attributes) for a DOM node identified by `nodeId`.
- command getInlineStylesForNode
- parameters
- DOM.NodeId nodeId
- returns
- # Inline style for the specified DOM node.
- optional CSSStyle inlineStyle
- # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
- optional CSSStyle attributesStyle
-
- # Returns the styles coming from animations & transitions
- # including the animation & transition styles coming from inheritance chain.
- experimental command getAnimatedStylesForNode
- parameters
- DOM.NodeId nodeId
- returns
- # Styles coming from animations.
- optional array of CSSAnimationStyle animationStyles
- # Style coming from transitions.
- optional CSSStyle transitionsStyle
- # Inherited style entries for animationsStyle and transitionsStyle from
- # the inheritance chain of the element.
- optional array of InheritedAnimatedStyleEntry inherited
-
- # Returns requested styles for a DOM node identified by `nodeId`.
- command getMatchedStylesForNode
- parameters
- DOM.NodeId nodeId
- returns
- # Inline style for the specified DOM node.
- optional CSSStyle inlineStyle
- # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
- optional CSSStyle attributesStyle
- # CSS rules matching this node, from all applicable stylesheets.
- optional array of RuleMatch matchedCSSRules
- # Pseudo style matches for this node.
- optional array of PseudoElementMatches pseudoElements
- # A chain of inherited styles (from the immediate node parent up to the DOM tree root).
- optional array of InheritedStyleEntry inherited
- # A chain of inherited pseudo element styles (from the immediate node parent up to the DOM tree root).
- optional array of InheritedPseudoElementMatches inheritedPseudoElements
- # A list of CSS keyframed animations matching this node.
- optional array of CSSKeyframesRule cssKeyframesRules
- # A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
- optional array of CSSPositionTryRule cssPositionTryRules
- # Index of the active fallback in the applied position-try-fallback property,
- # will not be set if there is no active position-try fallback.
- optional integer activePositionFallbackIndex
- # A list of CSS at-property rules matching this node.
- optional array of CSSPropertyRule cssPropertyRules
- # A list of CSS property registrations matching this node.
- optional array of CSSPropertyRegistration cssPropertyRegistrations
- # A font-palette-values rule matching this node.
- optional CSSFontPaletteValuesRule cssFontPaletteValuesRule
- # Id of the first parent element that does not have display: contents.
- experimental optional DOM.NodeId parentLayoutNodeId
- # A list of CSS at-function rules referenced by styles of this node.
- experimental optional array of CSSFunctionRule cssFunctionRules
-
- # Returns the values of the default UA-defined environment variables used in env()
- experimental command getEnvironmentVariables
- returns
- object environmentVariables
-
- # Returns all media queries parsed by the rendering engine.
- command getMediaQueries
- returns
- array of CSSMedia medias
-
- # Requests information about platform fonts which we used to render child TextNodes in the given
- # node.
- command getPlatformFontsForNode
- parameters
- DOM.NodeId nodeId
- returns
- # Usage statistics for every employed platform font.
- array of PlatformFontUsage fonts
-
- # Returns the current textual content for a stylesheet.
- command getStyleSheetText
- parameters
- StyleSheetId styleSheetId
- returns
- # The stylesheet text.
- string text
-
- # Returns all layers parsed by the rendering engine for the tree scope of a node.
- # Given a DOM element identified by nodeId, getLayersForNode returns the root
- # layer for the nearest ancestor document or shadow root. The layer root contains
- # the full layer tree for the tree scope and their ordering.
- experimental command getLayersForNode
- parameters
- DOM.NodeId nodeId
- returns
- CSSLayerData rootLayer
-
- # Given a CSS selector text and a style sheet ID, getLocationForSelector
- # returns an array of locations of the CSS selector in the style sheet.
- experimental command getLocationForSelector
- parameters
- StyleSheetId styleSheetId
- string selectorText
- returns
- array of SourceRange ranges
-
- # Starts tracking the given node for the computed style updates
- # and whenever the computed style is updated for node, it queues
- # a `computedStyleUpdated` event with throttling.
- # There can only be 1 node tracked for computed style updates
- # so passing a new node id removes tracking from the previous node.
- # Pass `undefined` to disable tracking.
- experimental command trackComputedStyleUpdatesForNode
- parameters
- optional DOM.NodeId nodeId
-
- # Starts tracking the given computed styles for updates. The specified array of properties
- # replaces the one previously specified. Pass empty array to disable tracking.
- # Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
- # The changes to computed style properties are only tracked for nodes pushed to the front-end
- # by the DOM agent. If no changes to the tracked properties occur after the node has been pushed
- # to the front-end, no updates will be issued for the node.
- experimental command trackComputedStyleUpdates
- parameters
- array of CSSComputedStyleProperty propertiesToTrack
-
- # Polls the next batch of computed style updates.
- experimental command takeComputedStyleUpdates
- returns
- # The list of node Ids that have their tracked computed styles updated.
- array of DOM.NodeId nodeIds
-
- # Find a rule with the given active property for the given node and set the new value for this
- # property
- command setEffectivePropertyValueForNode
- parameters
- # The element id for which to set property.
- DOM.NodeId nodeId
- string propertyName
- string value
-
- # Modifies the property rule property name.
- command setPropertyRulePropertyName
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string propertyName
- returns
- # The resulting key text after modification.
- Value propertyName
-
- # Modifies the keyframe rule key text.
- command setKeyframeKey
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string keyText
- returns
- # The resulting key text after modification.
- Value keyText
-
- # Modifies the rule selector.
- command setMediaText
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string text
- returns
- # The resulting CSS media rule after modification.
- CSSMedia media
-
- # Modifies the expression of a container query.
- experimental command setContainerQueryText
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string text
- returns
- # The resulting CSS container query rule after modification.
- CSSContainerQuery containerQuery
-
- # Modifies the expression of a supports at-rule.
- experimental command setSupportsText
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string text
- returns
- # The resulting CSS Supports rule after modification.
- CSSSupports supports
-
- # Modifies the expression of a scope at-rule.
- experimental command setScopeText
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string text
- returns
- # The resulting CSS Scope rule after modification.
- CSSScope scope
-
- # Modifies the rule selector.
- command setRuleSelector
- parameters
- StyleSheetId styleSheetId
- SourceRange range
- string selector
- returns
- # The resulting selector list after modification.
- SelectorList selectorList
-
- # Sets the new stylesheet text.
- command setStyleSheetText
- parameters
- StyleSheetId styleSheetId
- string text
- returns
- # URL of source map associated with script (if any).
- optional string sourceMapURL
-
- # Applies specified style edits one after another in the given order.
- command setStyleTexts
- parameters
- array of StyleDeclarationEdit edits
- # NodeId for the DOM node in whose context custom property declarations for registered properties should be
- # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
- # incorrect results if the declaration contains a var() for example.
- experimental optional DOM.NodeId nodeForPropertySyntaxValidation
- returns
- # The resulting styles after modification.
- array of CSSStyle styles
-
- # Enables the selector recording.
- command startRuleUsageTracking
-
- # Stop tracking rule usage and return the list of rules that were used since last call to
- # `takeCoverageDelta` (or since start of coverage instrumentation).
- command stopRuleUsageTracking
- returns
- array of RuleUsage ruleUsage
-
- # Obtain list of rules that became used since last call to this method (or since start of coverage
- # instrumentation).
- command takeCoverageDelta
- returns
- array of RuleUsage coverage
- # Monotonically increasing time, in seconds.
- number timestamp
-
- # Enables/disables rendering of local CSS fonts (enabled by default).
- experimental command setLocalFontsEnabled
- parameters
- # Whether rendering of local fonts is enabled.
- boolean enabled
-
- # Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded
- # web font.
- event fontsUpdated
- parameters
- # The web font that has loaded.
- optional FontFace font
-
- # Fires whenever a MediaQuery result changes (for example, after a browser window has been
- # resized.) The current implementation considers only viewport-dependent media features.
- event mediaQueryResultChanged
-
- # Fired whenever an active document stylesheet is added.
- event styleSheetAdded
- parameters
- # Added stylesheet metainfo.
- CSSStyleSheetHeader header
-
- # Fired whenever a stylesheet is changed as a result of the client operation.
- event styleSheetChanged
- parameters
- StyleSheetId styleSheetId
-
- # Fired whenever an active document stylesheet is removed.
- event styleSheetRemoved
- parameters
- # Identifier of the removed stylesheet.
- StyleSheetId styleSheetId
-
- experimental event computedStyleUpdated
- parameters
- # The node id that has updated computed styles.
- DOM.NodeId nodeId
-
-experimental domain CacheStorage
- depends on Storage
-
- # Unique identifier of the Cache object.
- type CacheId extends string
-
- # type of HTTP response cached
- type CachedResponseType extends string
- enum
- basic
- cors
- default
- error
- opaqueResponse
- opaqueRedirect
-
- # Data entry.
- type DataEntry extends object
- properties
- # Request URL.
- string requestURL
- # Request method.
- string requestMethod
- # Request headers
- array of Header requestHeaders
- # Number of seconds since epoch.
- number responseTime
- # HTTP response status code.
- integer responseStatus
- # HTTP response status text.
- string responseStatusText
- # HTTP response type
- CachedResponseType responseType
- # Response headers
- array of Header responseHeaders
-
- # Cache identifier.
- type Cache extends object
- properties
- # An opaque unique id of the cache.
- CacheId cacheId
- # Security origin of the cache.
- string securityOrigin
- # Storage key of the cache.
- string storageKey
- # Storage bucket of the cache.
- optional Storage.StorageBucket storageBucket
- # The name of the cache.
- string cacheName
-
- type Header extends object
- properties
- string name
- string value
-
- # Cached response
- type CachedResponse extends object
- properties
- # Entry content, base64-encoded.
- binary body
-
- # Deletes a cache.
- command deleteCache
- parameters
- # Id of cache for deletion.
- CacheId cacheId
-
- # Deletes a cache entry.
- command deleteEntry
- parameters
- # Id of cache where the entry will be deleted.
- CacheId cacheId
- # URL spec of the request.
- string request
-
- # Requests cache names.
- command requestCacheNames
- parameters
- # At least and at most one of securityOrigin, storageKey, storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- returns
- # Caches for the security origin.
- array of Cache caches
-
- # Fetches cache entry.
- command requestCachedResponse
- parameters
- # Id of cache that contains the entry.
- CacheId cacheId
- # URL spec of the request.
- string requestURL
- # headers of the request.
- array of Header requestHeaders
- returns
- # Response read from the cache.
- CachedResponse response
-
- # Requests data from cache.
- command requestEntries
- parameters
- # ID of cache to get entries from.
- CacheId cacheId
- # Number of records to skip.
- optional integer skipCount
- # Number of records to fetch.
- optional integer pageSize
- # If present, only return the entries containing this substring in the path
- optional string pathFilter
- returns
- # Array of object store data entries.
- array of DataEntry cacheDataEntries
- # Count of returned entries from this storage. If pathFilter is empty, it
- # is the count of all entries from this storage.
- number returnCount
-
-# A domain for interacting with Cast, Presentation API, and Remote Playback API
-# functionalities.
-experimental domain Cast
-
- type Sink extends object
- properties
- string name
- string id
- # Text describing the current session. Present only if there is an active
- # session on the sink.
- optional string session
-
- # Starts observing for sinks that can be used for tab mirroring, and if set,
- # sinks compatible with |presentationUrl| as well. When sinks are found, a
- # |sinksUpdated| event is fired.
- # Also starts observing for issue messages. When an issue is added or removed,
- # an |issueUpdated| event is fired.
- command enable
- parameters
- optional string presentationUrl
-
- # Stops observing for sinks and issues.
- command disable
-
- # Sets a sink to be used when the web page requests the browser to choose a
- # sink via Presentation API, Remote Playback API, or Cast SDK.
- command setSinkToUse
- parameters
- string sinkName
-
- # Starts mirroring the desktop to the sink.
- command startDesktopMirroring
- parameters
- string sinkName
-
- # Starts mirroring the tab to the sink.
- command startTabMirroring
- parameters
- string sinkName
-
- # Stops the active Cast session on the sink.
- command stopCasting
- parameters
- string sinkName
-
- # This is fired whenever the list of available sinks changes. A sink is a
- # device or a software surface that you can cast to.
- event sinksUpdated
- parameters
- array of Sink sinks
-
- # This is fired whenever the outstanding issue/error message changes.
- # |issueMessage| is empty if there is no issue.
- event issueUpdated
- parameters
- string issueMessage
-
-
-# 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.
-domain DOM
- depends on Runtime
-
- # Unique DOM node identifier.
- type NodeId extends integer
-
- # Unique DOM node identifier used to reference a node that may not have been pushed to the
- # front-end.
- type BackendNodeId extends integer
-
- # Backend node with a friendly name.
- type BackendNode extends object
- properties
- # `Node`'s nodeType.
- integer nodeType
- # `Node`'s nodeName.
- string nodeName
- BackendNodeId backendNodeId
-
- # Pseudo element type.
- type PseudoType extends string
- enum
- first-line
- first-letter
- checkmark
- before
- after
- picker-icon
- interest-hint
- marker
- backdrop
- column
- selection
- search-text
- target-text
- spelling-error
- grammar-error
- highlight
- first-line-inherited
- scroll-marker
- scroll-marker-group
- scroll-button
- scrollbar
- scrollbar-thumb
- scrollbar-button
- scrollbar-track
- scrollbar-track-piece
- scrollbar-corner
- resizer
- input-list-button
- view-transition
- view-transition-group
- view-transition-image-pair
- view-transition-group-children
- view-transition-old
- view-transition-new
- placeholder
- file-selector-button
- details-content
- picker
- permission-icon
-
- # Shadow root type.
- type ShadowRootType extends string
- enum
- user-agent
- open
- closed
-
- # Document compatibility mode.
- type CompatibilityMode extends string
- enum
- QuirksMode
- LimitedQuirksMode
- NoQuirksMode
-
- # ContainerSelector physical axes
- type PhysicalAxes extends string
- enum
- Horizontal
- Vertical
- Both
-
- # ContainerSelector logical axes
- type LogicalAxes extends string
- enum
- Inline
- Block
- Both
-
- # Physical scroll orientation
- type ScrollOrientation extends string
- enum
- horizontal
- vertical
-
- # DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes.
- # DOMNode is a base node mirror type.
- type Node extends object
- properties
- # Node identifier that is passed into the rest of the DOM messages as the `nodeId`. Backend
- # will only push node with given `id` once. It is aware of all requested nodes and will only
- # fire DOM events for nodes known to the client.
- NodeId nodeId
- # The id of the parent node if any.
- optional NodeId parentId
- # The BackendNodeId for this node.
- BackendNodeId backendNodeId
- # `Node`'s nodeType.
- integer nodeType
- # `Node`'s nodeName.
- string nodeName
- # `Node`'s localName.
- string localName
- # `Node`'s nodeValue.
- string nodeValue
- # Child count for `Container` nodes.
- optional integer childNodeCount
- # Child nodes of this node when requested with children.
- optional array of Node children
- # Attributes of the `Element` node in the form of flat array `[name1, value1, name2, value2]`.
- optional array of string attributes
- # Document URL that `Document` or `FrameOwner` node points to.
- optional string documentURL
- # Base URL that `Document` or `FrameOwner` node uses for URL completion.
- optional string baseURL
- # `DocumentType`'s publicId.
- optional string publicId
- # `DocumentType`'s systemId.
- optional string systemId
- # `DocumentType`'s internalSubset.
- optional string internalSubset
- # `Document`'s XML version in case of XML documents.
- optional string xmlVersion
- # `Attr`'s name.
- optional string name
- # `Attr`'s value.
- optional string value
- # Pseudo element type for this node.
- optional PseudoType pseudoType
- # Pseudo element identifier for this node. Only present if there is a
- # valid pseudoType.
- optional string pseudoIdentifier
- # Shadow root type.
- optional ShadowRootType shadowRootType
- # Frame ID for frame owner elements.
- optional Page.FrameId frameId
- # Content document for frame owner elements.
- optional Node contentDocument
- # Shadow root list for given element host.
- optional array of Node shadowRoots
- # Content document fragment for template elements.
- optional Node templateContent
- # Pseudo elements associated with this node.
- optional array of Node pseudoElements
- # Deprecated, as the HTML Imports API has been removed (crbug.com/937746).
- # This property used to return the imported document for the HTMLImport links.
- # The property is always undefined now.
- deprecated optional Node importedDocument
- # Distributed nodes for given insertion point.
- optional array of BackendNode distributedNodes
- # Whether the node is SVG.
- optional boolean isSVG
- optional CompatibilityMode compatibilityMode
- optional BackendNode assignedSlot
- experimental optional boolean isScrollable
-
- # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
- type DetachedElementInfo extends object
- properties
- Node treeNode
- array of NodeId retainedNodeIds
-
- # A structure holding an RGBA color.
- type RGBA extends object
- properties
- # The red component, in the [0-255] range.
- integer r
- # The green component, in the [0-255] range.
- integer g
- # The blue component, in the [0-255] range.
- integer b
- # The alpha component, in the [0-1] range (default: 1).
- optional number a
-
- # An array of quad vertices, x immediately followed by y for each point, points clock-wise.
- type Quad extends array of number
-
- # Box model.
- type BoxModel extends object
- properties
- # Content box
- Quad content
- # Padding box
- Quad padding
- # Border box
- Quad border
- # Margin box
- Quad margin
- # Node width
- integer width
- # Node height
- integer height
- # Shape outside coordinates
- optional ShapeOutsideInfo shapeOutside
-
- # CSS Shape Outside details.
- type ShapeOutsideInfo extends object
- properties
- # Shape bounds
- Quad bounds
- # Shape coordinate details
- array of any shape
- # Margin shape bounds
- array of any marginShape
-
- # Rectangle.
- type Rect extends object
- properties
- # X coordinate
- number x
- # Y coordinate
- number y
- # Rectangle width
- number width
- # Rectangle height
- number height
-
- type CSSComputedStyleProperty extends object
- properties
- # Computed style property name.
- string name
- # Computed style property value.
- string value
-
- # Collects class names for the node with given id and all of it's child nodes.
- experimental command collectClassNamesFromSubtree
- parameters
- # Id of the node to collect class names.
- NodeId nodeId
- returns
- # Class name list.
- array of string classNames
-
- # Creates a deep copy of the specified node and places it into the target container before the
- # given anchor.
- experimental command copyTo
- parameters
- # Id of the node to copy.
- NodeId nodeId
- # Id of the element to drop the copy into.
- NodeId targetNodeId
- # Drop the copy before this node (if absent, the copy becomes the last child of
- # `targetNodeId`).
- optional NodeId insertBeforeNodeId
- returns
- # Id of the node clone.
- NodeId nodeId
-
- # Describes node given its id, does not require domain to be enabled. Does not start tracking any
- # objects, can be used for automation.
- command describeNode
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
- # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
- # entire subtree or provide an integer larger than 0.
- optional integer depth
- # Whether or not iframes and shadow roots should be traversed when returning the subtree
- # (default is false).
- optional boolean pierce
- returns
- # Node description.
- Node node
-
- # Scrolls the specified rect of the given node into view if not already visible.
- # Note: exactly one between nodeId, backendNodeId and objectId should be passed
- # to identify the node.
- command scrollIntoViewIfNeeded
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
- # The rect to be scrolled into view, relative to the node's border box, in CSS pixels.
- # When omitted, center of the node will be used, similar to Element.scrollIntoView.
- optional Rect rect
-
- # Disables DOM agent for the given page.
- command disable
-
- # Discards search results from the session with the given id. `getSearchResults` should no longer
- # be called for that search.
- experimental command discardSearchResults
- parameters
- # Unique search session identifier.
- string searchId
-
- # Enables DOM agent for the given page.
- command enable
- parameters
- # Whether to include whitespaces in the children array of returned Nodes.
- experimental optional enum includeWhitespace
- # Strip whitespaces from child arrays (default).
- none
- # Return all children including block-level whitespace nodes.
- all
-
- # Focuses the given element.
- command focus
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
-
- # Returns attributes for the specified node.
- command getAttributes
- parameters
- # Id of the node to retrieve attributes for.
- NodeId nodeId
- returns
- # An interleaved array of node attribute names and values.
- array of string attributes
-
- # Returns boxes for the given node.
- command getBoxModel
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
- returns
- # Box model for the node.
- BoxModel model
-
- # Returns quads that describe node position on the page. This method
- # might return multiple quads for inline nodes.
- experimental command getContentQuads
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
- returns
- # Quads that describe node layout relative to viewport.
- array of Quad quads
-
- # Returns the root DOM node (and optionally the subtree) to the caller.
- # Implicitly enables the DOM domain events for the current target.
- command getDocument
- parameters
- # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
- # entire subtree or provide an integer larger than 0.
- optional integer depth
- # Whether or not iframes and shadow roots should be traversed when returning the subtree
- # (default is false).
- optional boolean pierce
- returns
- # Resulting node.
- Node root
-
- # Returns the root DOM node (and optionally the subtree) to the caller.
- # Deprecated, as it is not designed to work well with the rest of the DOM agent.
- # Use DOMSnapshot.captureSnapshot instead.
- deprecated command getFlattenedDocument
- parameters
- # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
- # entire subtree or provide an integer larger than 0.
- optional integer depth
- # Whether or not iframes and shadow roots should be traversed when returning the subtree
- # (default is false).
- optional boolean pierce
- returns
- # Resulting node.
- array of Node nodes
-
- # Finds nodes with a given computed style in a subtree.
- experimental command getNodesForSubtreeByStyle
- parameters
- # Node ID pointing to the root of a subtree.
- NodeId nodeId
- # The style to filter nodes by (includes nodes if any of properties matches).
- array of CSSComputedStyleProperty computedStyles
- # Whether or not iframes and shadow roots in the same target should be traversed when returning the
- # results (default is false).
- optional boolean pierce
- returns
- # Resulting nodes.
- array of NodeId nodeIds
-
- # Returns node id at given location. Depending on whether DOM domain is enabled, nodeId is
- # either returned or not.
- command getNodeForLocation
- parameters
- # X coordinate.
- integer x
- # Y coordinate.
- integer y
- # False to skip to the nearest non-UA shadow root ancestor (default: false).
- optional boolean includeUserAgentShadowDOM
- # Whether to ignore pointer-events: none on elements and hit test them.
- optional boolean ignorePointerEventsNone
- returns
- # Resulting node.
- BackendNodeId backendNodeId
- # Frame this node belongs to.
- Page.FrameId frameId
- # Id of the node at given coordinates, only when enabled and requested document.
- optional NodeId nodeId
-
- # Returns node's HTML markup.
- command getOuterHTML
- parameters
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
- # Include all shadow roots. Equals to false if not specified.
- experimental optional boolean includeShadowDOM
- returns
- # Outer HTML markup.
- string outerHTML
-
- # Returns the id of the nearest ancestor that is a relayout boundary.
- experimental command getRelayoutBoundary
- parameters
- # Id of the node.
- NodeId nodeId
- returns
- # Relayout boundary node id for the given node.
- NodeId nodeId
-
- # Returns search results from given `fromIndex` to given `toIndex` from the search with the given
- # identifier.
- experimental command getSearchResults
- parameters
- # Unique search session identifier.
- string searchId
- # Start index of the search result to be returned.
- integer fromIndex
- # End index of the search result to be returned.
- integer toIndex
- returns
- # Ids of the search result nodes.
- array of NodeId nodeIds
-
- # Hides any highlight.
- command hideHighlight
- # Use 'Overlay.hideHighlight' instead
- redirect Overlay
-
- # Highlights DOM node.
- command highlightNode
- # Use 'Overlay.highlightNode' instead
- redirect Overlay
-
- # Highlights given rectangle.
- command highlightRect
- # Use 'Overlay.highlightRect' instead
- redirect Overlay
-
- # Marks last undoable state.
- experimental command markUndoableState
-
- # Moves node into the new container, places it before the given anchor.
- command moveTo
- parameters
- # Id of the node to move.
- NodeId nodeId
- # Id of the element to drop the moved node into.
- NodeId targetNodeId
- # Drop node before this one (if absent, the moved node becomes the last child of
- # `targetNodeId`).
- optional NodeId insertBeforeNodeId
- returns
- # New id of the moved node.
- NodeId nodeId
-
- # Searches for a given string in the DOM tree. Use `getSearchResults` to access search results or
- # `cancelSearch` to end this search session.
- experimental command performSearch
- parameters
- # Plain text or query selector or XPath search query.
- string query
- # True to search in user agent shadow DOM.
- optional boolean includeUserAgentShadowDOM
- returns
- # Unique search session identifier.
- string searchId
- # Number of search results.
- integer resultCount
-
- # Requests that the node is sent to the caller given its path. // FIXME, use XPath
- experimental command pushNodeByPathToFrontend
- parameters
- # Path to node in the proprietary format.
- string path
- returns
- # Id of the node for given path.
- NodeId nodeId
-
- # Requests that a batch of nodes is sent to the caller given their backend node ids.
- experimental command pushNodesByBackendIdsToFrontend
- parameters
- # The array of backend node ids.
- array of BackendNodeId backendNodeIds
- returns
- # The array of ids of pushed nodes that correspond to the backend ids specified in
- # backendNodeIds.
- array of NodeId nodeIds
-
- # Executes `querySelector` on a given node.
- command querySelector
- parameters
- # Id of the node to query upon.
- NodeId nodeId
- # Selector string.
- string selector
- returns
- # Query selector result.
- NodeId nodeId
-
- # Executes `querySelectorAll` on a given node.
- command querySelectorAll
- parameters
- # Id of the node to query upon.
- NodeId nodeId
- # Selector string.
- string selector
- returns
- # Query selector result.
- array of NodeId nodeIds
-
- # Returns NodeIds of current top layer elements.
- # Top layer is rendered closest to the user within a viewport, therefore its elements always
- # appear on top of all other content.
- experimental command getTopLayerElements
- returns
- # NodeIds of top layer elements
- array of NodeId nodeIds
-
- # Returns the NodeId of the matched element according to certain relations.
- experimental command getElementByRelation
- parameters
- # Id of the node from which to query the relation.
- NodeId nodeId
- # Type of relation to get.
- enum relation
- # Get the popover target for a given element. In this case, this given
- # element can only be an HTMLFormControlElement (<input>, <button>).
- PopoverTarget
- # Get the interestfor target (the attribute used to be named
- # `interesttarget`) for for a given element.
- InterestTarget
- # Get the commandfor target for a given element. In this case, this given
- # element can only be an HTMLButtonElement.
- CommandFor
- returns
- # NodeId of the element matching the queried relation.
- NodeId nodeId
-
- # Re-does the last undone action.
- experimental command redo
-
- # Removes attribute with given name from an element with given id.
- command removeAttribute
- parameters
- # Id of the element to remove attribute from.
- NodeId nodeId
- # Name of the attribute to remove.
- string name
-
- # Removes node with given id.
- command removeNode
- parameters
- # Id of the node to remove.
- NodeId nodeId
-
- # Requests that children of the node with given id are returned to the caller in form of
- # `setChildNodes` events where not only immediate children are retrieved, but all children down to
- # the specified depth.
- command requestChildNodes
- parameters
- # Id of the node to get children for.
- NodeId nodeId
- # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
- # entire subtree or provide an integer larger than 0.
- optional integer depth
- # Whether or not iframes and shadow roots should be traversed when returning the sub-tree
- # (default is false).
- optional boolean pierce
-
- # Requests that the node is sent to the caller given the JavaScript node object reference. All
- # nodes that form the path from the node to the root are also sent to the client as a series of
- # `setChildNodes` notifications.
- command requestNode
- parameters
- # JavaScript object id to convert into node.
- Runtime.RemoteObjectId objectId
- returns
- # Node id for given object.
- NodeId nodeId
-
- # Resolves the JavaScript node object for a given NodeId or BackendNodeId.
- command resolveNode
- parameters
- # Id of the node to resolve.
- optional NodeId nodeId
- # Backend identifier of the node to resolve.
- optional DOM.BackendNodeId backendNodeId
- # Symbolic group name that can be used to release multiple objects.
- optional string objectGroup
- # Execution context in which to resolve the node.
- optional Runtime.ExecutionContextId executionContextId
- returns
- # JavaScript object wrapper for given node.
- Runtime.RemoteObject object
-
- # Sets attribute for an element with given id.
- command setAttributeValue
- parameters
- # Id of the element to set attribute for.
- NodeId nodeId
- # Attribute name.
- string name
- # Attribute value.
- string value
-
- # Sets attributes on element with given id. This method is useful when user edits some existing
- # attribute value and types in several attribute name/value pairs.
- command setAttributesAsText
- parameters
- # Id of the element to set attributes for.
- NodeId nodeId
- # Text with a number of attributes. Will parse this text using HTML parser.
- string text
- # Attribute name to replace with new attributes derived from text in case text parsed
- # successfully.
- optional string name
-
- # Sets files for the given file input element.
- command setFileInputFiles
- parameters
- # Array of file paths to set.
- array of string files
- # Identifier of the node.
- optional NodeId nodeId
- # Identifier of the backend node.
- optional BackendNodeId backendNodeId
- # JavaScript object id of the node wrapper.
- optional Runtime.RemoteObjectId objectId
-
- # Sets if stack traces should be captured for Nodes. See `Node.getNodeStackTraces`. Default is disabled.
- experimental command setNodeStackTracesEnabled
- parameters
- # Enable or disable.
- boolean enable
-
- # Gets stack traces associated with a Node. As of now, only provides stack trace for Node creation.
- experimental command getNodeStackTraces
- parameters
- # Id of the node to get stack traces for.
- NodeId nodeId
- returns
- # Creation stack trace, if available.
- optional Runtime.StackTrace creation
-
- # Returns file information for the given
- # File wrapper.
- experimental command getFileInfo
- parameters
- # JavaScript object id of the node wrapper.
- Runtime.RemoteObjectId objectId
- returns
- string path
-
- # Returns list of detached nodes
- experimental command getDetachedDomNodes
- returns
- # The list of detached nodes
- array of DetachedElementInfo detachedNodes
-
- # Enables console to refer to the node with given id via $x (see Command Line API for more details
- # $x functions).
- experimental command setInspectedNode
- parameters
- # DOM node id to be accessible by means of $x command line API.
- NodeId nodeId
-
- # Sets node name for a node with given id.
- command setNodeName
- parameters
- # Id of the node to set name for.
- NodeId nodeId
- # New node's name.
- string name
- returns
- # New node's id.
- NodeId nodeId
-
- # Sets node value for a node with given id.
- command setNodeValue
- parameters
- # Id of the node to set value for.
- NodeId nodeId
- # New node's value.
- string value
-
- # Sets node HTML markup, returns new node id.
- command setOuterHTML
- parameters
- # Id of the node to set markup for.
- NodeId nodeId
- # Outer HTML markup to set.
- string outerHTML
-
- # Undoes the last performed action.
- experimental command undo
-
- # Returns iframe node that owns iframe with the given domain.
- experimental command getFrameOwner
- parameters
- Page.FrameId frameId
- returns
- # Resulting node.
- BackendNodeId backendNodeId
- # Id of the node at given coordinates, only when enabled and requested document.
- optional NodeId nodeId
-
- # Returns the query container of the given node based on container query
- # conditions: containerName, physical and logical axes, and whether it queries
- # scroll-state or anchored elements. If no axes are provided and
- # queriesScrollState is false, the style container is returned, which is the
- # direct parent or the closest element with a matching container-name.
- experimental command getContainerForNode
- parameters
- NodeId nodeId
- optional string containerName
- optional PhysicalAxes physicalAxes
- optional LogicalAxes logicalAxes
- optional boolean queriesScrollState
- optional boolean queriesAnchored
- returns
- # The container node for the given node, or null if not found.
- optional NodeId nodeId
-
- # Returns the descendants of a container query container that have
- # container queries against this container.
- experimental command getQueryingDescendantsForContainer
- parameters
- # Id of the container node to find querying descendants from.
- NodeId nodeId
- returns
- # Descendant nodes with container queries against the given container.
- array of NodeId nodeIds
-
- # Returns the target anchor element of the given anchor query according to
- # https://www.w3.org/TR/css-anchor-position-1/#target.
- experimental command getAnchorElement
- parameters
- # Id of the positioned element from which to find the anchor.
- NodeId nodeId
- # An optional anchor specifier, as defined in
- # https://www.w3.org/TR/css-anchor-position-1/#anchor-specifier.
- # If not provided, it will return the implicit anchor element for
- # the given positioned element.
- optional string anchorSpecifier
- returns
- # The anchor element of the given anchor query.
- NodeId nodeId
-
- # When enabling, this API force-opens the popover identified by nodeId
- # and keeps it open until disabled.
- experimental command forceShowPopover
- parameters
- # Id of the popover HTMLElement
- NodeId nodeId
- # If true, opens the popover and keeps it open. If false, closes the
- # popover if it was previously force-opened.
- boolean enable
- returns
- # List of popovers that were closed in order to respect popover stacking order.
- array of NodeId nodeIds
-
- # Fired when `Element`'s attribute is modified.
- event attributeModified
- parameters
- # Id of the node that has changed.
- NodeId nodeId
- # Attribute name.
- string name
- # Attribute value.
- string value
-
- # Fired when `Element`'s attribute is removed.
- event attributeRemoved
- parameters
- # Id of the node that has changed.
- NodeId nodeId
- # A ttribute name.
- string name
-
- # Mirrors `DOMCharacterDataModified` event.
- event characterDataModified
- parameters
- # Id of the node that has changed.
- NodeId nodeId
- # New text value.
- string characterData
-
- # Fired when `Container`'s child node count has changed.
- event childNodeCountUpdated
- parameters
- # Id of the node that has changed.
- NodeId nodeId
- # New node count.
- integer childNodeCount
-
- # Mirrors `DOMNodeInserted` event.
- event childNodeInserted
- parameters
- # Id of the node that has changed.
- NodeId parentNodeId
- # Id of the previous sibling.
- NodeId previousNodeId
- # Inserted node data.
- Node node
-
- # Mirrors `DOMNodeRemoved` event.
- event childNodeRemoved
- parameters
- # Parent id.
- NodeId parentNodeId
- # Id of the node that has been removed.
- NodeId nodeId
-
- # Called when distribution is changed.
- experimental event distributedNodesUpdated
- parameters
- # Insertion point where distributed nodes were updated.
- NodeId insertionPointId
- # Distributed nodes for given insertion point.
- array of BackendNode distributedNodes
-
- # Fired when `Document` has been totally updated. Node ids are no longer valid.
- event documentUpdated
-
- # Fired when `Element`'s inline style is modified via a CSS property modification.
- experimental event inlineStyleInvalidated
- parameters
- # Ids of the nodes for which the inline styles have been invalidated.
- array of NodeId nodeIds
-
- # Called when a pseudo element is added to an element.
- experimental event pseudoElementAdded
- parameters
- # Pseudo element's parent element id.
- NodeId parentId
- # The added pseudo element.
- Node pseudoElement
-
- # Called when top layer elements are changed.
- experimental event topLayerElementsUpdated
-
- # Fired when a node's scrollability state changes.
- experimental event scrollableFlagUpdated
- parameters
- # The id of the node.
- DOM.NodeId nodeId
- # If the node is scrollable.
- boolean isScrollable
-
- # Called when a pseudo element is removed from an element.
- experimental event pseudoElementRemoved
- parameters
- # Pseudo element's parent element id.
- NodeId parentId
- # The removed pseudo element id.
- NodeId pseudoElementId
-
- # Fired when backend wants to provide client with the missing DOM structure. This happens upon
- # most of the calls requesting node ids.
- event setChildNodes
- parameters
- # Parent node id to populate with children.
- NodeId parentId
- # Child nodes array.
- array of Node nodes
-
- # Called when shadow root is popped from the element.
- experimental event shadowRootPopped
- parameters
- # Host element id.
- NodeId hostId
- # Shadow root id.
- NodeId rootId
-
- # Called when shadow root is pushed into the element.
- experimental event shadowRootPushed
- parameters
- # Host element id.
- NodeId hostId
- # Shadow root.
- Node root
-
-# 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.
-domain DOMDebugger
- depends on DOM
- depends on Runtime
-
- # DOM breakpoint type.
- type DOMBreakpointType extends string
- enum
- subtree-modified
- attribute-modified
- node-removed
-
- # CSP Violation type.
- experimental type CSPViolationType extends string
- enum
- trustedtype-sink-violation
- trustedtype-policy-violation
-
- # Object event listener.
- type EventListener extends object
- properties
- # `EventListener`'s type.
- string type
- # `EventListener`'s useCapture.
- boolean useCapture
- # `EventListener`'s passive flag.
- boolean passive
- # `EventListener`'s once flag.
- boolean once
- # Script id of the handler code.
- Runtime.ScriptId scriptId
- # Line number in the script (0-based).
- integer lineNumber
- # Column number in the script (0-based).
- integer columnNumber
- # Event handler function value.
- optional Runtime.RemoteObject handler
- # Event original handler function value.
- optional Runtime.RemoteObject originalHandler
- # Node the listener is added to (if any).
- optional DOM.BackendNodeId backendNodeId
-
- # Returns event listeners of the given object.
- command getEventListeners
- parameters
- # Identifier of the object to return listeners for.
- Runtime.RemoteObjectId objectId
- # The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the
- # entire subtree or provide an integer larger than 0.
- optional integer depth
- # Whether or not iframes and shadow roots should be traversed when returning the subtree
- # (default is false). Reports listeners for all contexts if pierce is enabled.
- optional boolean pierce
- returns
- # Array of relevant listeners.
- array of EventListener listeners
-
- # Removes DOM breakpoint that was set using `setDOMBreakpoint`.
- command removeDOMBreakpoint
- parameters
- # Identifier of the node to remove breakpoint from.
- DOM.NodeId nodeId
- # Type of the breakpoint to remove.
- DOMBreakpointType type
-
- # Removes breakpoint on particular DOM event.
- command removeEventListenerBreakpoint
- parameters
- # Event name.
- string eventName
- # EventTarget interface name.
- experimental optional string targetName
-
- # Removes breakpoint on particular native event.
- experimental deprecated command removeInstrumentationBreakpoint
- redirect EventBreakpoints
- parameters
- # Instrumentation name to stop on.
- string eventName
-
- # Removes breakpoint from XMLHttpRequest.
- command removeXHRBreakpoint
- parameters
- # Resource URL substring.
- string url
-
- # Sets breakpoint on particular CSP violations.
- experimental command setBreakOnCSPViolation
- parameters
- # CSP Violations to stop upon.
- array of CSPViolationType violationTypes
-
- # Sets breakpoint on particular operation with DOM.
- command setDOMBreakpoint
- parameters
- # Identifier of the node to set breakpoint on.
- DOM.NodeId nodeId
- # Type of the operation to stop upon.
- DOMBreakpointType type
-
- # Sets breakpoint on particular DOM event.
- command setEventListenerBreakpoint
- parameters
- # DOM Event name to stop on (any DOM event will do).
- string eventName
- # EventTarget interface name to stop on. If equal to `"*"` or not provided, will stop on any
- # EventTarget.
- experimental optional string targetName
-
- # Sets breakpoint on particular native event.
- experimental deprecated command setInstrumentationBreakpoint
- redirect EventBreakpoints
- parameters
- # Instrumentation name to stop on.
- string eventName
-
- # Sets breakpoint on XMLHttpRequest.
- command setXHRBreakpoint
- parameters
- # Resource URL substring. All XHRs having this substring in the URL will get stopped upon.
- string url
-
-# EventBreakpoints permits setting JavaScript breakpoints on operations and events
-# occurring in native code invoked from JavaScript. Once breakpoint is hit, it is
-# reported through Debugger domain, similarly to regular breakpoints being hit.
-experimental domain EventBreakpoints
- # Sets breakpoint on particular native event.
- command setInstrumentationBreakpoint
- parameters
- # Instrumentation name to stop on.
- string eventName
-
- # Removes breakpoint on particular native event.
- command removeInstrumentationBreakpoint
- parameters
- # Instrumentation name to stop on.
- string eventName
-
- # Removes all breakpoints
- command disable
-
-# This domain facilitates obtaining document snapshots with DOM, layout, and style information.
-experimental domain DOMSnapshot
- depends on CSS
- depends on DOM
- depends on DOMDebugger
- depends on Page
-
- # A Node in the DOM tree.
- type DOMNode extends object
- properties
- # `Node`'s nodeType.
- integer nodeType
- # `Node`'s nodeName.
- string nodeName
- # `Node`'s nodeValue.
- string nodeValue
- # Only set for textarea elements, contains the text value.
- optional string textValue
- # Only set for input elements, contains the input's associated text value.
- optional string inputValue
- # Only set for radio and checkbox input elements, indicates if the element has been checked
- optional boolean inputChecked
- # Only set for option elements, indicates if the element has been selected
- optional boolean optionSelected
- # `Node`'s id, corresponds to DOM.Node.backendNodeId.
- DOM.BackendNodeId backendNodeId
- # The indexes of the node's child nodes in the `domNodes` array returned by `getSnapshot`, if
- # any.
- optional array of integer childNodeIndexes
- # Attributes of an `Element` node.
- optional array of NameValue attributes
- # Indexes of pseudo elements associated with this node in the `domNodes` array returned by
- # `getSnapshot`, if any.
- optional array of integer pseudoElementIndexes
- # The index of the node's related layout tree node in the `layoutTreeNodes` array returned by
- # `getSnapshot`, if any.
- optional integer layoutNodeIndex
- # Document URL that `Document` or `FrameOwner` node points to.
- optional string documentURL
- # Base URL that `Document` or `FrameOwner` node uses for URL completion.
- optional string baseURL
- # Only set for documents, contains the document's content language.
- optional string contentLanguage
- # Only set for documents, contains the document's character set encoding.
- optional string documentEncoding
- # `DocumentType` node's publicId.
- optional string publicId
- # `DocumentType` node's systemId.
- optional string systemId
- # Frame ID for frame owner elements and also for the document node.
- optional Page.FrameId frameId
- # The index of a frame owner element's content document in the `domNodes` array returned by
- # `getSnapshot`, if any.
- optional integer contentDocumentIndex
- # Type of a pseudo element node.
- optional DOM.PseudoType pseudoType
- # Shadow root type.
- optional DOM.ShadowRootType shadowRootType
- # Whether this DOM node responds to mouse clicks. This includes nodes that have had click
- # event listeners attached via JavaScript as well as anchor tags that naturally navigate when
- # clicked.
- optional boolean isClickable
- # Details of the node's event listeners, if any.
- optional array of DOMDebugger.EventListener eventListeners
- # The selected url for nodes with a srcset attribute.
- optional string currentSourceURL
- # The url of the script (if any) that generates this node.
- optional string originURL
- # Scroll offsets, set when this node is a Document.
- optional number scrollOffsetX
- optional number scrollOffsetY
-
- # Details of post layout rendered text positions. The exact layout should not be regarded as
- # stable and may change between versions.
- type InlineTextBox extends object
- properties
- # The bounding box in document coordinates. Note that scroll offset of the document is ignored.
- DOM.Rect boundingBox
- # The starting index in characters, for this post layout textbox substring. Characters that
- # would be represented as a surrogate pair in UTF-16 have length 2.
- integer startCharacterIndex
- # The number of characters in this post layout textbox substring. Characters that would be
- # represented as a surrogate pair in UTF-16 have length 2.
- integer numCharacters
-
- # Details of an element in the DOM tree with a LayoutObject.
- type LayoutTreeNode extends object
- properties
- # The index of the related DOM node in the `domNodes` array returned by `getSnapshot`.
- integer domNodeIndex
- # The bounding box in document coordinates. Note that scroll offset of the document is ignored.
- DOM.Rect boundingBox
- # Contents of the LayoutText, if any.
- optional string layoutText
- # The post-layout inline text nodes, if any.
- optional array of InlineTextBox inlineTextNodes
- # Index into the `computedStyles` array returned by `getSnapshot`.
- optional integer styleIndex
- # Global paint order index, which is determined by the stacking order of the nodes. Nodes
- # that are painted together will have the same index. Only provided if includePaintOrder in
- # getSnapshot was true.
- optional integer paintOrder
- # Set to true to indicate the element begins a new stacking context.
- optional boolean isStackingContext
-
- # A subset of the full ComputedStyle as defined by the request whitelist.
- type ComputedStyle extends object
- properties
- # Name/value pairs of computed style properties.
- array of NameValue properties
-
- # A name/value pair.
- type NameValue extends object
- properties
- # Attribute/property name.
- string name
- # Attribute/property value.
- string value
-
- # Index of the string in the strings table.
- type StringIndex extends integer
-
- # Index of the string in the strings table.
- type ArrayOfStrings extends array of StringIndex
-
- # Data that is only present on rare nodes.
- type RareStringData extends object
- properties
- array of integer index
- array of StringIndex value
-
- type RareBooleanData extends object
- properties
- array of integer index
-
- type RareIntegerData extends object
- properties
- array of integer index
- array of integer value
-
- type Rectangle extends array of number
-
- # Document snapshot.
- type DocumentSnapshot extends object
- properties
- # Document URL that `Document` or `FrameOwner` node points to.
- StringIndex documentURL
- # Document title.
- StringIndex title
- # Base URL that `Document` or `FrameOwner` node uses for URL completion.
- StringIndex baseURL
- # Contains the document's content language.
- StringIndex contentLanguage
- # Contains the document's character set encoding.
- StringIndex encodingName
- # `DocumentType` node's publicId.
- StringIndex publicId
- # `DocumentType` node's systemId.
- StringIndex systemId
- # Frame ID for frame owner elements and also for the document node.
- StringIndex frameId
- # A table with dom nodes.
- NodeTreeSnapshot nodes
- # The nodes in the layout tree.
- LayoutTreeSnapshot layout
- # The post-layout inline text nodes.
- TextBoxSnapshot textBoxes
- # Horizontal scroll offset.
- optional number scrollOffsetX
- # Vertical scroll offset.
- optional number scrollOffsetY
- # Document content width.
- optional number contentWidth
- # Document content height.
- optional number contentHeight
-
- # Table containing nodes.
- type NodeTreeSnapshot extends object
- properties
- # Parent node index.
- optional array of integer parentIndex
- # `Node`'s nodeType.
- optional array of integer nodeType
- # Type of the shadow root the `Node` is in. String values are equal to the `ShadowRootType` enum.
- optional RareStringData shadowRootType
- # `Node`'s nodeName.
- optional array of StringIndex nodeName
- # `Node`'s nodeValue.
- optional array of StringIndex nodeValue
- # `Node`'s id, corresponds to DOM.Node.backendNodeId.
- optional array of DOM.BackendNodeId backendNodeId
- # Attributes of an `Element` node. Flatten name, value pairs.
- optional array of ArrayOfStrings attributes
- # Only set for textarea elements, contains the text value.
- optional RareStringData textValue
- # Only set for input elements, contains the input's associated text value.
- optional RareStringData inputValue
- # Only set for radio and checkbox input elements, indicates if the element has been checked
- optional RareBooleanData inputChecked
- # Only set for option elements, indicates if the element has been selected
- optional RareBooleanData optionSelected
- # The index of the document in the list of the snapshot documents.
- optional RareIntegerData contentDocumentIndex
- # Type of a pseudo element node.
- optional RareStringData pseudoType
- # Pseudo element identifier for this node. Only present if there is a
- # valid pseudoType.
- optional RareStringData pseudoIdentifier
- # Whether this DOM node responds to mouse clicks. This includes nodes that have had click
- # event listeners attached via JavaScript as well as anchor tags that naturally navigate when
- # clicked.
- optional RareBooleanData isClickable
- # The selected url for nodes with a srcset attribute.
- optional RareStringData currentSourceURL
- # The url of the script (if any) that generates this node.
- optional RareStringData originURL
-
- # Table of details of an element in the DOM tree with a LayoutObject.
- type LayoutTreeSnapshot extends object
- properties
- # Index of the corresponding node in the `NodeTreeSnapshot` array returned by `captureSnapshot`.
- array of integer nodeIndex
- # Array of indexes specifying computed style strings, filtered according to the `computedStyles` parameter passed to `captureSnapshot`.
- array of ArrayOfStrings styles
- # The absolute position bounding box.
- array of Rectangle bounds
- # Contents of the LayoutText, if any.
- array of StringIndex text
- # Stacking context information.
- RareBooleanData stackingContexts
- # Global paint order index, which is determined by the stacking order of the nodes. Nodes
- # that are painted together will have the same index. Only provided if includePaintOrder in
- # captureSnapshot was true.
- optional array of integer paintOrders
- # The offset rect of nodes. Only available when includeDOMRects is set to true
- optional array of Rectangle offsetRects
- # The scroll rect of nodes. Only available when includeDOMRects is set to true
- optional array of Rectangle scrollRects
- # The client rect of nodes. Only available when includeDOMRects is set to true
- optional array of Rectangle clientRects
- # The list of background colors that are blended with colors of overlapping elements.
- experimental optional array of StringIndex blendedBackgroundColors
- # The list of computed text opacities.
- experimental optional array of number textColorOpacities
-
- # Table of details of the post layout rendered text positions. The exact layout should not be regarded as
- # stable and may change between versions.
- type TextBoxSnapshot extends object
- properties
- # Index of the layout tree node that owns this box collection.
- array of integer layoutIndex
- # The absolute position bounding box.
- array of Rectangle bounds
- # The starting index in characters, for this post layout textbox substring. Characters that
- # would be represented as a surrogate pair in UTF-16 have length 2.
- array of integer start
- # The number of characters in this post layout textbox substring. Characters that would be
- # represented as a surrogate pair in UTF-16 have length 2.
- array of integer length
-
- # Disables DOM snapshot agent for the given page.
- command disable
-
- # Enables DOM snapshot agent for the given page.
- command enable
-
- # Returns a document snapshot, including the full DOM tree of the root node (including iframes,
- # template contents, and imported documents) in a flattened array, as well as layout and
- # white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
- # flattened.
- deprecated command getSnapshot
- parameters
- # Whitelist of computed styles to return.
- array of string computedStyleWhitelist
- # Whether or not to retrieve details of DOM listeners (default false).
- optional boolean includeEventListeners
- # Whether to determine and include the paint order index of LayoutTreeNodes (default false).
- optional boolean includePaintOrder
- # Whether to include UA shadow tree in the snapshot (default false).
- optional boolean includeUserAgentShadowTree
- returns
- # The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
- array of DOMNode domNodes
- # The nodes in the layout tree.
- array of LayoutTreeNode layoutTreeNodes
- # Whitelisted ComputedStyle properties for each node in the layout tree.
- array of ComputedStyle computedStyles
-
- # Returns a document snapshot, including the full DOM tree of the root node (including iframes,
- # template contents, and imported documents) in a flattened array, as well as layout and
- # white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
- # flattened.
- command captureSnapshot
- parameters
- # Whitelist of computed styles to return.
- array of string computedStyles
- # Whether to include layout object paint orders into the snapshot.
- optional boolean includePaintOrder
- # Whether to include DOM rectangles (offsetRects, clientRects, scrollRects) into the snapshot
- optional boolean includeDOMRects
- # Whether to include blended background colors in the snapshot (default: false).
- # Blended background color is achieved by blending background colors of all elements
- # that overlap with the current element.
- experimental optional boolean includeBlendedBackgroundColors
- # Whether to include text color opacity in the snapshot (default: false).
- # An element might have the opacity property set that affects the text color of the element.
- # The final text color opacity is computed based on the opacity of all overlapping elements.
- experimental optional boolean includeTextColorOpacities
- returns
- # The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
- array of DocumentSnapshot documents
- # Shared string table that all string properties refer to with indexes.
- array of string strings
-
-# Query and modify DOM storage.
-experimental domain DOMStorage
-
- type SerializedStorageKey extends string
-
- # DOM Storage identifier.
- type StorageId extends object
- properties
- # Security origin for the storage.
- optional string securityOrigin
- # Represents a key by which DOM Storage keys its CachedStorageAreas
- optional SerializedStorageKey storageKey
- # Whether the storage is local storage (not session storage).
- boolean isLocalStorage
-
- # DOM Storage item.
- type Item extends array of string
-
- command clear
- parameters
- StorageId storageId
-
- # Disables storage tracking, prevents storage events from being sent to the client.
- command disable
-
- # Enables storage tracking, storage events will now be delivered to the client.
- command enable
-
- command getDOMStorageItems
- parameters
- StorageId storageId
- returns
- array of Item entries
-
- command removeDOMStorageItem
- parameters
- StorageId storageId
- string key
-
- command setDOMStorageItem
- parameters
- StorageId storageId
- string key
- string value
-
- event domStorageItemAdded
- parameters
- StorageId storageId
- string key
- string newValue
-
- event domStorageItemRemoved
- parameters
- StorageId storageId
- string key
-
- event domStorageItemUpdated
- parameters
- StorageId storageId
- string key
- string oldValue
- string newValue
-
- event domStorageItemsCleared
- parameters
- StorageId storageId
-
-experimental domain DeviceOrientation
-
- # Clears the overridden Device Orientation.
- command clearDeviceOrientationOverride
-
- # Overrides the Device Orientation.
- command setDeviceOrientationOverride
- parameters
- # Mock alpha
- number alpha
- # Mock beta
- number beta
- # Mock gamma
- number gamma
-
-# This domain emulates different environments for the page.
-domain Emulation
- depends on DOM
- depends on Page
- depends on Runtime
-
- experimental type SafeAreaInsets extends object
- properties
- # Overrides safe-area-inset-top.
- optional integer top
- # Overrides safe-area-max-inset-top.
- optional integer topMax
- # Overrides safe-area-inset-left.
- optional integer left
- # Overrides safe-area-max-inset-left.
- optional integer leftMax
- # Overrides safe-area-inset-bottom.
- optional integer bottom
- # Overrides safe-area-max-inset-bottom.
- optional integer bottomMax
- # Overrides safe-area-inset-right.
- optional integer right
- # Overrides safe-area-max-inset-right.
- optional integer rightMax
-
- # Screen orientation.
- type ScreenOrientation extends object
- properties
- # Orientation type.
- enum type
- portraitPrimary
- portraitSecondary
- landscapePrimary
- landscapeSecondary
- # Orientation angle.
- integer angle
-
- type DisplayFeature extends object
- properties
- # Orientation of a display feature in relation to screen
- enum orientation
- vertical
- horizontal
- # The offset from the screen origin in either the x (for vertical
- # orientation) or y (for horizontal orientation) direction.
- integer offset
- # A display feature may mask content such that it is not physically
- # displayed - this length along with the offset describes this area.
- # A display feature that only splits content will have a 0 mask_length.
- integer maskLength
-
- type DevicePosture extends object
- properties
- # Current posture of the device
- enum type
- continuous
- folded
-
- type MediaFeature extends object
- properties
- string name
- string value
-
- # 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.
- experimental type VirtualTimePolicy extends string
- enum
- advance
- pause
- pauseIfNetworkFetchesPending
-
- # Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
- experimental type UserAgentBrandVersion extends object
- properties
- string brand
- string version
-
- # Used to specify User Agent Client 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.
- experimental type UserAgentMetadata extends object
- properties
- # Brands appearing in Sec-CH-UA.
- optional array of UserAgentBrandVersion brands
- # Brands appearing in Sec-CH-UA-Full-Version-List.
- optional array of UserAgentBrandVersion fullVersionList
- deprecated optional string fullVersion
- string platform
- string platformVersion
- string architecture
- string model
- boolean mobile
- optional string bitness
- optional boolean wow64
- # Used to specify User Agent form-factor values.
- # See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
- optional array of string formFactors
-
- # Used to specify sensor types to emulate.
- # See https://w3c.github.io/sensors/#automation for more information.
- experimental type SensorType extends string
- enum
- absolute-orientation
- accelerometer
- ambient-light
- gravity
- gyroscope
- linear-acceleration
- magnetometer
- relative-orientation
-
- experimental type SensorMetadata extends object
- properties
- optional boolean available
- optional number minimumFrequency
- optional number maximumFrequency
-
- experimental type SensorReadingSingle extends object
- properties
- number value
-
- experimental type SensorReadingXYZ extends object
- properties
- number x
- number y
- number z
-
- experimental type SensorReadingQuaternion extends object
- properties
- number x
- number y
- number z
- number w
-
- experimental type SensorReading extends object
- properties
- optional SensorReadingSingle single
- optional SensorReadingXYZ xyz
- optional SensorReadingQuaternion quaternion
-
- experimental type PressureSource extends string
- enum
- cpu
-
- experimental type PressureState extends string
- enum
- nominal
- fair
- serious
- critical
-
- experimental type PressureMetadata extends object
- properties
- optional boolean available
-
- # Tells whether emulation is supported.
- deprecated command canEmulate
- returns
- # True if emulation is supported.
- boolean result
-
- # Clears the overridden device metrics.
- command clearDeviceMetricsOverride
-
- # Clears the overridden Geolocation Position and Error.
- command clearGeolocationOverride
-
- # Requests that page scale factor is reset to initial values.
- experimental command resetPageScaleFactor
-
- # Enables or disables simulating a focused and active page.
- experimental command setFocusEmulationEnabled
- parameters
- # Whether to enable to disable focus emulation.
- boolean enabled
-
- # Automatically render all web contents using a dark theme.
- experimental command setAutoDarkModeOverride
- parameters
- # Whether to enable or disable automatic dark mode.
- # If not specified, any existing override will be cleared.
- optional boolean enabled
-
- # Enables CPU throttling to emulate slow CPUs.
- command setCPUThrottlingRate
- parameters
- # Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
- number rate
-
- # Sets or clears an override of the default background color of the frame. This override is used
- # if the content does not specify one.
- command setDefaultBackgroundColorOverride
- parameters
- # RGBA of the default background color. If not specified, any existing override will be
- # cleared.
- optional DOM.RGBA color
-
- # Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
- # respective variables to be undefined, even if previously overridden.
- experimental command setSafeAreaInsetsOverride
- parameters
- SafeAreaInsets insets
-
- # Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
- # window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
- # query results).
- command setDeviceMetricsOverride
- parameters
- # Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
- integer width
- # Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
- integer height
- # Overriding device scale factor value. 0 disables the override.
- number deviceScaleFactor
- # Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
- # autosizing and more.
- boolean mobile
- # Scale to apply to resulting view image.
- experimental optional number scale
- # Overriding screen width value in pixels (minimum 0, maximum 10000000).
- experimental optional integer screenWidth
- # Overriding screen height value in pixels (minimum 0, maximum 10000000).
- experimental optional integer screenHeight
- # Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
- experimental optional integer positionX
- # Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
- experimental optional integer positionY
- # Do not set visible view size, rely upon explicit setVisibleSize call.
- experimental optional boolean dontSetVisibleSize
- # Screen orientation override.
- optional ScreenOrientation screenOrientation
- # If set, the visible area of the page will be overridden to this viewport. This viewport
- # change is not observed by the page, e.g. viewport-relative elements do not change positions.
- experimental optional Page.Viewport viewport
- # If set, the display feature of a multi-segment screen. If not set, multi-segment support
- # is turned-off.
- # Deprecated, use Emulation.setDisplayFeaturesOverride.
- experimental deprecated optional DisplayFeature displayFeature
- # If set, the posture of a foldable device. If not set the posture is set
- # to continuous.
- # Deprecated, use Emulation.setDevicePostureOverride.
- experimental deprecated optional DevicePosture devicePosture
-
- # Start reporting the given posture value to the Device Posture API.
- # This override can also be set in setDeviceMetricsOverride().
- experimental command setDevicePostureOverride
- parameters
- DevicePosture posture
-
- # Clears a device posture override set with either setDeviceMetricsOverride()
- # or setDevicePostureOverride() and starts using posture information from the
- # platform again.
- # Does nothing if no override is set.
- experimental command clearDevicePostureOverride
-
- # Start using the given display features to pupulate the Viewport Segments API.
- # This override can also be set in setDeviceMetricsOverride().
- experimental command setDisplayFeaturesOverride
- parameters
- array of DisplayFeature features
-
- # Clears the display features override set with either setDeviceMetricsOverride()
- # or setDisplayFeaturesOverride() and starts using display features from the
- # platform again.
- # Does nothing if no override is set.
- experimental command clearDisplayFeaturesOverride
-
- experimental command setScrollbarsHidden
- parameters
- # Whether scrollbars should be always hidden.
- boolean hidden
-
- experimental command setDocumentCookieDisabled
- parameters
- # Whether document.coookie API should be disabled.
- boolean disabled
-
- experimental command setEmitTouchEventsForMouse
- parameters
- # Whether touch emulation based on mouse input should be enabled.
- boolean enabled
- # Touch/gesture events configuration. Default: current platform.
- optional enum configuration
- mobile
- desktop
-
- # Emulates the given media type or media feature for CSS media queries.
- command setEmulatedMedia
- parameters
- # Media type to emulate. Empty string disables the override.
- optional string media
- # Media features to emulate.
- optional array of MediaFeature features
-
- # Emulates the given vision deficiency.
- command setEmulatedVisionDeficiency
- parameters
- # Vision deficiency to emulate. Order: best-effort emulations come first, followed by any
- # physiologically accurate emulations for medically recognized color vision deficiencies.
- enum type
- none
- blurredVision
- reducedContrast
- achromatopsia
- deuteranopia
- protanopia
- tritanopia
-
- # Emulates the given OS text scale.
- command setEmulatedOSTextScale
- parameters
- optional number scale
-
- # Overrides the Geolocation Position or Error. Omitting latitude, longitude or
- # accuracy emulates position unavailable.
- command setGeolocationOverride
- parameters
- # Mock latitude
- optional number latitude
- # Mock longitude
- optional number longitude
- # Mock accuracy
- optional number accuracy
- # Mock altitude
- optional number altitude
- # Mock altitudeAccuracy
- optional number altitudeAccuracy
- # Mock heading
- optional number heading
- # Mock speed
- optional number speed
-
- experimental command getOverriddenSensorInformation
- parameters
- SensorType type
- returns
- number requestedSamplingFrequency
-
- # Overrides a platform sensor of a given type. If |enabled| is true, calls to
- # Sensor.start() will use a virtual sensor as backend rather than fetching
- # data from a real hardware sensor. Otherwise, existing virtual
- # sensor-backend Sensor objects will fire an error event and new calls to
- # Sensor.start() will attempt to use a real sensor instead.
- experimental command setSensorOverrideEnabled
- parameters
- boolean enabled
- SensorType type
- optional SensorMetadata metadata
-
- # Updates the sensor readings reported by a sensor type previously overridden
- # by setSensorOverrideEnabled.
- experimental command setSensorOverrideReadings
- parameters
- SensorType type
- SensorReading reading
-
- # Overrides a pressure source of a given type, as used by the Compute
- # Pressure API, so that updates to PressureObserver.observe() are provided
- # via setPressureStateOverride instead of being retrieved from
- # platform-provided telemetry data.
- experimental command setPressureSourceOverrideEnabled
- parameters
- boolean enabled
- PressureSource source
- optional PressureMetadata metadata
-
- # TODO: OBSOLETE: To remove when setPressureDataOverride is merged.
- # Provides a given pressure state that will be processed and eventually be
- # delivered to PressureObserver users. |source| must have been previously
- # overridden by setPressureSourceOverrideEnabled.
- experimental command setPressureStateOverride
- parameters
- PressureSource source
- PressureState state
-
- # Provides a given pressure data set that will be processed and eventually be
- # delivered to PressureObserver users. |source| must have been previously
- # overridden by setPressureSourceOverrideEnabled.
- experimental command setPressureDataOverride
- parameters
- PressureSource source
- PressureState state
- optional number ownContributionEstimate
-
- # Overrides the Idle state.
- command setIdleOverride
- parameters
- # Mock isUserActive
- boolean isUserActive
- # Mock isScreenUnlocked
- boolean isScreenUnlocked
-
- # Clears Idle state overrides.
- command clearIdleOverride
-
- # Overrides value returned by the javascript navigator object.
- experimental deprecated command setNavigatorOverrides
- parameters
- # The platform navigator.platform should return.
- string platform
-
- # Sets a specified page scale factor.
- experimental command setPageScaleFactor
- parameters
- # Page scale factor.
- number pageScaleFactor
-
- # Switches script execution in the page.
- command setScriptExecutionDisabled
- parameters
- # Whether script execution should be disabled in the page.
- boolean value
-
- # Enables touch on platforms which do not support them.
- command setTouchEmulationEnabled
- parameters
- # Whether the touch event emulation should be enabled.
- boolean enabled
- # Maximum touch points supported. Defaults to one.
- optional integer maxTouchPoints
-
- # Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets
- # the current virtual time policy. Note this supersedes any previous time budget.
- experimental command setVirtualTimePolicy
- parameters
- VirtualTimePolicy policy
- # If set, after this many virtual milliseconds have elapsed virtual time will be paused and a
- # virtualTimeBudgetExpired event is sent.
- optional number budget
- # If set this specifies the maximum number of tasks that can be run before virtual is forced
- # forwards to prevent deadlock.
- optional integer maxVirtualTimeTaskStarvationCount
- # If set, base::Time::Now will be overridden to initially return this value.
- optional Network.TimeSinceEpoch initialVirtualTime
- returns
- # Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
- number virtualTimeTicksBase
-
- # Overrides default host system locale with the specified one.
- experimental command setLocaleOverride
- parameters
- # ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and
- # restores default host system locale.
- optional string locale
-
- # Overrides default host system timezone with the specified one.
- command setTimezoneOverride
- parameters
- # The timezone identifier. List of supported timezones:
- # https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt
- # If empty, disables the override and restores default host system timezone.
- string timezoneId
-
- # Resizes the frame/viewport of the page. Note that this does not affect the frame's container
- # (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported
- # on Android.
- experimental deprecated command setVisibleSize
- parameters
- # Frame width (DIP).
- integer width
- # Frame height (DIP).
- integer height
-
- # Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
- experimental event virtualTimeBudgetExpired
-
- # Enum of image types that can be disabled.
- experimental type DisabledImageType extends string
- enum
- avif
- webp
-
- experimental command setDisabledImageTypes
- parameters
- # Image types to disable.
- array of DisabledImageType imageTypes
-
-
- # Override the value of navigator.connection.saveData
- experimental command setDataSaverOverride
- parameters
- # Override value. Omitting the parameter disables the override.
- optional boolean dataSaverEnabled
-
- experimental command setHardwareConcurrencyOverride
- parameters
- # Hardware concurrency to report
- integer hardwareConcurrency
-
- # Allows overriding user agent with the given string.
- # `userAgentMetadata` must be set for Client Hint headers to be sent.
- command setUserAgentOverride
- parameters
- # User agent to use.
- string userAgent
- # Browser language to emulate.
- optional string acceptLanguage
- # The platform navigator.platform should return.
- optional string platform
- # To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
- experimental optional UserAgentMetadata userAgentMetadata
-
- # Allows overriding the automation flag.
- experimental command setAutomationOverride
- parameters
- # Whether the override should be enabled.
- boolean enabled
-
- # Allows overriding the difference between the small and large viewport sizes, which determine the
- # value of the `svh` and `lvh` unit, respectively. Only supported for top-level frames.
- experimental command setSmallViewportHeightDifferenceOverride
- parameters
- # This will cause an element of size 100svh to be `difference` pixels smaller than an element
- # of size 100lvh.
- integer difference
-
-# This domain provides experimental commands only supported in headless mode.
-experimental domain HeadlessExperimental
- depends on Page
- depends on Runtime
-
- # Encoding options for a screenshot.
- type ScreenshotParams extends object
- properties
- # Image compression format (defaults to png).
- optional enum format
- jpeg
- png
- webp
- # Compression quality from range [0..100] (jpeg and webp only).
- optional integer quality
- # Optimize image encoding for speed, not for resulting size (defaults to false)
- optional boolean optimizeForSpeed
-
- # Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
- # screenshot from the resulting frame. Requires that the target was created with enabled
- # BeginFrameControl. Designed for use with --run-all-compositor-stages-before-draw, see also
- # https://goo.gle/chrome-headless-rendering for more background.
- command beginFrame
- parameters
- # Timestamp of this BeginFrame in Renderer TimeTicks (milliseconds of uptime). If not set,
- # the current time will be used.
- optional number frameTimeTicks
- # The interval between BeginFrames that is reported to the compositor, in milliseconds.
- # Defaults to a 60 frames/second interval, i.e. about 16.666 milliseconds.
- optional number interval
- # Whether updates should not be committed and drawn onto the display. False by default. If
- # true, only side effects of the BeginFrame will be run, such as layout and animations, but
- # any visual updates may not be visible on the display or in screenshots.
- optional boolean noDisplayUpdates
- # If set, a screenshot of the frame will be captured and returned in the response. Otherwise,
- # no screenshot will be captured. Note that capturing a screenshot can fail, for example,
- # during renderer initialization. In such a case, no screenshot data will be returned.
- optional ScreenshotParams screenshot
- returns
- # Whether the BeginFrame resulted in damage and, thus, a new frame was committed to the
- # display. Reported for diagnostic uses, may be removed in the future.
- boolean hasDamage
- # Base64-encoded image data of the screenshot, if one was requested and successfully taken.
- optional binary screenshotData
-
- # Disables headless events for the target.
- deprecated command disable
-
- # Enables headless events for the target.
- deprecated command enable
-
-# Input/Output operations for streams produced by DevTools.
-domain IO
-
- # This is either obtained from another method or specified as `blob:<uuid>` where
- # `<uuid>` is an UUID of a Blob.
- type StreamHandle extends string
-
- # Close the stream, discard any temporary backing storage.
- command close
- parameters
- # Handle of the stream to close.
- StreamHandle handle
-
- # Read a chunk of the stream
- command read
- parameters
- # Handle of the stream to read.
- StreamHandle handle
- # Seek to the specified offset before reading (if not specified, proceed with offset
- # following the last read). Some types of streams may only support sequential reads.
- optional integer offset
- # Maximum number of bytes to read (left upon the agent discretion if not specified).
- optional integer size
- returns
- # Set if the data is base64-encoded
- optional boolean base64Encoded
- # Data that were read.
- string data
- # Set if the end-of-file condition occurred while reading.
- boolean eof
-
- # Return UUID of Blob object specified by a remote object id.
- command resolveBlob
- parameters
- # Object id of a Blob object wrapper.
- Runtime.RemoteObjectId objectId
- returns
- # UUID of the specified Blob.
- string uuid
-
-experimental domain FileSystem
- depends on Network
- depends on Storage
-
- type File extends object
- properties
- string name
- # Timestamp
- Network.TimeSinceEpoch lastModified
- # Size in bytes
- number size
- string type
-
- type Directory extends object
- properties
- string name
- array of string nestedDirectories
- # Files that are directly nested under this directory.
- array of File nestedFiles
-
- type BucketFileSystemLocator extends object
- properties
- # Storage key
- Storage.SerializedStorageKey storageKey
- # Bucket name. Not passing a `bucketName` will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
- optional string bucketName
- # Path to the directory using each path component as an array item.
- array of string pathComponents
-
- command getDirectory
- parameters
- BucketFileSystemLocator bucketFileSystemLocator
- returns
- # Returns the directory object at the path.
- Directory directory
-
-experimental domain IndexedDB
- depends on Runtime
- depends on Storage
-
- # Database with an array of object stores.
- type DatabaseWithObjectStores extends object
- properties
- # Database name.
- string name
- # Database version (type is not 'integer', as the standard
- # requires the version number to be 'unsigned long long')
- number version
- # Object stores in this database.
- array of ObjectStore objectStores
-
- # Object store.
- type ObjectStore extends object
- properties
- # Object store name.
- string name
- # Object store key path.
- KeyPath keyPath
- # If true, object store has auto increment flag set.
- boolean autoIncrement
- # Indexes in this object store.
- array of ObjectStoreIndex indexes
-
- # Object store index.
- type ObjectStoreIndex extends object
- properties
- # Index name.
- string name
- # Index key path.
- KeyPath keyPath
- # If true, index is unique.
- boolean unique
- # If true, index allows multiple entries for a key.
- boolean multiEntry
-
- # Key.
- type Key extends object
- properties
- # Key type.
- enum type
- number
- string
- date
- array
- # Number value.
- optional number number
- # String value.
- optional string string
- # Date value.
- optional number date
- # Array value.
- optional array of Key array
-
- # Key range.
- type KeyRange extends object
- properties
- # Lower bound.
- optional Key lower
- # Upper bound.
- optional Key upper
- # If true lower bound is open.
- boolean lowerOpen
- # If true upper bound is open.
- boolean upperOpen
-
- # Data entry.
- type DataEntry extends object
- properties
- # Key object.
- Runtime.RemoteObject key
- # Primary key object.
- Runtime.RemoteObject primaryKey
- # Value object.
- Runtime.RemoteObject value
-
- # Key path.
- type KeyPath extends object
- properties
- # Key path type.
- enum type
- null
- string
- array
- # String value.
- optional string string
- # Array value.
- optional array of string array
-
- # Clears all entries from an object store.
- command clearObjectStore
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- # Database name.
- string databaseName
- # Object store name.
- string objectStoreName
-
- # Deletes a database.
- command deleteDatabase
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- # Database name.
- string databaseName
-
- # Delete a range of entries from an object store
- command deleteObjectStoreEntries
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- string databaseName
- string objectStoreName
- # Range of entry keys to delete
- KeyRange keyRange
-
- # Disables events from backend.
- command disable
-
- # Enables events from backend.
- command enable
-
- # Requests data from object store or index.
- command requestData
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- # Database name.
- string databaseName
- # Object store name.
- string objectStoreName
- # Index name, empty string for object store data requests.
- string indexName
- # Number of records to skip.
- integer skipCount
- # Number of records to fetch.
- integer pageSize
- # Key range.
- optional KeyRange keyRange
- returns
- # Array of object store data entries.
- array of DataEntry objectStoreDataEntries
- # If true, there are more entries to fetch in the given range.
- boolean hasMore
-
- # Gets metadata of an object store.
- command getMetadata
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- # Database name.
- string databaseName
- # Object store name.
- string objectStoreName
- returns
- # the entries count
- number entriesCount
- # the current value of key generator, to become the next inserted
- # key into the object store. Valid if objectStore.autoIncrement
- # is true.
- number keyGeneratorValue
-
- # Requests database with given name in given frame.
- command requestDatabase
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- # Database name.
- string databaseName
- returns
- # Database with an array of object stores.
- DatabaseWithObjectStores databaseWithObjectStores
-
- # Requests database names for given security origin.
- command requestDatabaseNames
- parameters
- # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
- # Security origin.
- optional string securityOrigin
- # Storage key.
- optional string storageKey
- # Storage bucket. If not specified, it uses the default bucket.
- optional Storage.StorageBucket storageBucket
- returns
- # Database names for origin.
- array of string databaseNames
-
-domain Input
-
- type TouchPoint extends object
- properties
- # X coordinate of the event relative to the main frame's viewport in CSS pixels.
- number x
- # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
- # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
- number y
- # X radius of the touch area (default: 1.0).
- optional number radiusX
- # Y radius of the touch area (default: 1.0).
- optional number radiusY
- # Rotation angle (default: 0.0).
- optional number rotationAngle
- # Force (default: 1.0).
- optional number force
- # The normalized tangential pressure, which has a range of [-1,1] (default: 0).
- experimental optional number tangentialPressure
- # The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
- optional number tiltX
- # The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
- optional number tiltY
- # The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
- experimental optional integer twist
- # Identifier used to track touch sources between events, must be unique within an event.
- optional number id
-
- experimental type GestureSourceType extends string
- enum
- default
- touch
- mouse
-
- type MouseButton extends string
- enum
- none
- left
- middle
- right
- back
- forward
-
- # UTC time in seconds, counted from January 1, 1970.
- type TimeSinceEpoch extends number
-
- experimental type DragDataItem extends object
- properties
- # Mime type of the dragged data.
- string mimeType
- # Depending of the value of `mimeType`, it contains the dragged link,
- # text, HTML markup or any other data.
- string data
-
- # Title associated with a link. Only valid when `mimeType` == "text/uri-list".
- optional string title
-
- # Stores the base URL for the contained markup. Only valid when `mimeType`
- # == "text/html".
- optional string baseURL
-
-
- experimental type DragData extends object
- properties
- array of DragDataItem items
- # List of filenames that should be included when dropping
- optional array of string files
- # Bit field representing allowed drag operations. Copy = 1, Link = 2, Move = 16
- integer dragOperationsMask
-
- # Dispatches a drag event into the page.
- experimental command dispatchDragEvent
- parameters
- # Type of the drag event.
- enum type
- dragEnter
- dragOver
- drop
- dragCancel
- # X coordinate of the event relative to the main frame's viewport in CSS pixels.
- number x
- # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
- # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
- number y
- DragData data
- # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
- # (default: 0).
- optional integer modifiers
-
- # Dispatches a key event to the page.
- command dispatchKeyEvent
- parameters
- # Type of the key event.
- enum type
- keyDown
- keyUp
- rawKeyDown
- char
- # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
- # (default: 0).
- optional integer modifiers
- # Time at which the event occurred.
- optional TimeSinceEpoch timestamp
- # Text as generated by processing a virtual key code with a keyboard layout. Not needed for
- # for `keyUp` and `rawKeyDown` events (default: "")
- optional string text
- # Text that would have been generated by the keyboard if no modifiers were pressed (except for
- # shift). Useful for shortcut (accelerator) key handling (default: "").
- optional string unmodifiedText
- # Unique key identifier (e.g., 'U+0041') (default: "").
- optional string keyIdentifier
- # Unique DOM defined string value for each physical key (e.g., 'KeyA') (default: "").
- optional string code
- # Unique DOM defined string value describing the meaning of the key in the context of active
- # modifiers, keyboard layout, etc (e.g., 'AltGr') (default: "").
- optional string key
- # Windows virtual key code (default: 0).
- optional integer windowsVirtualKeyCode
- # Native virtual key code (default: 0).
- optional integer nativeVirtualKeyCode
- # Whether the event was generated from auto repeat (default: false).
- optional boolean autoRepeat
- # Whether the event was generated from the keypad (default: false).
- optional boolean isKeypad
- # Whether the event was a system key event (default: false).
- optional boolean isSystemKey
- # Whether the event was from the left or right side of the keyboard. 1=Left, 2=Right (default:
- # 0).
- optional integer location
- # Editing commands to send with the key event (e.g., 'selectAll') (default: []).
- # These are related to but not equal the command names used in `document.execCommand` and NSStandardKeyBindingResponding.
- # See https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/editing/commands/editor_command_names.h for valid command names.
- experimental optional array of string commands
-
- # This method emulates inserting text that doesn't come from a key press,
- # for example an emoji keyboard or an IME.
- experimental command insertText
- parameters
- # The text to insert.
- string text
-
- # This method sets the current candidate text for IME.
- # Use imeCommitComposition to commit the final text.
- # Use imeSetComposition with empty string as text to cancel composition.
- experimental command imeSetComposition
- parameters
- # The text to insert
- string text
- # selection start
- integer selectionStart
- # selection end
- integer selectionEnd
- # replacement start
- optional integer replacementStart
- # replacement end
- optional integer replacementEnd
-
- # Dispatches a mouse event to the page.
- command dispatchMouseEvent
- parameters
- # Type of the mouse event.
- enum type
- mousePressed
- mouseReleased
- mouseMoved
- mouseWheel
- # X coordinate of the event relative to the main frame's viewport in CSS pixels.
- number x
- # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
- # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
- number y
- # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
- # (default: 0).
- optional integer modifiers
- # Time at which the event occurred.
- optional TimeSinceEpoch timestamp
- # Mouse button (default: "none").
- optional MouseButton button
- # A number indicating which buttons are pressed on the mouse when a mouse event is triggered.
- # Left=1, Right=2, Middle=4, Back=8, Forward=16, None=0.
- optional integer buttons
- # Number of times the mouse button was clicked (default: 0).
- optional integer clickCount
- # The normalized pressure, which has a range of [0,1] (default: 0).
- experimental optional number force
- # The normalized tangential pressure, which has a range of [-1,1] (default: 0).
- experimental optional number tangentialPressure
- # The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0).
- optional number tiltX
- # The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
- optional number tiltY
- # The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
- experimental optional integer twist
- # X delta in CSS pixels for mouse wheel event (default: 0).
- optional number deltaX
- # Y delta in CSS pixels for mouse wheel event (default: 0).
- optional number deltaY
- # Pointer type (default: "mouse").
- optional enum pointerType
- mouse
- pen
-
- # Dispatches a touch event to the page.
- command dispatchTouchEvent
- parameters
- # Type of the touch event. TouchEnd and TouchCancel must not contain any touch points, while
- # TouchStart and TouchMove must contains at least one.
- enum type
- touchStart
- touchEnd
- touchMove
- touchCancel
- # Active touch points on the touch device. One event per any changed point (compared to
- # previous touch event in a sequence) is generated, emulating pressing/moving/releasing points
- # one by one.
- array of TouchPoint touchPoints
- # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
- # (default: 0).
- optional integer modifiers
- # Time at which the event occurred.
- optional TimeSinceEpoch timestamp
-
- # Cancels any active dragging in the page.
- command cancelDragging
-
- # Emulates touch event from the mouse event parameters.
- experimental command emulateTouchFromMouseEvent
- parameters
- # Type of the mouse event.
- enum type
- mousePressed
- mouseReleased
- mouseMoved
- mouseWheel
- # X coordinate of the mouse pointer in DIP.
- integer x
- # Y coordinate of the mouse pointer in DIP.
- integer y
- # Mouse button. Only "none", "left", "right" are supported.
- MouseButton button
- # Time at which the event occurred (default: current time).
- optional TimeSinceEpoch timestamp
- # X delta in DIP for mouse wheel event (default: 0).
- optional number deltaX
- # Y delta in DIP for mouse wheel event (default: 0).
- optional number deltaY
- # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
- # (default: 0).
- optional integer modifiers
- # Number of times the mouse button was clicked (default: 0).
- optional integer clickCount
-
- # Ignores input events (useful while auditing page).
- command setIgnoreInputEvents
- parameters
- # Ignores input events processing when set to true.
- boolean ignore
-
- # Prevents default drag and drop behavior and instead emits `Input.dragIntercepted` events.
- # Drag and drop behavior can be directly controlled via `Input.dispatchDragEvent`.
- experimental command setInterceptDrags
- parameters
- boolean enabled
-
- # Synthesizes a pinch gesture over a time period by issuing appropriate touch events.
- experimental command synthesizePinchGesture
- parameters
- # X coordinate of the start of the gesture in CSS pixels.
- number x
- # Y coordinate of the start of the gesture in CSS pixels.
- number y
- # Relative scale factor after zooming (>1.0 zooms in, <1.0 zooms out).
- number scaleFactor
- # Relative pointer speed in pixels per second (default: 800).
- optional integer relativeSpeed
- # Which type of input events to be generated (default: 'default', which queries the platform
- # for the preferred input type).
- optional GestureSourceType gestureSourceType
-
- # Synthesizes a scroll gesture over a time period by issuing appropriate touch events.
- experimental command synthesizeScrollGesture
- parameters
- # X coordinate of the start of the gesture in CSS pixels.
- number x
- # Y coordinate of the start of the gesture in CSS pixels.
- number y
- # The distance to scroll along the X axis (positive to scroll left).
- optional number xDistance
- # The distance to scroll along the Y axis (positive to scroll up).
- optional number yDistance
- # The number of additional pixels to scroll back along the X axis, in addition to the given
- # distance.
- optional number xOverscroll
- # The number of additional pixels to scroll back along the Y axis, in addition to the given
- # distance.
- optional number yOverscroll
- # Prevent fling (default: true).
- optional boolean preventFling
- # Swipe speed in pixels per second (default: 800).
- optional integer speed
- # Which type of input events to be generated (default: 'default', which queries the platform
- # for the preferred input type).
- optional GestureSourceType gestureSourceType
- # The number of times to repeat the gesture (default: 0).
- optional integer repeatCount
- # The number of milliseconds delay between each repeat. (default: 250).
- optional integer repeatDelayMs
- # The name of the interaction markers to generate, if not empty (default: "").
- optional string interactionMarkerName
-
- # Synthesizes a tap gesture over a time period by issuing appropriate touch events.
- experimental command synthesizeTapGesture
- parameters
- # X coordinate of the start of the gesture in CSS pixels.
- number x
- # Y coordinate of the start of the gesture in CSS pixels.
- number y
- # Duration between touchdown and touchup events in ms (default: 50).
- optional integer duration
- # Number of times to perform the tap (e.g. 2 for double tap, default: 1).
- optional integer tapCount
- # Which type of input events to be generated (default: 'default', which queries the platform
- # for the preferred input type).
- optional GestureSourceType gestureSourceType
-
- # Emitted only when `Input.setInterceptDrags` is enabled. Use this data with `Input.dispatchDragEvent` to
- # restore normal drag and drop behavior.
- experimental event dragIntercepted
- parameters
- DragData data
-
-experimental domain Inspector
-
- # Disables inspector domain notifications.
- command disable
-
- # Enables inspector domain notifications.
- command enable
-
- # Fired when remote debugging connection is about to be terminated. Contains detach reason.
- event detached
- parameters
- # The reason why connection has been terminated.
- string reason
-
- # Fired when debugging target has crashed
- event targetCrashed
-
- # Fired when debugging target has reloaded after crash
- event targetReloadedAfterCrash
-
-experimental domain LayerTree
- depends on DOM
-
- # Unique Layer identifier.
- type LayerId extends string
-
- # Unique snapshot identifier.
- type SnapshotId extends string
-
- # Rectangle where scrolling happens on the main thread.
- type ScrollRect extends object
- properties
- # Rectangle itself.
- DOM.Rect rect
- # Reason for rectangle to force scrolling on the main thread
- enum type
- RepaintsOnScroll
- TouchEventHandler
- WheelEventHandler
-
- # Sticky position constraints.
- type StickyPositionConstraint extends object
- properties
- # Layout rectangle of the sticky element before being shifted
- DOM.Rect stickyBoxRect
- # Layout rectangle of the containing block of the sticky element
- DOM.Rect containingBlockRect
- # The nearest sticky layer that shifts the sticky box
- optional LayerId nearestLayerShiftingStickyBox
- # The nearest sticky layer that shifts the containing block
- optional LayerId nearestLayerShiftingContainingBlock
-
- # Serialized fragment of layer picture along with its offset within the layer.
- type PictureTile extends object
- properties
- # Offset from owning layer left boundary
- number x
- # Offset from owning layer top boundary
- number y
- # Base64-encoded snapshot data.
- binary picture
-
- # Information about a compositing layer.
- type Layer extends object
- properties
- # The unique id for this layer.
- LayerId layerId
- # The id of parent (not present for root).
- optional LayerId parentLayerId
- # The backend id for the node associated with this layer.
- optional DOM.BackendNodeId backendNodeId
- # Offset from parent layer, X coordinate.
- number offsetX
- # Offset from parent layer, Y coordinate.
- number offsetY
- # Layer width.
- number width
- # Layer height.
- number height
- # Transformation matrix for layer, default is identity matrix
- optional array of number transform
- # Transform anchor point X, absent if no transform specified
- optional number anchorX
- # Transform anchor point Y, absent if no transform specified
- optional number anchorY
- # Transform anchor point Z, absent if no transform specified
- optional number anchorZ
- # Indicates how many time this layer has painted.
- integer paintCount
- # Indicates whether this layer hosts any content, rather than being used for
- # transform/scrolling purposes only.
- boolean drawsContent
- # Set if layer is not visible.
- optional boolean invisible
- # Rectangles scrolling on main thread only.
- optional array of ScrollRect scrollRects
- # Sticky position constraint information
- optional StickyPositionConstraint stickyPositionConstraint
-
- # Array of timings, one per paint step.
- type PaintProfile extends array of number
-
- # Provides the reasons why the given layer was composited.
- command compositingReasons
- parameters
- # The id of the layer for which we want to get the reasons it was composited.
- LayerId layerId
- returns
- # A list of strings specifying reasons for the given layer to become composited.
- array of string compositingReasons
- # A list of strings specifying reason IDs for the given layer to become composited.
- array of string compositingReasonIds
-
- # Disables compositing tree inspection.
- command disable
-
- # Enables compositing tree inspection.
- command enable
-
- # Returns the snapshot identifier.
- command loadSnapshot
- parameters
- # An array of tiles composing the snapshot.
- array of PictureTile tiles
- returns
- # The id of the snapshot.
- SnapshotId snapshotId
-
- # Returns the layer snapshot identifier.
- command makeSnapshot
- parameters
- # The id of the layer.
- LayerId layerId
- returns
- # The id of the layer snapshot.
- SnapshotId snapshotId
-
- command profileSnapshot
- parameters
- # The id of the layer snapshot.
- SnapshotId snapshotId
- # The maximum number of times to replay the snapshot (1, if not specified).
- optional integer minRepeatCount
- # The minimum duration (in seconds) to replay the snapshot.
- optional number minDuration
- # The clip rectangle to apply when replaying the snapshot.
- optional DOM.Rect clipRect
- returns
- # The array of paint profiles, one per run.
- array of PaintProfile timings
-
- # Releases layer snapshot captured by the back-end.
- command releaseSnapshot
- parameters
- # The id of the layer snapshot.
- SnapshotId snapshotId
-
- # Replays the layer snapshot and returns the resulting bitmap.
- command replaySnapshot
- parameters
- # The id of the layer snapshot.
- SnapshotId snapshotId
- # The first step to replay from (replay from the very start if not specified).
- optional integer fromStep
- # The last step to replay to (replay till the end if not specified).
- optional integer toStep
- # The scale to apply while replaying (defaults to 1).
- optional number scale
- returns
- # A data: URL for resulting image.
- string dataURL
-
- # Replays the layer snapshot and returns canvas log.
- command snapshotCommandLog
- parameters
- # The id of the layer snapshot.
- SnapshotId snapshotId
- returns
- # The array of canvas function calls.
- array of object commandLog
-
- event layerPainted
- parameters
- # The id of the painted layer.
- LayerId layerId
- # Clip rectangle.
- DOM.Rect clip
-
- event layerTreeDidChange
- parameters
- # Layer tree, absent if not in the compositing mode.
- optional array of Layer layers
-
-# Provides access to log entries.
-domain Log
- depends on Runtime
- depends on Network
-
- # Log entry.
- type LogEntry extends object
- properties
- # Log entry source.
- enum source
- xml
- javascript
- network
- storage
- appcache
- rendering
- security
- deprecation
- worker
- violation
- intervention
- recommendation
- other
- # Log entry severity.
- enum level
- verbose
- info
- warning
- error
- # Logged text.
- string text
- optional enum category
- cors
- # Timestamp when this entry was added.
- Runtime.Timestamp timestamp
- # URL of the resource if known.
- optional string url
- # Line number in the resource.
- optional integer lineNumber
- # JavaScript stack trace.
- optional Runtime.StackTrace stackTrace
- # Identifier of the network request associated with this entry.
- optional Network.RequestId networkRequestId
- # Identifier of the worker associated with this entry.
- optional string workerId
- # Call arguments.
- optional array of Runtime.RemoteObject args
-
- # Violation configuration setting.
- type ViolationSetting extends object
- properties
- # Violation type.
- enum name
- longTask
- longLayout
- blockedEvent
- blockedParser
- discouragedAPIUse
- handler
- recurringHandler
- # Time threshold to trigger upon.
- number threshold
-
- # Clears the log.
- command clear
-
- # Disables log domain, prevents further log entries from being reported to the client.
- command disable
-
- # Enables log domain, sends the entries collected so far to the client by means of the
- # `entryAdded` notification.
- command enable
-
- # start violation reporting.
- command startViolationsReport
- parameters
- # Configuration for violations.
- array of ViolationSetting config
-
- # Stop violation reporting.
- command stopViolationsReport
-
- # Issued when new message was logged.
- event entryAdded
- parameters
- # The entry.
- LogEntry entry
-
-experimental domain Memory
-
- # Memory pressure level.
- type PressureLevel extends string
- enum
- moderate
- critical
-
- # Retruns current DOM object counters.
- command getDOMCounters
- returns
- integer documents
- integer nodes
- integer jsEventListeners
-
- # Retruns DOM object counters after preparing renderer for leak detection.
- command getDOMCountersForLeakDetection
- returns
- # DOM object counters.
- array of DOMCounter counters
-
- # Prepares for leak detection by terminating workers, stopping spellcheckers,
- # dropping non-essential internal caches, running garbage collections, etc.
- command prepareForLeakDetection
-
- # Simulate OomIntervention by purging V8 memory.
- command forciblyPurgeJavaScriptMemory
-
- # Enable/disable suppressing memory pressure notifications in all processes.
- command setPressureNotificationsSuppressed
- parameters
- # If true, memory pressure notifications will be suppressed.
- boolean suppressed
-
- # Simulate a memory pressure notification in all processes.
- command simulatePressureNotification
- parameters
- # Memory pressure level of the notification.
- PressureLevel level
-
- # Start collecting native memory profile.
- command startSampling
- parameters
- # Average number of bytes between samples.
- optional integer samplingInterval
- # Do not randomize intervals between samples.
- optional boolean suppressRandomness
-
- # Stop collecting native memory profile.
- command stopSampling
-
- # Retrieve native memory allocations profile
- # collected since renderer process startup.
- command getAllTimeSamplingProfile
- returns
- SamplingProfile profile
-
- # Retrieve native memory allocations profile
- # collected since browser process startup.
- command getBrowserSamplingProfile
- returns
- SamplingProfile profile
-
- # Retrieve native memory allocations profile collected since last
- # `startSampling` call.
- command getSamplingProfile
- returns
- SamplingProfile profile
-
- # Heap profile sample.
- type SamplingProfileNode extends object
- properties
- # Size of the sampled allocation.
- number size
- # Total bytes attributed to this sample.
- number total
- # Execution stack at the point of allocation.
- array of string stack
-
- # Array of heap profile samples.
- type SamplingProfile extends object
- properties
- array of SamplingProfileNode samples
- array of Module modules
-
- # Executable module information
- type Module extends object
- properties
- # Name of the module.
- string name
- # UUID of the module.
- string uuid
- # Base address where the module is loaded into memory. Encoded as a decimal
- # or hexadecimal (0x prefixed) string.
- string baseAddress
- # Size of the module in bytes.
- number size
-
- # DOM object counter data.
- type DOMCounter extends object
- properties
- # Object name. Note: object names should be presumed volatile and clients should not expect
- # the returned names to be consistent across runs.
- string name
- # Object count.
- integer count
-
-# 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.
-domain Network
- depends on Debugger
- depends on Runtime
- depends on Security
-
- # Resource type as it was perceived by the rendering engine.
- type ResourceType extends string
- enum
- Document
- Stylesheet
- Image
- Media
- Font
- Script
- TextTrack
- XHR
- Fetch
- Prefetch
- EventSource
- WebSocket
- Manifest
- SignedExchange
- Ping
- CSPViolationReport
- Preflight
- FedCM
- Other
-
- # Unique loader identifier.
- type LoaderId extends string
-
- # Unique network request identifier.
- # Note that this does not identify individual HTTP requests that are part of
- # a network request.
- type RequestId extends string
-
- # Unique intercepted request identifier.
- type InterceptionId extends string
-
- # Network level fetch failure reason.
- type ErrorReason extends string
- enum
- Failed
- Aborted
- TimedOut
- AccessDenied
- ConnectionClosed
- ConnectionReset
- ConnectionRefused
- ConnectionAborted
- ConnectionFailed
- NameNotResolved
- InternetDisconnected
- AddressUnreachable
- BlockedByClient
- BlockedByResponse
-
- # UTC time in seconds, counted from January 1, 1970.
- type TimeSinceEpoch extends number
-
- # Monotonically increasing time in seconds since an arbitrary point in the past.
- type MonotonicTime extends number
-
- # Request / response headers as keys / values of JSON object.
- type Headers extends object
-
- # The underlying connection technology that the browser is supposedly using.
- type ConnectionType extends string
- enum
- none
- cellular2g
- cellular3g
- cellular4g
- bluetooth
- ethernet
- wifi
- wimax
- other
-
- # Represents the cookie's 'SameSite' status:
- # https://tools.ietf.org/html/draft-west-first-party-cookies
- type CookieSameSite extends string
- enum
- Strict
- Lax
- None
-
- # Represents the cookie's 'Priority' status:
- # https://tools.ietf.org/html/draft-west-cookie-priority-00
- experimental type CookiePriority extends string
- enum
- Low
- Medium
- High
-
- # Represents the source scheme of the origin that originally set the cookie.
- # A value of "Unset" allows protocol clients to emulate legacy cookie scope for the scheme.
- # This is a temporary ability and it will be removed in the future.
- experimental type CookieSourceScheme extends string
- enum
- Unset
- NonSecure
- Secure
-
- # Timing information for the request.
- type ResourceTiming extends object
- properties
- # Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
- # milliseconds relatively to this requestTime.
- number requestTime
- # Started resolving proxy.
- number proxyStart
- # Finished resolving proxy.
- number proxyEnd
- # Started DNS address resolve.
- number dnsStart
- # Finished DNS address resolve.
- number dnsEnd
- # Started connecting to the remote host.
- number connectStart
- # Connected to the remote host.
- number connectEnd
- # Started SSL handshake.
- number sslStart
- # Finished SSL handshake.
- number sslEnd
- # Started running ServiceWorker.
- experimental number workerStart
- # Finished Starting ServiceWorker.
- experimental number workerReady
- # Started fetch event.
- experimental number workerFetchStart
- # Settled fetch event respondWith promise.
- experimental number workerRespondWithSettled
- # Started ServiceWorker static routing source evaluation.
- experimental optional number workerRouterEvaluationStart
- # Started cache lookup when the source was evaluated to `cache`.
- experimental optional number workerCacheLookupStart
- # Started sending request.
- number sendStart
- # Finished sending request.
- number sendEnd
- # Time the server started pushing request.
- experimental number pushStart
- # Time the server finished pushing request.
- experimental number pushEnd
- # Started receiving response headers.
- experimental number receiveHeadersStart
- # Finished receiving response headers.
- number receiveHeadersEnd
-
- # Loading priority of a resource request.
- type ResourcePriority extends string
- enum
- VeryLow
- Low
- Medium
- High
- VeryHigh
-
- # Post data entry for HTTP request
- type PostDataEntry extends object
- properties
- optional binary bytes
-
- # HTTP request data.
- type Request extends object
- properties
- # Request URL (without fragment).
- string url
- # Fragment of the requested URL starting with hash, if present.
- optional string urlFragment
- # HTTP request method.
- string method
- # HTTP request headers.
- Headers headers
- # HTTP POST request data.
- # Use postDataEntries instead.
- deprecated optional string postData
- # True when the request has POST data. Note that postData might still be omitted when this flag is true when the data is too long.
- optional boolean hasPostData
- # Request body elements (post data broken into individual entries).
- experimental optional array of PostDataEntry postDataEntries
- # The mixed content type of the request.
- optional Security.MixedContentType mixedContentType
- # Priority of the resource request at the time request is sent.
- ResourcePriority initialPriority
- # The referrer policy of the request, as defined in https://www.w3.org/TR/referrer-policy/
- enum referrerPolicy
- unsafe-url
- no-referrer-when-downgrade
- no-referrer
- origin
- origin-when-cross-origin
- same-origin
- strict-origin
- strict-origin-when-cross-origin
- # Whether is loaded via link preload.
- optional boolean isLinkPreload
- # Set for requests when the TrustToken API is used. Contains the parameters
- # passed by the developer (e.g. via "fetch") as understood by the backend.
- experimental optional TrustTokenParams trustTokenParams
- # True if this resource request is considered to be the 'same site' as the
- # request corresponding to the main frame.
- experimental optional boolean isSameSite
-
- # Details of a signed certificate timestamp (SCT).
- type SignedCertificateTimestamp extends object
- properties
- # Validation status.
- string status
- # Origin.
- string origin
- # Log name / description.
- string logDescription
- # Log ID.
- string logId
- # Issuance date. Unlike TimeSinceEpoch, this contains the number of
- # milliseconds since January 1, 1970, UTC, not the number of seconds.
- number timestamp
- # Hash algorithm.
- string hashAlgorithm
- # Signature algorithm.
- string signatureAlgorithm
- # Signature data.
- string signatureData
-
- # Security details about a request.
- type SecurityDetails extends object
- properties
- # Protocol name (e.g. "TLS 1.2" or "QUIC").
- string protocol
- # Key Exchange used by the connection, or the empty string if not applicable.
- string keyExchange
- # (EC)DH group used by the connection, if applicable.
- optional string keyExchangeGroup
- # Cipher name.
- string cipher
- # TLS MAC. Note that AEAD ciphers do not have separate MACs.
- optional string mac
- # Certificate ID value.
- Security.CertificateId certificateId
- # Certificate subject name.
- string subjectName
- # Subject Alternative Name (SAN) DNS names and IP addresses.
- array of string sanList
- # Name of the issuing CA.
- string issuer
- # Certificate valid from date.
- TimeSinceEpoch validFrom
- # Certificate valid to (expiration) date
- TimeSinceEpoch validTo
- # List of signed certificate timestamps (SCTs).
- array of SignedCertificateTimestamp signedCertificateTimestampList
- # Whether the request complied with Certificate Transparency policy
- CertificateTransparencyCompliance certificateTransparencyCompliance
- # The signature algorithm used by the server in the TLS server signature,
- # represented as a TLS SignatureScheme code point. Omitted if not
- # applicable or not known.
- optional integer serverSignatureAlgorithm
- # Whether the connection used Encrypted ClientHello
- boolean encryptedClientHello
-
- # Whether the request complied with Certificate Transparency policy.
- type CertificateTransparencyCompliance extends string
- enum
- unknown
- not-compliant
- compliant
-
- # The reason why request was blocked.
- type BlockedReason extends string
- enum
- other
- csp
- mixed-content
- origin
- inspector
- integrity
- subresource-filter
- content-type
- coep-frame-resource-needs-coep-header
- coop-sandboxed-iframe-cannot-navigate-to-coop-page
- corp-not-same-origin
- corp-not-same-origin-after-defaulted-to-same-origin-by-coep
- corp-not-same-origin-after-defaulted-to-same-origin-by-dip
- corp-not-same-origin-after-defaulted-to-same-origin-by-coep-and-dip
- corp-not-same-site
- sri-message-signature-mismatch
-
- # The reason why request was blocked.
- type CorsError extends string
- enum
- DisallowedByMode
- InvalidResponse
- WildcardOriginNotAllowed
- MissingAllowOriginHeader
- MultipleAllowOriginValues
- InvalidAllowOriginValue
- AllowOriginMismatch
- InvalidAllowCredentials
- CorsDisabledScheme
- PreflightInvalidStatus
- PreflightDisallowedRedirect
- PreflightWildcardOriginNotAllowed
- PreflightMissingAllowOriginHeader
- PreflightMultipleAllowOriginValues
- PreflightInvalidAllowOriginValue
- PreflightAllowOriginMismatch
- PreflightInvalidAllowCredentials
- # TODO(https://crbug.com/1263483): Remove this once frontend code does
- # not reference it anymore.
- PreflightMissingAllowExternal
- # TODO(https://crbug.com/1263483): Remove this once frontend code does
- # not reference it anymore.
- PreflightInvalidAllowExternal
- PreflightMissingAllowPrivateNetwork
- PreflightInvalidAllowPrivateNetwork
- InvalidAllowMethodsPreflightResponse
- InvalidAllowHeadersPreflightResponse
- MethodDisallowedByPreflightResponse
- HeaderDisallowedByPreflightResponse
- RedirectContainsCredentials
- # Request was a private network request initiated by a non-secure context.
- InsecurePrivateNetwork
- # Request carried a target IP address space property that did not match
- # the target resource's address space.
- InvalidPrivateNetworkAccess
- # Request was a private network request yet did not carry a target IP
- # address space.
- UnexpectedPrivateNetworkAccess
- NoCorsRedirectModeNotFollow
- # Request was a private network request and needed user permission yet did
- # not carry `Private-Network-Access-Id` in the preflight response.
- # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
- PreflightMissingPrivateNetworkAccessId
- # Request was a private network request and needed user permission yet did
- # not carry `Private-Network-Access-Name` in the preflight response.
- # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
- PreflightMissingPrivateNetworkAccessName
- # Request was a private network request and needed user permission yet not
- # able to request for permission.
- # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
- PrivateNetworkAccessPermissionUnavailable
- # Request was a private network request and is denied by user permission.
- # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
- PrivateNetworkAccessPermissionDenied
- # Request was a local network request and is denied by user permission.
- # https://wicg.github.io/local-network-access/
- LocalNetworkAccessPermissionDenied
-
- type CorsErrorStatus extends object
- properties
- CorsError corsError
- string failedParameter
-
- # Source of serviceworker response.
- type ServiceWorkerResponseSource extends string
- enum
- cache-storage
- http-cache
- fallback-code
- network
-
- # 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.
- experimental type TrustTokenParams extends object
- properties
- TrustTokenOperationType operation
-
- # Only set for "token-redemption" operation and determine whether
- # to request a fresh SRR or use a still valid cached SRR.
- enum refreshPolicy
- UseCached
- Refresh
-
- # Origins of issuers from whom to request tokens or redemption
- # records.
- optional array of string issuers
-
- experimental type TrustTokenOperationType extends string
- enum
- # Type "token-request" in the Trust Token API.
- Issuance
- # Type "token-redemption" in the Trust Token API.
- Redemption
- # Type "send-redemption-record" in the Trust Token API.
- Signing
-
- # The reason why Chrome uses a specific transport protocol for HTTP semantics.
- experimental type AlternateProtocolUsage extends string
- enum
- # Alternate Protocol was used without racing a normal connection.
- alternativeJobWonWithoutRace
- # Alternate Protocol was used by winning a race with a normal connection.
- alternativeJobWonRace
- # Alternate Protocol was not used by losing a race with a normal connection.
- mainJobWonRace
- # Alternate Protocol was not used because no Alternate-Protocol information
- # was available when the request was issued, but an Alternate-Protocol header
- # was present in the response.
- mappingMissing
- # Alternate Protocol was not used because it was marked broken.
- broken
- # HTTPS DNS protocol upgrade job was used without racing with a normal
- # connection and an Alternate Protocol job.
- dnsAlpnH3JobWonWithoutRace
- # HTTPS DNS protocol upgrade job won a race with a normal connection and
- # an Alternate Protocol job.
- dnsAlpnH3JobWonRace
- # This value is used when the reason is unknown.
- unspecifiedReason
-
- # Source of service worker router.
- type ServiceWorkerRouterSource extends string
- enum
- network
- cache
- fetch-event
- race-network-and-fetch-handler
- race-network-and-cache
-
- experimental type ServiceWorkerRouterInfo extends object
- properties
- # ID of the rule matched. If there is a matched rule, this field will
- # be set, otherwiser no value will be set.
- optional integer ruleIdMatched
- # The router source of the matched rule. If there is a matched rule, this
- # field will be set, otherwise no value will be set.
- optional ServiceWorkerRouterSource matchedSourceType
- # The actual router source used.
- optional ServiceWorkerRouterSource actualSourceType
-
- # HTTP response data.
- type Response extends object
- properties
- # Response URL. This URL can be different from CachedResource.url in case of redirect.
- string url
- # HTTP response status code.
- integer status
- # HTTP response status text.
- string statusText
- # HTTP response headers.
- Headers headers
- # HTTP response headers text. This has been replaced by the headers in Network.responseReceivedExtraInfo.
- deprecated optional string headersText
- # Resource mimeType as determined by the browser.
- string mimeType
- # Resource charset as determined by the browser (if applicable).
- string charset
- # Refined HTTP request headers that were actually transmitted over the network.
- optional Headers requestHeaders
- # HTTP request headers text. This has been replaced by the headers in Network.requestWillBeSentExtraInfo.
- deprecated optional string requestHeadersText
- # Specifies whether physical connection was actually reused for this request.
- boolean connectionReused
- # Physical connection id that was actually used for this request.
- number connectionId
- # Remote IP address.
- optional string remoteIPAddress
- # Remote port.
- optional integer remotePort
- # Specifies that the request was served from the disk cache.
- optional boolean fromDiskCache
- # Specifies that the request was served from the ServiceWorker.
- optional boolean fromServiceWorker
- # Specifies that the request was served from the prefetch cache.
- optional boolean fromPrefetchCache
- # Specifies that the request was served from the prefetch cache.
- optional boolean fromEarlyHints
- # Information about how ServiceWorker Static Router API was used. If this
- # field is set with `matchedSourceType` field, a matching rule is found.
- # If this field is set without `matchedSource`, no matching rule is found.
- # Otherwise, the API is not used.
- experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
- # Total number of bytes received for this request so far.
- number encodedDataLength
- # Timing information for the given request.
- optional ResourceTiming timing
- # Response source of response from ServiceWorker.
- optional ServiceWorkerResponseSource serviceWorkerResponseSource
- # The time at which the returned response was generated.
- optional TimeSinceEpoch responseTime
- # Cache Storage Cache Name.
- optional string cacheStorageCacheName
- # Protocol used to fetch this request.
- optional string protocol
- # The reason why Chrome uses a specific transport protocol for HTTP semantics.
- experimental optional AlternateProtocolUsage alternateProtocolUsage
- # Security state of the request resource.
- Security.SecurityState securityState
- # Security details for the request.
- optional SecurityDetails securityDetails
- # Indicates whether the request was sent through IP Protection proxies. If
- # set to true, the request used the IP Protection privacy feature.
- experimental optional boolean isIpProtectionUsed
-
- # WebSocket request data.
- type WebSocketRequest extends object
- properties
- # HTTP request headers.
- Headers headers
-
- # WebSocket response data.
- type WebSocketResponse extends object
- properties
- # HTTP response status code.
- integer status
- # HTTP response status text.
- string statusText
- # HTTP response headers.
- Headers headers
- # HTTP response headers text.
- optional string headersText
- # HTTP request headers.
- optional Headers requestHeaders
- # HTTP request headers text.
- optional string requestHeadersText
-
- # WebSocket message data. This represents an entire WebSocket message, not just a fragmented frame as the name suggests.
- type WebSocketFrame extends object
- properties
- # WebSocket message opcode.
- number opcode
- # WebSocket message mask.
- boolean mask
- # WebSocket message payload data.
- # If the opcode is 1, this is a text message and payloadData is a UTF-8 string.
- # If the opcode isn't 1, then payloadData is a base64 encoded string representing binary data.
- string payloadData
-
- # Information about the cached resource.
- type CachedResource extends object
- properties
- # Resource URL. This is the url of the original network request.
- string url
- # Type of this resource.
- ResourceType type
- # Cached response data.
- optional Response response
- # Cached response body size.
- number bodySize
-
- # Information about the request initiator.
- type Initiator extends object
- properties
- # Type of this initiator.
- enum type
- parser
- script
- preload
- SignedExchange
- preflight
- other
- # Initiator JavaScript stack trace, set for Script only.
- # Requires the Debugger domain to be enabled.
- optional Runtime.StackTrace stack
- # Initiator URL, set for Parser type or for Script type (when script is importing module) or for SignedExchange type.
- optional string url
- # Initiator line number, set for Parser type or for Script type (when script is importing
- # module) (0-based).
- optional number lineNumber
- # Initiator column number, set for Parser type or for Script type (when script is importing
- # module) (0-based).
- optional number columnNumber
- # Set if another request triggered this request (e.g. preflight).
- optional RequestId requestId
-
- # cookiePartitionKey object
- # The representation of the components of the key that are created by the cookiePartitionKey class contained in net/cookies/cookie_partition_key.h.
- experimental type CookiePartitionKey extends object
- properties
- # The site of the top-level URL the browser was visiting at the start
- # of the request to the endpoint that set the cookie.
- string topLevelSite
- # Indicates if the cookie has any ancestors that are cross-site to the topLevelSite.
- boolean hasCrossSiteAncestor
-
- # Cookie object
- type Cookie extends object
- properties
- # Cookie name.
- string name
- # Cookie value.
- string value
- # Cookie domain.
- string domain
- # Cookie path.
- string path
- # Cookie expiration date as the number of seconds since the UNIX epoch.
- number expires
- # Cookie size.
- integer size
- # True if cookie is http-only.
- boolean httpOnly
- # True if cookie is secure.
- boolean secure
- # True in case of session cookie.
- boolean session
- # Cookie SameSite type.
- optional CookieSameSite sameSite
- # Cookie Priority
- experimental CookiePriority priority
- # True if cookie is SameParty.
- experimental deprecated boolean sameParty
- # Cookie source scheme type.
- experimental CookieSourceScheme sourceScheme
- # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
- # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
- # This is a temporary ability and it will be removed in the future.
- experimental integer sourcePort
- # Cookie partition key.
- experimental optional CookiePartitionKey partitionKey
- # True if cookie partition key is opaque.
- experimental optional boolean partitionKeyOpaque
-
- # Types of reasons why a cookie may not be stored from a response.
- experimental type SetCookieBlockedReason extends string
- enum
- # The cookie had the "Secure" attribute but was not received over a secure connection.
- SecureOnly
- # The cookie had the "SameSite=Strict" attribute but came from a cross-origin response.
- # This includes navigation requests initiated by other origins.
- SameSiteStrict
- # The cookie had the "SameSite=Lax" attribute but came from a cross-origin response.
- SameSiteLax
- # The cookie didn't specify a "SameSite" attribute and was defaulted to "SameSite=Lax" and
- # broke the same rules specified in the SameSiteLax value.
- SameSiteUnspecifiedTreatedAsLax
- # The cookie had the "SameSite=None" attribute but did not specify the "Secure" attribute,
- # which is required in order to use "SameSite=None".
- SameSiteNoneInsecure
- # The cookie was not stored due to user preferences.
- UserPreferences
- # The cookie was blocked due to third-party cookie phaseout.
- ThirdPartyPhaseout
- # The cookie was blocked by third-party cookie blocking between sites in
- # the same First-Party Set.
- ThirdPartyBlockedInFirstPartySet
- # The syntax of the Set-Cookie header of the response was invalid.
- SyntaxError
- # The scheme of the connection is not allowed to store cookies.
- SchemeNotSupported
- # The cookie was not sent over a secure connection and would have overwritten a cookie with
- # the Secure attribute.
- OverwriteSecure
- # The cookie's domain attribute was invalid with regards to the current host url.
- InvalidDomain
- # The cookie used the "__Secure-" or "__Host-" prefix in its name and broke the additional
- # rules applied to cookies with these prefixes as defined in
- # https://tools.ietf.org/html/draft-west-cookie-prefixes-05
- InvalidPrefix
- # An unknown error was encountered when trying to store this cookie.
- UnknownError
- # The cookie had the "SameSite=Strict" attribute but came from a response
- # with the same registrable domain but a different scheme.
- # This includes navigation requests initiated by other origins.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteStrict
- # The cookie had the "SameSite=Lax" attribute but came from a response
- # with the same registrable domain but a different scheme.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteLax
- # The cookie didn't specify a "SameSite" attribute and was defaulted to
- # "SameSite=Lax" and broke the same rules specified in the SchemefulSameSiteLax
- # value.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteUnspecifiedTreatedAsLax
- # The cookie had the "SameParty" attribute but came from a cross-party response.
- SamePartyFromCrossPartyContext
- # The cookie had the "SameParty" attribute but did not specify the "Secure" attribute
- # (which is required in order to use "SameParty"); or specified the "SameSite=Strict"
- # attribute (which is forbidden when using "SameParty").
- SamePartyConflictsWithOtherAttributes
- # The cookie's name/value pair size exceeded the size limit defined in
- # RFC6265bis.
- NameValuePairExceedsMaxSize
- # The cookie contained a forbidden ASCII control character, or the tab
- # character if it appears in the middle of the cookie name, value, an
- # attribute name, or an attribute value.
- DisallowedCharacter
- # Cookie contains no content or only whitespace.
- NoCookieContent
-
- # Types of reasons why a cookie may not be sent with a request.
- experimental type CookieBlockedReason extends string
- enum
- # The cookie had the "Secure" attribute and the connection was not secure.
- SecureOnly
- # The cookie's path was not within the request url's path.
- NotOnPath
- # The cookie's domain is not configured to match the request url's domain, even though they
- # share a common TLD+1 (TLD+1 of foo.bar.example.com is example.com).
- DomainMismatch
- # The cookie had the "SameSite=Strict" attribute and the request was made on on a different
- # site. This includes navigation requests initiated by other sites.
- SameSiteStrict
- # The cookie had the "SameSite=Lax" attribute and the request was made on a different site.
- # This does not include navigation requests initiated by other sites.
- SameSiteLax
- # The cookie didn't specify a SameSite attribute when it was stored and was defaulted to
- # "SameSite=Lax" and broke the same rules specified in the SameSiteLax value. The cookie had
- # to have been set with "SameSite=None" to enable third-party usage.
- SameSiteUnspecifiedTreatedAsLax
- # The cookie had the "SameSite=None" attribute and the connection was not secure. Cookies
- # without SameSite restrictions must be sent over a secure connection.
- SameSiteNoneInsecure
- # The cookie was not sent due to user preferences.
- UserPreferences
- # The cookie was blocked due to third-party cookie phaseout.
- ThirdPartyPhaseout
- # The cookie was blocked by third-party cookie blocking between sites in
- # the same First-Party Set.
- ThirdPartyBlockedInFirstPartySet
- # An unknown error was encountered when trying to send this cookie.
- UnknownError
- # The cookie had the "SameSite=Strict" attribute but came from a response
- # with the same registrable domain but a different scheme.
- # This includes navigation requests initiated by other origins.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteStrict
- # The cookie had the "SameSite=Lax" attribute but came from a response
- # with the same registrable domain but a different scheme.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteLax
- # The cookie didn't specify a "SameSite" attribute and was defaulted to
- # "SameSite=Lax" and broke the same rules specified in the SchemefulSameSiteLax
- # value.
- # This is the "Schemeful Same-Site" version of the blocked reason.
- SchemefulSameSiteUnspecifiedTreatedAsLax
- # The cookie had the "SameParty" attribute and the request was made from a cross-party context.
- SamePartyFromCrossPartyContext
- # The cookie's name/value pair size exceeded the size limit defined in
- # RFC6265bis.
- NameValuePairExceedsMaxSize
- # The cookie's source port value does not match the request origin's port.
- PortMismatch
- # The cookie's source scheme value does not match the request origin's scheme.
- SchemeMismatch
- # Unpartitioned cookie access from an anonymous context was blocked.
- AnonymousContext
-
- # Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
- experimental type CookieExemptionReason extends string
- enum
- # The default value. Cookie with this reason could either be blocked or included.
- None
- # The cookie should have been blocked by 3PCD but is exempted by explicit user setting.
- UserSetting
- # The cookie should have been blocked by 3PCD but is exempted by metadata mitigation.
- TPCDMetadata
- # The cookie should have been blocked by 3PCD but is exempted by Deprecation Trial mitigation.
- TPCDDeprecationTrial
- # The cookie should have been blocked by 3PCD but is exempted by Top-level Deprecation Trial mitigation.
- TopLevelTPCDDeprecationTrial
- # The cookie should have been blocked by 3PCD but is exempted by heuristics mitigation.
- TPCDHeuristics
- # The cookie should have been blocked by 3PCD but is exempted by Enterprise Policy.
- EnterprisePolicy
- # The cookie should have been blocked by 3PCD but is exempted by Storage Access API.
- StorageAccess
- # The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
- TopLevelStorageAccess
- # The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
- Scheme
- # The cookie was included due to the 'allow-same-site-none-cookies' value being set in the sandboxing policy.
- SameSiteNoneCookiesInSandbox
-
- # A cookie which was not stored from a response with the corresponding reason.
- experimental type BlockedSetCookieWithReason extends object
- properties
- # The reason(s) this cookie was blocked.
- array of SetCookieBlockedReason blockedReasons
- # The string representing this individual cookie as it would appear in the header.
- # This is not the entire "cookie" or "set-cookie" header which could have multiple cookies.
- string cookieLine
- # The cookie object which represents the cookie which was not stored. It is optional because
- # sometimes complete cookie information is not available, such as in the case of parsing
- # errors.
- optional Cookie cookie
-
- # A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
- # corresponding reason. A cookie could only have at most one exemption reason.
- experimental type ExemptedSetCookieWithReason extends object
- properties
- # The reason the cookie was exempted.
- CookieExemptionReason exemptionReason
- # The string representing this individual cookie as it would appear in the header.
- string cookieLine
- # The cookie object representing the cookie.
- Cookie cookie
-
- # A cookie associated with the request which may or may not be sent with it.
- # Includes the cookies itself and reasons for blocking or exemption.
- experimental type AssociatedCookie extends object
- properties
- # The cookie object representing the cookie which was not sent.
- Cookie cookie
- # The reason(s) the cookie was blocked. If empty means the cookie is included.
- array of CookieBlockedReason blockedReasons
- # The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
- # only have at most one exemption reason.
- optional CookieExemptionReason exemptionReason
-
- # Cookie parameter object
- type CookieParam extends object
- properties
- # Cookie name.
- string name
- # Cookie value.
- string value
- # The request-URI to associate with the setting of the cookie. This value can affect the
- # default domain, path, source port, and source scheme values of the created cookie.
- optional string url
- # Cookie domain.
- optional string domain
- # Cookie path.
- optional string path
- # True if cookie is secure.
- optional boolean secure
- # True if cookie is http-only.
- optional boolean httpOnly
- # Cookie SameSite type.
- optional CookieSameSite sameSite
- # Cookie expiration date, session cookie if not set
- optional TimeSinceEpoch expires
- # Cookie Priority.
- experimental optional CookiePriority priority
- # True if cookie is SameParty.
- experimental optional boolean sameParty
- # Cookie source scheme type.
- experimental optional CookieSourceScheme sourceScheme
- # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
- # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
- # This is a temporary ability and it will be removed in the future.
- experimental optional integer sourcePort
- # Cookie partition key. If not set, the cookie will be set as not partitioned.
- experimental optional CookiePartitionKey partitionKey
-
- # Authorization challenge for HTTP status code 401 or 407.
- experimental type AuthChallenge extends object
- properties
- # Source of the authentication challenge.
- optional enum source
- Server
- Proxy
- # Origin of the challenger.
- string origin
- # The authentication scheme used, such as basic or digest
- string scheme
- # The realm of the challenge. May be empty.
- string realm
-
- # Response to an AuthChallenge.
- experimental type AuthChallengeResponse extends object
- properties
- # The decision on what to do in response to the authorization challenge. Default means
- # deferring to the default behavior of the net stack, which will likely either the Cancel
- # authentication or display a popup dialog box.
- enum response
- Default
- CancelAuth
- ProvideCredentials
- # The username to provide, possibly empty. Should only be set if response is
- # ProvideCredentials.
- optional string username
- # The password to provide, possibly empty. Should only be set if response is
- # ProvideCredentials.
- optional string password
-
- # Stages of the interception to begin intercepting. Request will intercept before the request is
- # sent. Response will intercept after the response is received.
- experimental type InterceptionStage extends string
- enum
- Request
- HeadersReceived
-
- # Request pattern for interception.
- experimental type RequestPattern extends object
- properties
- # Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
- # backslash. Omitting is equivalent to `"*"`.
- optional string urlPattern
- # If set, only requests for matching resource types will be intercepted.
- optional ResourceType resourceType
- # Stage at which to begin intercepting requests. Default is Request.
- optional InterceptionStage interceptionStage
-
- # Information about a signed exchange signature.
- # https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#rfc.section.3.1
- experimental type SignedExchangeSignature extends object
- properties
- # Signed exchange signature label.
- string label
- # The hex string of signed exchange signature.
- string signature
- # Signed exchange signature integrity.
- string integrity
- # Signed exchange signature cert Url.
- optional string certUrl
- # The hex string of signed exchange signature cert sha256.
- optional string certSha256
- # Signed exchange signature validity Url.
- string validityUrl
- # Signed exchange signature date.
- integer date
- # Signed exchange signature expires.
- integer expires
- # The encoded certificates.
- optional array of string certificates
-
- # Information about a signed exchange header.
- # https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#cbor-representation
- experimental type SignedExchangeHeader extends object
- properties
- # Signed exchange request URL.
- string requestUrl
- # Signed exchange response code.
- integer responseCode
- # Signed exchange response headers.
- Headers responseHeaders
- # Signed exchange response signature.
- array of SignedExchangeSignature signatures
- # Signed exchange header integrity hash in the form of `sha256-<base64-hash-value>`.
- string headerIntegrity
-
- # Field type for a signed exchange related error.
- experimental type SignedExchangeErrorField extends string
- enum
- signatureSig
- signatureIntegrity
- signatureCertUrl
- signatureCertSha256
- signatureValidityUrl
- signatureTimestamps
-
- # Information about a signed exchange response.
- experimental type SignedExchangeError extends object
- properties
- # Error message.
- string message
- # The index of the signature which caused the error.
- optional integer signatureIndex
- # The field which caused the error.
- optional SignedExchangeErrorField errorField
-
- # Information about a signed exchange response.
- experimental type SignedExchangeInfo extends object
- properties
- # The outer response of signed HTTP exchange which was received from network.
- Response outerResponse
- # Whether network response for the signed exchange was accompanied by
- # extra headers.
- boolean hasExtraInfo
- # Information about the signed exchange header.
- optional SignedExchangeHeader header
- # Security details for the signed exchange header.
- optional SecurityDetails securityDetails
- # Errors occurred while handling the signed exchange.
- optional array of SignedExchangeError errors
-
- # List of content encodings supported by the backend.
- experimental type ContentEncoding extends string
- enum
- deflate
- gzip
- br
- zstd
-
- # Sets a list of content encodings that will be accepted. Empty list means no encoding is accepted.
- experimental command setAcceptedEncodings
- parameters
- # List of accepted content encodings.
- array of ContentEncoding encodings
-
- # Clears accepted encodings set by setAcceptedEncodings
- experimental command clearAcceptedEncodingsOverride
-
- # Tells whether clearing browser cache is supported.
- deprecated command canClearBrowserCache
- returns
- # True if browser cache can be cleared.
- boolean result
-
- # Tells whether clearing browser cookies is supported.
- deprecated command canClearBrowserCookies
- returns
- # True if browser cookies can be cleared.
- boolean result
-
- # Tells whether emulation of network conditions is supported.
- deprecated command canEmulateNetworkConditions
- returns
- # True if emulation of network conditions is supported.
- boolean result
-
- # Clears browser cache.
- command clearBrowserCache
-
- # Clears browser cookies.
- command clearBrowserCookies
-
- # Response to Network.requestIntercepted which either modifies the request to continue with any
- # modifications, or blocks it, or completes it with the provided response bytes. If a network
- # fetch occurs as a result which encounters a redirect an additional Network.requestIntercepted
- # event will be sent with the same InterceptionId.
- # Deprecated, use Fetch.continueRequest, Fetch.fulfillRequest and Fetch.failRequest instead.
- experimental deprecated command continueInterceptedRequest
- parameters
- InterceptionId interceptionId
- # If set this causes the request to fail with the given reason. Passing `Aborted` for requests
- # marked with `isNavigationRequest` also cancels the navigation. Must not be set in response
- # to an authChallenge.
- optional ErrorReason errorReason
- # If set the requests completes using with the provided base64 encoded raw response, including
- # HTTP status line and headers etc... Must not be set in response to an authChallenge.
- optional binary rawResponse
- # If set the request url will be modified in a way that's not observable by page. Must not be
- # set in response to an authChallenge.
- optional string url
- # If set this allows the request method to be overridden. Must not be set in response to an
- # authChallenge.
- optional string method
- # If set this allows postData to be set. Must not be set in response to an authChallenge.
- optional string postData
- # If set this allows the request headers to be changed. Must not be set in response to an
- # authChallenge.
- optional Headers headers
- # Response to a requestIntercepted with an authChallenge. Must not be set otherwise.
- optional AuthChallengeResponse authChallengeResponse
-
- # Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
- command deleteCookies
- parameters
- # Name of the cookies to remove.
- string name
- # If specified, deletes all the cookies with the given name where domain and path match
- # provided URL.
- optional string url
- # If specified, deletes only cookies with the exact domain.
- optional string domain
- # If specified, deletes only cookies with the exact path.
- optional string path
- # If specified, deletes only cookies with the the given name and partitionKey where
- # all partition key attributes match the cookie partition key attribute.
- experimental optional CookiePartitionKey partitionKey
-
- # Disables network tracking, prevents network events from being sent to the client.
- command disable
-
- # Activates emulation of network conditions.
- command emulateNetworkConditions
- parameters
- # True to emulate internet disconnection.
- boolean offline
- # Minimum latency from request sent to response headers received (ms).
- number latency
- # Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
- number downloadThroughput
- # Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.
- number uploadThroughput
- # Connection type if known.
- optional ConnectionType connectionType
- # WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
- experimental optional number packetLoss
- # WebRTC packet queue length (packet). 0 removes any queue length limitations.
- experimental optional integer packetQueueLength
- # WebRTC packetReordering feature.
- experimental optional boolean packetReordering
-
- # Enables network tracking, network events will now be delivered to the client.
- command enable
- parameters
- # Buffer size in bytes to use when preserving network payloads (XHRs, etc).
- experimental optional integer maxTotalBufferSize
- # Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
- experimental optional integer maxResourceBufferSize
- # Longest post body size (in bytes) that would be included in requestWillBeSent notification
- optional integer maxPostDataSize
- # Whether DirectSocket chunk send/receive events should be reported.
- experimental optional boolean reportDirectSocketTraffic
-
- # Returns all browser cookies. Depending on the backend support, will return detailed cookie
- # information in the `cookies` field.
- # Deprecated. Use Storage.getCookies instead.
- deprecated command getAllCookies
- returns
- # Array of cookie objects.
- array of Cookie cookies
-
- # Returns the DER-encoded certificate.
- experimental command getCertificate
- parameters
- # Origin to get certificate for.
- string origin
- returns
- array of string tableNames
-
- # Returns all browser cookies for the current URL. Depending on the backend support, will return
- # detailed cookie information in the `cookies` field.
- command getCookies
- parameters
- # The list of URLs for which applicable cookies will be fetched.
- # If not specified, it's assumed to be set to the list containing
- # the URLs of the page and all of its subframes.
- optional array of string urls
- returns
- # Array of cookie objects.
- array of Cookie cookies
-
- # Returns content served for the given request.
- command getResponseBody
- parameters
- # Identifier of the network request to get content for.
- RequestId requestId
- returns
- # Response body.
- string body
- # True, if content was sent as base64.
- boolean base64Encoded
-
- # Returns post data sent with the request. Returns an error when no data was sent with the request.
- command getRequestPostData
- parameters
- # Identifier of the network request to get content for.
- RequestId requestId
- returns
- # Request body string, omitting files from multipart requests
- string postData
-
- # Returns content served for the given currently intercepted request.
- experimental command getResponseBodyForInterception
- parameters
- # Identifier for the intercepted request to get body for.
- InterceptionId interceptionId
- returns
- # Response body.
- string body
- # True, if content was sent as base64.
- boolean base64Encoded
-
- # Returns a handle to the stream representing the response body. Note that after this command,
- # the intercepted request can't be continued as is -- you either need to cancel it or to provide
- # the response body. The stream only supports sequential read, IO.read will fail if the position
- # is specified.
- experimental command takeResponseBodyForInterceptionAsStream
- parameters
- InterceptionId interceptionId
- returns
- IO.StreamHandle stream
-
- # This method sends a new XMLHttpRequest which is identical to the original one. The following
- # parameters should be identical: method, url, async, request body, extra headers, withCredentials
- # attribute, user, password.
- experimental command replayXHR
- parameters
- # Identifier of XHR to replay.
- RequestId requestId
-
- # Searches for given string in response content.
- experimental command searchInResponseBody
- parameters
- # Identifier of the network response to search.
- RequestId requestId
- # 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 Debugger.SearchMatch result
-
- # Blocks URLs from loading.
- experimental command setBlockedURLs
- parameters
- # URL patterns to block. Wildcards ('*') are allowed.
- array of string urls
-
- # Toggles ignoring of service worker for each request.
- command setBypassServiceWorker
- parameters
- # Bypass service worker and load from network.
- boolean bypass
-
- # Toggles ignoring cache for each request. If `true`, cache will not be used.
- command setCacheDisabled
- parameters
- # Cache disabled state.
- boolean cacheDisabled
-
- # Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
- command setCookie
- parameters
- # Cookie name.
- string name
- # Cookie value.
- string value
- # The request-URI to associate with the setting of the cookie. This value can affect the
- # default domain, path, source port, and source scheme values of the created cookie.
- optional string url
- # Cookie domain.
- optional string domain
- # Cookie path.
- optional string path
- # True if cookie is secure.
- optional boolean secure
- # True if cookie is http-only.
- optional boolean httpOnly
- # Cookie SameSite type.
- optional CookieSameSite sameSite
- # Cookie expiration date, session cookie if not set
- optional TimeSinceEpoch expires
- # Cookie Priority type.
- experimental optional CookiePriority priority
- # True if cookie is SameParty.
- experimental optional boolean sameParty
- # Cookie source scheme type.
- experimental optional CookieSourceScheme sourceScheme
- # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
- # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
- # This is a temporary ability and it will be removed in the future.
- experimental optional integer sourcePort
- # Cookie partition key. If not set, the cookie will be set as not partitioned.
- experimental optional CookiePartitionKey partitionKey
- returns
- # Always set to true. If an error occurs, the response indicates protocol error.
- deprecated boolean success
-
- # Sets given cookies.
- command setCookies
- parameters
- # Cookies to be set.
- array of CookieParam cookies
-
- # Specifies whether to always send extra HTTP headers with the requests from this page.
- command setExtraHTTPHeaders
- parameters
- # Map with extra HTTP headers.
- Headers headers
-
- # Specifies whether to attach a page script stack id in requests
- experimental command setAttachDebugStack
- parameters
- # Whether to attach a page script stack for debugging purpose.
- boolean enabled
-
- # Sets the requests to intercept that match the provided patterns and optionally resource types.
- # Deprecated, please use Fetch.enable instead.
- experimental deprecated command setRequestInterception
- parameters
- # Requests matching any of these patterns will be forwarded and wait for the corresponding
- # continueInterceptedRequest call.
- array of RequestPattern patterns
-
- # Allows overriding user agent with the given string.
- command setUserAgentOverride
- redirect Emulation
- parameters
- # User agent to use.
- string userAgent
- # Browser language to emulate.
- optional string acceptLanguage
- # The platform navigator.platform should return.
- optional string platform
- # To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
- experimental optional Emulation.UserAgentMetadata userAgentMetadata
-
-
- # Fired when data chunk was received over the network.
- event dataReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # Data chunk length.
- integer dataLength
- # Actual bytes received (might be less than dataLength for compressed encodings).
- integer encodedDataLength
- # Data that was received.
- experimental optional binary data
-
- # Enables streaming of the response for the given requestId.
- # If enabled, the dataReceived event contains the data that was received during streaming.
- experimental command streamResourceContent
- parameters
- # Identifier of the request to stream.
- RequestId requestId
- returns
- # Data that has been buffered until streaming is enabled.
- binary bufferedData
-
- # Fired when EventSource message is received.
- event eventSourceMessageReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # Message type.
- string eventName
- # Message identifier.
- string eventId
- # Message content.
- string data
-
- # Fired when HTTP request has failed to load.
- event loadingFailed
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # Resource type.
- ResourceType type
- # Error message. List of network errors: https://cs.chromium.org/chromium/src/net/base/net_error_list.h
- string errorText
- # True if loading was canceled.
- optional boolean canceled
- # The reason why loading was blocked, if any.
- optional BlockedReason blockedReason
- # The reason why loading was blocked by CORS, if any.
- optional CorsErrorStatus corsErrorStatus
-
- # Fired when HTTP request has finished loading.
- event loadingFinished
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # Total number of bytes received for this request.
- number encodedDataLength
-
- # Details of an intercepted HTTP request, which must be either allowed, blocked, modified or
- # mocked.
- # Deprecated, use Fetch.requestPaused instead.
- experimental deprecated event requestIntercepted
- parameters
- # Each request the page makes will have a unique id, however if any redirects are encountered
- # while processing that fetch, they will be reported with the same id as the original fetch.
- # Likewise if HTTP authentication is needed then the same fetch id will be used.
- InterceptionId interceptionId
- Request request
- # The id of the frame that initiated the request.
- Page.FrameId frameId
- # How the requested resource will be used.
- ResourceType resourceType
- # Whether this is a navigation request, which can abort the navigation completely.
- boolean isNavigationRequest
- # Set if the request is a navigation that will result in a download.
- # Only present after response is received from the server (i.e. HeadersReceived stage).
- optional boolean isDownload
- # Redirect location, only sent if a redirect was intercepted.
- optional string redirectUrl
- # Details of the Authorization Challenge encountered. If this is set then
- # continueInterceptedRequest must contain an authChallengeResponse.
- optional AuthChallenge authChallenge
- # Response error if intercepted at response stage or if redirect occurred while intercepting
- # request.
- optional ErrorReason responseErrorReason
- # Response code if intercepted at response stage or if redirect occurred while intercepting
- # request or auth retry occurred.
- optional integer responseStatusCode
- # Response headers if intercepted at the response stage or if redirect occurred while
- # intercepting request or auth retry occurred.
- optional Headers responseHeaders
- # If the intercepted request had a corresponding requestWillBeSent event fired for it, then
- # this requestId will be the same as the requestId present in the requestWillBeSent event.
- optional RequestId requestId
-
- # Fired if request ended up loading from cache.
- event requestServedFromCache
- parameters
- # Request identifier.
- RequestId requestId
-
- # Fired when page is about to send HTTP request.
- event requestWillBeSent
- parameters
- # Request identifier.
- RequestId requestId
- # Loader identifier. Empty string if the request is fetched from worker.
- LoaderId loaderId
- # URL of the document this request is loaded for.
- string documentURL
- # Request data.
- Request request
- # Timestamp.
- MonotonicTime timestamp
- # Timestamp.
- TimeSinceEpoch wallTime
- # Request initiator.
- Initiator initiator
- # In the case that redirectResponse is populated, this flag indicates whether
- # requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be or were emitted
- # for the request which was just redirected.
- experimental boolean redirectHasExtraInfo
- # Redirect response data.
- optional Response redirectResponse
- # Type of this resource.
- optional ResourceType type
- # Frame identifier.
- optional Page.FrameId frameId
- # Whether the request is initiated by a user gesture. Defaults to false.
- optional boolean hasUserGesture
-
- # Fired when resource loading priority is changed
- experimental event resourceChangedPriority
- parameters
- # Request identifier.
- RequestId requestId
- # New priority
- ResourcePriority newPriority
- # Timestamp.
- MonotonicTime timestamp
-
- # Fired when a signed exchange was received over the network
- experimental event signedExchangeReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Information about the signed exchange response.
- SignedExchangeInfo info
-
- # Fired when HTTP response is available.
- event responseReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Loader identifier. Empty string if the request is fetched from worker.
- LoaderId loaderId
- # Timestamp.
- MonotonicTime timestamp
- # Resource type.
- ResourceType type
- # Response data.
- Response response
- # Indicates whether requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be
- # or were emitted for this request.
- experimental boolean hasExtraInfo
- # Frame identifier.
- optional Page.FrameId frameId
-
- # Fired when WebSocket is closed.
- event webSocketClosed
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
-
- # Fired upon WebSocket creation.
- event webSocketCreated
- parameters
- # Request identifier.
- RequestId requestId
- # WebSocket request URL.
- string url
- # Request initiator.
- optional Initiator initiator
-
- # Fired when WebSocket message error occurs.
- event webSocketFrameError
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # WebSocket error message.
- string errorMessage
-
- # Fired when WebSocket message is received.
- event webSocketFrameReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # WebSocket response data.
- WebSocketFrame response
-
- # Fired when WebSocket message is sent.
- event webSocketFrameSent
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # WebSocket response data.
- WebSocketFrame response
-
- # Fired when WebSocket handshake response becomes available.
- event webSocketHandshakeResponseReceived
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # WebSocket response data.
- WebSocketResponse response
-
- # Fired when WebSocket is about to initiate handshake.
- event webSocketWillSendHandshakeRequest
- parameters
- # Request identifier.
- RequestId requestId
- # Timestamp.
- MonotonicTime timestamp
- # UTC Timestamp.
- TimeSinceEpoch wallTime
- # WebSocket request data.
- WebSocketRequest request
-
- # Fired upon WebTransport creation.
- event webTransportCreated
- parameters
- # WebTransport identifier.
- RequestId transportId
- # WebTransport request URL.
- string url
- # Timestamp.
- MonotonicTime timestamp
- # Request initiator.
- optional Initiator initiator
-
- # Fired when WebTransport handshake is finished.
- event webTransportConnectionEstablished
- parameters
- # WebTransport identifier.
- RequestId transportId
- # Timestamp.
- MonotonicTime timestamp
-
- # Fired when WebTransport is disposed.
- event webTransportClosed
- parameters
- # WebTransport identifier.
- RequestId transportId
- # Timestamp.
- MonotonicTime timestamp
-
- experimental type DirectSocketDnsQueryType extends string
- enum
- ipv4
- ipv6
-
- experimental type DirectTCPSocketOptions extends object
- properties
- # TCP_NODELAY option
- boolean noDelay
- # Expected to be unsigned integer.
- optional number keepAliveDelay
- # Expected to be unsigned integer.
- optional number sendBufferSize
- # Expected to be unsigned integer.
- optional number receiveBufferSize
- optional DirectSocketDnsQueryType dnsQueryType
-
-
- # Fired upon direct_socket.TCPSocket creation.
- experimental event directTCPSocketCreated
- parameters
- RequestId identifier
- string remoteAddr
- # Unsigned int 16.
- integer remotePort
- DirectTCPSocketOptions options
- MonotonicTime timestamp
- optional Initiator initiator
-
- # Fired when direct_socket.TCPSocket connection is opened.
- experimental event directTCPSocketOpened
- parameters
- RequestId identifier
- string remoteAddr
- # Expected to be unsigned integer.
- integer remotePort
- MonotonicTime timestamp
- optional string localAddr
- # Expected to be unsigned integer.
- optional integer localPort
-
- # Fired when direct_socket.TCPSocket is aborted.
- experimental event directTCPSocketAborted
- parameters
- RequestId identifier
- string errorMessage
- MonotonicTime timestamp
-
- # Fired when direct_socket.TCPSocket is closed.
- experimental event directTCPSocketClosed
- parameters
- RequestId identifier
- MonotonicTime timestamp
-
- # Fired when data is sent to tcp direct socket stream.
- experimental event directTCPSocketChunkSent
- parameters
- RequestId identifier
- binary data
- MonotonicTime timestamp
-
- # Fired when data is received from tcp direct socket stream.
- experimental event directTCPSocketChunkReceived
- parameters
- RequestId identifier
- binary data
- MonotonicTime timestamp
-
- experimental type DirectUDPSocketOptions extends object
- properties
- optional string remoteAddr
- # Unsigned int 16.
- optional integer remotePort
-
- optional string localAddr
- # Unsigned int 16.
- optional integer localPort
-
- optional DirectSocketDnsQueryType dnsQueryType
-
- # Expected to be unsigned integer.
- optional number sendBufferSize
- # Expected to be unsigned integer.
- optional number receiveBufferSize
-
-
- # Fired upon direct_socket.UDPSocket creation.
- experimental event directUDPSocketCreated
- parameters
- RequestId identifier
- DirectUDPSocketOptions options
- MonotonicTime timestamp
- optional Initiator initiator
-
- # Fired when direct_socket.UDPSocket connection is opened.
- experimental event directUDPSocketOpened
- parameters
- RequestId identifier
- string localAddr
- # Expected to be unsigned integer.
- integer localPort
- MonotonicTime timestamp
- optional string remoteAddr
- # Expected to be unsigned integer.
- optional integer remotePort
-
- # Fired when direct_socket.UDPSocket is aborted.
- experimental event directUDPSocketAborted
- parameters
- RequestId identifier
- string errorMessage
- MonotonicTime timestamp
-
- # Fired when direct_socket.UDPSocket is closed.
- experimental event directUDPSocketClosed
- parameters
- RequestId identifier
- MonotonicTime timestamp
-
- experimental type DirectUDPMessage extends object
- properties
- binary data
- # Null for connected mode.
- optional string remoteAddr
- # Null for connected mode.
- # Expected to be unsigned integer.
- optional integer remotePort
-
- # Fired when message is sent to udp direct socket stream.
- experimental event directUDPSocketChunkSent
- parameters
- RequestId identifier
- DirectUDPMessage message
- MonotonicTime timestamp
-
- # Fired when message is received from udp direct socket stream.
- experimental event directUDPSocketChunkReceived
- parameters
- RequestId identifier
- DirectUDPMessage message
- MonotonicTime timestamp
-
- experimental type PrivateNetworkRequestPolicy extends string
- enum
- Allow
- BlockFromInsecureToMorePrivate
- WarnFromInsecureToMorePrivate
- PreflightBlock
- PreflightWarn
- PermissionBlock
- PermissionWarn
-
- experimental type IPAddressSpace extends string
- enum
- Loopback
- Local
- Public
- Unknown
-
- experimental type ConnectTiming extends object
- properties
- # Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
- # milliseconds relatively to this requestTime. Matches ResourceTiming's requestTime for
- # the same request (but not for redirected requests).
- number requestTime
-
- experimental type ClientSecurityState extends object
- properties
- boolean initiatorIsSecureContext
- IPAddressSpace initiatorIPAddressSpace
- PrivateNetworkRequestPolicy privateNetworkRequestPolicy
-
- # 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.
- experimental event requestWillBeSentExtraInfo
- parameters
- # Request identifier. Used to match this information to an existing requestWillBeSent event.
- RequestId requestId
- # A list of cookies potentially associated to the requested URL. This includes both cookies sent with
- # the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
- array of AssociatedCookie associatedCookies
- # Raw request headers as they will be sent over the wire.
- Headers headers
- # Connection timing information for the request.
- experimental ConnectTiming connectTiming
- # The client security state set for the request.
- optional ClientSecurityState clientSecurityState
- # Whether the site has partitioned cookies stored in a partition different than the current one.
- optional boolean siteHasCookieInOtherPartition
-
- # 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.
- experimental event responseReceivedExtraInfo
- parameters
- # Request identifier. Used to match this information to another responseReceived event.
- RequestId requestId
- # A list of cookies which were not stored from the response along with the corresponding
- # reasons for blocking. The cookies here may not be valid due to syntax errors, which
- # are represented by the invalid cookie line string instead of a proper cookie.
- array of BlockedSetCookieWithReason blockedCookies
- # Raw response headers as they were received over the wire.
- # Duplicate headers in the response are represented as a single key with their values
- # concatentated using `\n` as the separator.
- # See also `headersText` that contains verbatim text for HTTP/1.*.
- Headers headers
- # The IP address space of the resource. The address space can only be determined once the transport
- # established the connection, so we can't send it in `requestWillBeSentExtraInfo`.
- IPAddressSpace resourceIPAddressSpace
- # The status code of the response. This is useful in cases the request failed and no responseReceived
- # event is triggered, which is the case for, e.g., CORS errors. This is also the correct status code
- # for cached requests, where the status in responseReceived is a 200 and this will be 304.
- integer statusCode
- # Raw response header text as it was received over the wire. The raw text may not always be
- # available, such as in the case of HTTP/2 or QUIC.
- optional string headersText
- # The cookie partition key that will be used to store partitioned cookies set in this response.
- # Only sent when partitioned cookies are enabled.
- experimental optional CookiePartitionKey cookiePartitionKey
- # True if partitioned cookies are enabled, but the partition key is not serializable to string.
- optional boolean cookiePartitionKeyOpaque
- # A list of cookies which should have been blocked by 3PCD but are exempted and stored from
- # the response with the corresponding reason.
- optional array of ExemptedSetCookieWithReason exemptedCookies
-
- # Fired when 103 Early Hints headers is received in addition to the common response.
- # Not every responseReceived event will have an responseReceivedEarlyHints fired.
- # Only one responseReceivedEarlyHints may be fired for eached responseReceived event.
- experimental event responseReceivedEarlyHints
- parameters
- # Request identifier. Used to match this information to another responseReceived event.
- RequestId requestId
- # Raw response headers as they were received over the wire.
- # Duplicate headers in the response are represented as a single key with their values
- # concatentated using `\n` as the separator.
- # See also `headersText` that contains verbatim text for HTTP/1.*.
- Headers headers
-
- # 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.
- experimental event trustTokenOperationDone
- parameters
- # Detailed success or error status of the operation.
- # 'AlreadyExists' also signifies a successful operation, as the result
- # of the operation already exists und thus, the operation was abort
- # preemptively (e.g. a cache hit).
- enum status
- Ok
- InvalidArgument
- MissingIssuerKeys
- FailedPrecondition
- ResourceExhausted
- AlreadyExists
- ResourceLimited
- Unauthorized
- BadResponse
- InternalError
- UnknownError
- FulfilledLocally
- SiteIssuerLimit
- TrustTokenOperationType type
- RequestId requestId
- # Top level origin. The context in which the operation was attempted.
- optional string topLevelOrigin
- # Origin of the issuer in case of a "Issuance" or "Redemption" operation.
- optional string issuerOrigin
- # The number of obtained Trust Tokens on a successful "Issuance" operation.
- optional integer issuedTokenCount
-
- # Fired once security policy has been updated.
- experimental event policyUpdated
-
- # Fired once when parsing the .wbn file has succeeded.
- # The event contains the information about the web bundle contents.
- experimental event subresourceWebBundleMetadataReceived
- parameters
- # Request identifier. Used to match this information to another event.
- RequestId requestId
- # A list of URLs of resources in the subresource Web Bundle.
- array of string urls
-
- # Fired once when parsing the .wbn file has failed.
- experimental event subresourceWebBundleMetadataError
- parameters
- # Request identifier. Used to match this information to another event.
- RequestId requestId
- # Error message
- string errorMessage
-
- # Fired when handling requests for resources within a .wbn file.
- # Note: this will only be fired for resources that are requested by the webpage.
- experimental event subresourceWebBundleInnerResponseParsed
- parameters
- # Request identifier of the subresource request
- RequestId innerRequestId
- # URL of the subresource resource.
- string innerRequestURL
- # Bundle request identifier. Used to match this information to another event.
- # This made be absent in case when the instrumentation was enabled only
- # after webbundle was parsed.
- optional RequestId bundleRequestId
-
- # Fired when request for resources within a .wbn file failed.
- experimental event subresourceWebBundleInnerResponseError
- parameters
- # Request identifier of the subresource request
- RequestId innerRequestId
- # URL of the subresource resource.
- string innerRequestURL
- # Error message
- string errorMessage
- # Bundle request identifier. Used to match this information to another event.
- # This made be absent in case when the instrumentation was enabled only
- # after webbundle was parsed.
- optional RequestId bundleRequestId
-
- experimental type CrossOriginOpenerPolicyValue extends string
- enum
- SameOrigin
- SameOriginAllowPopups
- RestrictProperties
- UnsafeNone
- SameOriginPlusCoep
- RestrictPropertiesPlusCoep
- NoopenerAllowPopups
-
- experimental type CrossOriginOpenerPolicyStatus extends object
- properties
- CrossOriginOpenerPolicyValue value
- CrossOriginOpenerPolicyValue reportOnlyValue
- optional string reportingEndpoint
- optional string reportOnlyReportingEndpoint
-
- experimental type CrossOriginEmbedderPolicyValue extends string
- enum
- None
- Credentialless
- RequireCorp
-
- experimental type CrossOriginEmbedderPolicyStatus extends object
- properties
- CrossOriginEmbedderPolicyValue value
- CrossOriginEmbedderPolicyValue reportOnlyValue
- optional string reportingEndpoint
- optional string reportOnlyReportingEndpoint
-
- experimental type ContentSecurityPolicySource extends string
- enum
- HTTP
- Meta
-
- experimental type ContentSecurityPolicyStatus extends object
- properties
- string effectiveDirectives
- boolean isEnforced
- ContentSecurityPolicySource source
-
- experimental type SecurityIsolationStatus extends object
- properties
- optional CrossOriginOpenerPolicyStatus coop
- optional CrossOriginEmbedderPolicyStatus coep
- optional array of ContentSecurityPolicyStatus csp
-
- # Returns information about the COEP/COOP isolation status.
- experimental command getSecurityIsolationStatus
- parameters
- # If no frameId is provided, the status of the target is provided.
- optional Page.FrameId frameId
- returns
- SecurityIsolationStatus status
-
- # Enables tracking for the Reporting API, events generated by the Reporting API will now be delivered to the client.
- # Enabling triggers 'reportingApiReportAdded' for all existing reports.
- experimental command enableReportingApi
- parameters
- # Whether to enable or disable events for the Reporting API
- boolean enable
-
- # The status of a Reporting API report.
- experimental type ReportStatus extends string
- enum
- # Report has been queued and no attempt has been made to deliver it yet,
- # or attempted previous upload failed (impermanently).
- Queued
- # There is an ongoing attempt to upload this report.
- Pending
- # Deletion of this report was requested while it was pending, so it will
- # be removed after possibly outstanding upload attempts complete (successful
- # or not).
- MarkedForRemoval
- # Successfully uploaded and MarkedForRemoval.
- Success
-
- experimental type ReportId extends string
-
- # An object representing a report generated by the Reporting API.
- experimental type ReportingApiReport extends object
- properties
- ReportId id
- # The URL of the document that triggered the report.
- string initiatorUrl
- # The name of the endpoint group that should be used to deliver the report.
- string destination
- # The type of the report (specifies the set of data that is contained in the report body).
- string type
- # When the report was generated.
- Network.TimeSinceEpoch timestamp
- # How many uploads deep the related request was.
- integer depth
- # The number of delivery attempts made so far, not including an active attempt.
- integer completedAttempts
- object body
- ReportStatus status
-
- # Is sent whenever a new report is added.
- # And after 'enableReportingApi' for all existing reports.
- experimental event reportingApiReportAdded
- parameters
- ReportingApiReport report
-
- experimental event reportingApiReportUpdated
- parameters
- ReportingApiReport report
-
- experimental type ReportingApiEndpoint extends object
- properties
- # The URL of the endpoint to which reports may be delivered.
- string url
- # Name of the endpoint group.
- string groupName
-
- experimental event reportingApiEndpointsChangedForOrigin
- parameters
- # Origin of the document(s) which configured the endpoints.
- string origin
- array of ReportingApiEndpoint endpoints
-
- # An object providing the result of a network resource load.
- experimental type LoadNetworkResourcePageResult extends object
- properties
- boolean success
- # Optional values used for error reporting.
- optional number netError
- optional string netErrorName
- optional number httpStatusCode
- # If successful, one of the following two fields holds the result.
- optional IO.StreamHandle stream
- # Response headers.
- optional Network.Headers headers
-
- # An options object that may be extended later to better support CORS,
- # CORB and streaming.
- experimental type LoadNetworkResourceOptions extends object
- properties
- boolean disableCache
- boolean includeCredentials
-
- # Fetches the resource and returns the content.
- experimental command loadNetworkResource
- parameters
- # Frame id to get the resource for. Mandatory for frame targets, and
- # should be omitted for worker targets.
- optional Page.FrameId frameId
- # URL of the resource to get content for.
- string url
- # Options for the request.
- LoadNetworkResourceOptions options
- returns
- LoadNetworkResourcePageResult resource
-
- # Sets Controls for third-party cookie access
- # Page reload is required before the new cookie behavior will be observed
- experimental command setCookieControls
- parameters
- # Whether 3pc restriction is enabled.
- boolean enableThirdPartyCookieRestriction
-
- # Whether 3pc grace period exception should be enabled; false by default.
- boolean disableThirdPartyCookieMetadata
-
- # Whether 3pc heuristics exceptions should be enabled; false by default.
- boolean disableThirdPartyCookieHeuristics
-
-# This domain provides various functionality related to drawing atop the inspected page.
-experimental domain Overlay
- depends on DOM
- depends on Page
- depends on Runtime
-
- # Configuration data for drawing the source order of an elements children.
- type SourceOrderConfig extends object
- properties
- # the color to outline the given element in.
- DOM.RGBA parentOutlineColor
- # the color to outline the child elements in.
- DOM.RGBA childOutlineColor
-
- # Configuration data for the highlighting of Grid elements.
- type GridHighlightConfig extends object
- properties
- # Whether the extension lines from grid cells to the rulers should be shown (default: false).
- optional boolean showGridExtensionLines
- # Show Positive line number labels (default: false).
- optional boolean showPositiveLineNumbers
- # Show Negative line number labels (default: false).
- optional boolean showNegativeLineNumbers
- # Show area name labels (default: false).
- optional boolean showAreaNames
- # Show line name labels (default: false).
- optional boolean showLineNames
- # Show track size labels (default: false).
- optional boolean showTrackSizes
- # The grid container border highlight color (default: transparent).
- optional DOM.RGBA gridBorderColor
- # The cell border color (default: transparent). Deprecated, please use rowLineColor and columnLineColor instead.
- deprecated optional DOM.RGBA cellBorderColor
- # The row line color (default: transparent).
- optional DOM.RGBA rowLineColor
- # The column line color (default: transparent).
- optional DOM.RGBA columnLineColor
- # Whether the grid border is dashed (default: false).
- optional boolean gridBorderDash
- # Whether the cell border is dashed (default: false). Deprecated, please us rowLineDash and columnLineDash instead.
- deprecated optional boolean cellBorderDash
- # Whether row lines are dashed (default: false).
- optional boolean rowLineDash
- # Whether column lines are dashed (default: false).
- optional boolean columnLineDash
- # The row gap highlight fill color (default: transparent).
- optional DOM.RGBA rowGapColor
- # The row gap hatching fill color (default: transparent).
- optional DOM.RGBA rowHatchColor
- # The column gap highlight fill color (default: transparent).
- optional DOM.RGBA columnGapColor
- # The column gap hatching fill color (default: transparent).
- optional DOM.RGBA columnHatchColor
- # The named grid areas border color (Default: transparent).
- optional DOM.RGBA areaBorderColor
- # The grid container background color (Default: transparent).
- optional DOM.RGBA gridBackgroundColor
-
- # Configuration data for the highlighting of Flex container elements.
- type FlexContainerHighlightConfig extends object
- properties
- # The style of the container border
- optional LineStyle containerBorder
- # The style of the separator between lines
- optional LineStyle lineSeparator
- # The style of the separator between items
- optional LineStyle itemSeparator
- # Style of content-distribution space on the main axis (justify-content).
- optional BoxStyle mainDistributedSpace
- # Style of content-distribution space on the cross axis (align-content).
- optional BoxStyle crossDistributedSpace
- # Style of empty space caused by row gaps (gap/row-gap).
- optional BoxStyle rowGapSpace
- # Style of empty space caused by columns gaps (gap/column-gap).
- optional BoxStyle columnGapSpace
- # Style of the self-alignment line (align-items).
- optional LineStyle crossAlignment
-
- # Configuration data for the highlighting of Flex item elements.
- type FlexItemHighlightConfig extends object
- properties
- # Style of the box representing the item's base size
- optional BoxStyle baseSizeBox
- # Style of the border around the box representing the item's base size
- optional LineStyle baseSizeBorder
- # Style of the arrow representing if the item grew or shrank
- optional LineStyle flexibilityArrow
-
- # Style information for drawing a line.
- type LineStyle extends object
- properties
- # The color of the line (default: transparent)
- optional DOM.RGBA color
- # The line pattern (default: solid)
- optional enum pattern
- dashed
- dotted
-
- # Style information for drawing a box.
- type BoxStyle extends object
- properties
- # The background color for the box (default: transparent)
- optional DOM.RGBA fillColor
- # The hatching color for the box (default: transparent)
- optional DOM.RGBA hatchColor
-
- type ContrastAlgorithm extends string
- enum
- aa
- aaa
- apca
-
- # Configuration data for the highlighting of page elements.
- type HighlightConfig extends object
- properties
- # Whether the node info tooltip should be shown (default: false).
- optional boolean showInfo
- # Whether the node styles in the tooltip (default: false).
- optional boolean showStyles
- # Whether the rulers should be shown (default: false).
- optional boolean showRulers
- # Whether the a11y info should be shown (default: true).
- optional boolean showAccessibilityInfo
- # Whether the extension lines from node to the rulers should be shown (default: false).
- optional boolean showExtensionLines
- # The content box highlight fill color (default: transparent).
- optional DOM.RGBA contentColor
- # The padding highlight fill color (default: transparent).
- optional DOM.RGBA paddingColor
- # The border highlight fill color (default: transparent).
- optional DOM.RGBA borderColor
- # The margin highlight fill color (default: transparent).
- optional DOM.RGBA marginColor
- # The event target element highlight fill color (default: transparent).
- optional DOM.RGBA eventTargetColor
- # The shape outside fill color (default: transparent).
- optional DOM.RGBA shapeColor
- # The shape margin fill color (default: transparent).
- optional DOM.RGBA shapeMarginColor
- # The grid layout color (default: transparent).
- optional DOM.RGBA cssGridColor
- # The color format used to format color styles (default: hex).
- optional ColorFormat colorFormat
- # The grid layout highlight configuration (default: all transparent).
- optional GridHighlightConfig gridHighlightConfig
- # The flex container highlight configuration (default: all transparent).
- optional FlexContainerHighlightConfig flexContainerHighlightConfig
- # The flex item highlight configuration (default: all transparent).
- optional FlexItemHighlightConfig flexItemHighlightConfig
- # The contrast algorithm to use for the contrast ratio (default: aa).
- optional ContrastAlgorithm contrastAlgorithm
- # The container query container highlight configuration (default: all transparent).
- optional ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
-
- type ColorFormat extends string
- enum
- rgb
- hsl
- hwb
- hex
-
- # Configurations for Persistent Grid Highlight
- type GridNodeHighlightConfig extends object
- properties
- # A descriptor for the highlight appearance.
- GridHighlightConfig gridHighlightConfig
- # Identifier of the node to highlight.
- DOM.NodeId nodeId
-
- type FlexNodeHighlightConfig extends object
- properties
- # A descriptor for the highlight appearance of flex containers.
- FlexContainerHighlightConfig flexContainerHighlightConfig
- # Identifier of the node to highlight.
- DOM.NodeId nodeId
-
- type ScrollSnapContainerHighlightConfig extends object
- properties
- # The style of the snapport border (default: transparent)
- optional LineStyle snapportBorder
- # The style of the snap area border (default: transparent)
- optional LineStyle snapAreaBorder
- # The margin highlight fill color (default: transparent).
- optional DOM.RGBA scrollMarginColor
- # The padding highlight fill color (default: transparent).
- optional DOM.RGBA scrollPaddingColor
-
- type ScrollSnapHighlightConfig extends object
- properties
- # A descriptor for the highlight appearance of scroll snap containers.
- ScrollSnapContainerHighlightConfig scrollSnapContainerHighlightConfig
- # Identifier of the node to highlight.
- DOM.NodeId nodeId
-
- # Configuration for dual screen hinge
- type HingeConfig extends object
- properties
- # A rectangle represent hinge
- DOM.Rect rect
- # The content box highlight fill color (default: a dark color).
- optional DOM.RGBA contentColor
- # The content box highlight outline color (default: transparent).
- optional DOM.RGBA outlineColor
-
- # Configuration for Window Controls Overlay
- type WindowControlsOverlayConfig extends object
- properties
- # Whether the title bar CSS should be shown when emulating the Window Controls Overlay.
- boolean showCSS
- # Selected platforms to show the overlay.
- string selectedPlatform
- # The theme color defined in app manifest.
- string themeColor
-
- type ContainerQueryHighlightConfig extends object
- properties
- # A descriptor for the highlight appearance of container query containers.
- ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
- # Identifier of the container node to highlight.
- DOM.NodeId nodeId
-
- type ContainerQueryContainerHighlightConfig extends object
- properties
- # The style of the container border.
- optional LineStyle containerBorder
- # The style of the descendants' borders.
- optional LineStyle descendantBorder
-
- type IsolatedElementHighlightConfig extends object
- properties
- # A descriptor for the highlight appearance of an element in isolation mode.
- IsolationModeHighlightConfig isolationModeHighlightConfig
- # Identifier of the isolated element to highlight.
- DOM.NodeId nodeId
-
- type IsolationModeHighlightConfig extends object
- properties
- # The fill color of the resizers (default: transparent).
- optional DOM.RGBA resizerColor
- # The fill color for resizer handles (default: transparent).
- optional DOM.RGBA resizerHandleColor
- # The fill color for the mask covering non-isolated elements (default: transparent).
- optional DOM.RGBA maskColor
-
- type InspectMode extends string
- enum
- searchForNode
- searchForUAShadowDOM
- captureAreaScreenshot
- none
-
- # Disables domain notifications.
- command disable
-
- # Enables domain notifications.
- command enable
-
- # For testing.
- command getHighlightObjectForTest
- parameters
- # Id of the node to get highlight object for.
- DOM.NodeId nodeId
- # Whether to include distance info.
- optional boolean includeDistance
- # Whether to include style info.
- optional boolean includeStyle
- # The color format to get config with (default: hex).
- optional ColorFormat colorFormat
- # Whether to show accessibility info (default: true).
- optional boolean showAccessibilityInfo
- returns
- # Highlight data for the node.
- object highlight
-
- # For Persistent Grid testing.
- command getGridHighlightObjectsForTest
- parameters
- # Ids of the node to get highlight object for.
- array of DOM.NodeId nodeIds
- returns
- # Grid Highlight data for the node ids provided.
- object highlights
-
- # For Source Order Viewer testing.
- command getSourceOrderHighlightObjectForTest
- parameters
- # Id of the node to highlight.
- DOM.NodeId nodeId
- returns
- # Source order highlight data for the node id provided.
- object highlight
-
- # Hides any highlight.
- command hideHighlight
-
- # Highlights owner element of the frame with given id.
- # Deprecated: Doesn't work reliably and cannot be fixed due to process
- # separation (the owner node might be in a different process). Determine
- # the owner node in the client and use highlightNode.
- deprecated command highlightFrame
- parameters
- # Identifier of the frame to highlight.
- Page.FrameId frameId
- # The content box highlight fill color (default: transparent).
- optional DOM.RGBA contentColor
- # The content box highlight outline color (default: transparent).
- optional DOM.RGBA contentOutlineColor
-
- # Highlights DOM node with given id or with the given JavaScript object wrapper. Either nodeId or
- # objectId must be specified.
- command highlightNode
- parameters
- # A descriptor for the highlight appearance.
- HighlightConfig highlightConfig
- # Identifier of the node to highlight.
- optional DOM.NodeId nodeId
- # Identifier of the backend node to highlight.
- optional DOM.BackendNodeId backendNodeId
- # JavaScript object id of the node to be highlighted.
- optional Runtime.RemoteObjectId objectId
- # Selectors to highlight relevant nodes.
- optional string selector
-
- # Highlights given quad. Coordinates are absolute with respect to the main frame viewport.
- command highlightQuad
- parameters
- # Quad to highlight
- DOM.Quad quad
- # The highlight fill color (default: transparent).
- optional DOM.RGBA color
- # The highlight outline color (default: transparent).
- optional DOM.RGBA outlineColor
-
- # Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport.
- command highlightRect
- parameters
- # X coordinate
- integer x
- # Y coordinate
- integer y
- # Rectangle width
- integer width
- # Rectangle height
- integer height
- # The highlight fill color (default: transparent).
- optional DOM.RGBA color
- # The highlight outline color (default: transparent).
- optional DOM.RGBA outlineColor
-
- # Highlights the source order of the children of the DOM node with given id or with the given
- # JavaScript object wrapper. Either nodeId or objectId must be specified.
- command highlightSourceOrder
- parameters
- # A descriptor for the appearance of the overlay drawing.
- SourceOrderConfig sourceOrderConfig
- # Identifier of the node to highlight.
- optional DOM.NodeId nodeId
- # Identifier of the backend node to highlight.
- optional DOM.BackendNodeId backendNodeId
- # JavaScript object id of the node to be highlighted.
- optional Runtime.RemoteObjectId objectId
-
- # Enters the 'inspect' mode. In this mode, elements that user is hovering over are highlighted.
- # Backend then generates 'inspectNodeRequested' event upon element selection.
- command setInspectMode
- parameters
- # Set an inspection mode.
- InspectMode mode
- # A descriptor for the highlight appearance of hovered-over nodes. May be omitted if `enabled
- # == false`.
- optional HighlightConfig highlightConfig
-
- # Highlights owner element of all frames detected to be ads.
- command setShowAdHighlights
- parameters
- # True for showing ad highlights
- boolean show
-
- command setPausedInDebuggerMessage
- parameters
- # The message to display, also triggers resume and step over controls.
- optional string message
-
- # Requests that backend shows debug borders on layers
- command setShowDebugBorders
- parameters
- # True for showing debug borders
- boolean show
-
- # Requests that backend shows the FPS counter
- command setShowFPSCounter
- parameters
- # True for showing the FPS counter
- boolean show
-
- # Highlight multiple elements with the CSS Grid overlay.
- command setShowGridOverlays
- parameters
- # An array of node identifiers and descriptors for the highlight appearance.
- array of GridNodeHighlightConfig gridNodeHighlightConfigs
-
- command setShowFlexOverlays
- parameters
- # An array of node identifiers and descriptors for the highlight appearance.
- array of FlexNodeHighlightConfig flexNodeHighlightConfigs
-
- command setShowScrollSnapOverlays
- parameters
- # An array of node identifiers and descriptors for the highlight appearance.
- array of ScrollSnapHighlightConfig scrollSnapHighlightConfigs
-
- command setShowContainerQueryOverlays
- parameters
- # An array of node identifiers and descriptors for the highlight appearance.
- array of ContainerQueryHighlightConfig containerQueryHighlightConfigs
-
- # Requests that backend shows paint rectangles
- command setShowPaintRects
- parameters
- # True for showing paint rectangles
- boolean result
-
- # Requests that backend shows layout shift regions
- command setShowLayoutShiftRegions
- parameters
- # True for showing layout shift regions
- boolean result
-
- # Requests that backend shows scroll bottleneck rects
- command setShowScrollBottleneckRects
- parameters
- # True for showing scroll bottleneck rects
- boolean show
-
- # Deprecated, no longer has any effect.
- deprecated command setShowHitTestBorders
- parameters
- # True for showing hit-test borders
- boolean show
-
- # Deprecated, no longer has any effect.
- deprecated command setShowWebVitals
- parameters
- boolean show
-
- # Paints viewport size upon main frame resize.
- command setShowViewportSizeOnResize
- parameters
- # Whether to paint size or not.
- boolean show
-
- # Add a dual screen device hinge
- command setShowHinge
- parameters
- # hinge data, null means hideHinge
- optional HingeConfig hingeConfig
-
- # Show elements in isolation mode with overlays.
- command setShowIsolatedElements
- parameters
- # An array of node identifiers and descriptors for the highlight appearance.
- array of IsolatedElementHighlightConfig isolatedElementHighlightConfigs
-
- # Show Window Controls Overlay for PWA
- command setShowWindowControlsOverlay
- parameters
- # Window Controls Overlay data, null means hide Window Controls Overlay
- optional WindowControlsOverlayConfig windowControlsOverlayConfig
-
- # Fired when the node should be inspected. This happens after call to `setInspectMode` or when
- # user manually inspects an element.
- event inspectNodeRequested
- parameters
- # Id of the node to inspect.
- DOM.BackendNodeId backendNodeId
-
- # Fired when the node should be highlighted. This happens after call to `setInspectMode`.
- event nodeHighlightRequested
- parameters
- DOM.NodeId nodeId
-
- # Fired when user asks to capture screenshot of some area on the page.
- event screenshotRequested
- parameters
- # Viewport to capture, in device independent pixels (dip).
- Page.Viewport viewport
-
- # Fired when user cancels the inspect mode.
- event inspectModeCanceled
-
-# Actions and events related to the inspected page belong to the page domain.
-domain Page
- depends on Debugger
- depends on DOM
- depends on IO
- depends on Network
- depends on Runtime
-
- # Unique frame identifier.
- type FrameId extends string
-
- # Indicates whether a frame has been identified as an ad.
- experimental type AdFrameType extends string
- enum
- none
- # This frame is a subframe of an ad frame.
- child
- # This frame is the root of an ad frame.
- root
-
- experimental type AdFrameExplanation extends string
- enum
- ParentIsAd
- CreatedByAdScript
- MatchedBlockingRule
-
- # Indicates whether a frame has been identified as an ad and why.
- experimental type AdFrameStatus extends object
- properties
- AdFrameType adFrameType
- optional array of AdFrameExplanation explanations
-
- # Identifies the script which caused a script or frame to be labelled as an
- # ad.
- experimental type AdScriptId extends object
- properties
- # Script Id of the script which caused a script or frame to be labelled as
- # an ad.
- Runtime.ScriptId scriptId
- # Id of scriptId's debugger.
- Runtime.UniqueDebuggerId debuggerId
-
- # Encapsulates the script ancestry and the root script filterlist rule that
- # caused the frame to be labelled as an ad. Only created when `ancestryChain`
- # is not empty.
- experimental type AdScriptAncestry extends object
- properties
- # A chain of `AdScriptId`s representing the ancestry of an ad script that
- # led to the creation of a frame. The chain is ordered from the script
- # itself (lower level) up to its root ancestor that was flagged by
- # filterlist.
- array of AdScriptId ancestryChain
- # The filterlist rule that caused the root (last) script in
- # `ancestryChain` to be ad-tagged. Only populated if the rule is
- # available.
- optional string rootScriptFilterlistRule
-
- # Indicates whether the frame is a secure context and why it is the case.
- experimental type SecureContextType extends string
- enum
- # The origin is a secure context.
- Secure
- # The host is localhost and hence is considered secure.
- SecureLocalhost
- # The origin has an insecure scheme and is not localhost.
- InsecureScheme
- # One of the ancestor frames is not a secure context.
- InsecureAncestor
-
- # Indicates whether the frame is cross-origin isolated and why it is the case.
- experimental type CrossOriginIsolatedContextType extends string
- enum
- # The origin is cross-origin isolated.
- Isolated
- # The origin is not cross-origin isolated.
- NotIsolated
- # The cross-origin isolation feature is disabled.
- NotIsolatedFeatureDisabled
-
- experimental type GatedAPIFeatures extends string
- enum
- SharedArrayBuffers
- SharedArrayBuffersTransferAllowed
- PerformanceMeasureMemory
- PerformanceProfile
-
- # All Permissions Policy features. This enum should match the one defined
- # in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
- # LINT.IfChange(PermissionsPolicyFeature)
- experimental type PermissionsPolicyFeature extends string
- enum
- accelerometer
- all-screens-capture
- ambient-light-sensor
- aria-notify
- attribution-reporting
- autoplay
- bluetooth
- browsing-topics
- camera
- captured-surface-control
- ch-dpr
- ch-device-memory
- ch-downlink
- ch-ect
- ch-prefers-color-scheme
- ch-prefers-reduced-motion
- ch-prefers-reduced-transparency
- ch-rtt
- ch-save-data
- ch-ua
- ch-ua-arch
- ch-ua-bitness
- ch-ua-high-entropy-values
- ch-ua-platform
- ch-ua-model
- ch-ua-mobile
- ch-ua-form-factors
- ch-ua-full-version
- ch-ua-full-version-list
- ch-ua-platform-version
- ch-ua-wow64
- ch-viewport-height
- ch-viewport-width
- ch-width
- clipboard-read
- clipboard-write
- compute-pressure
- controlled-frame
- cross-origin-isolated
- deferred-fetch
- deferred-fetch-minimal
- device-attributes
- digital-credentials-create
- digital-credentials-get
- direct-sockets
- direct-sockets-private
- display-capture
- document-domain
- encrypted-media
- execution-while-out-of-viewport
- execution-while-not-rendered
- fenced-unpartitioned-storage-read
- focus-without-user-activation
- fullscreen
- frobulate
- gamepad
- geolocation
- gyroscope
- hid
- identity-credentials-get
- idle-detection
- interest-cohort
- join-ad-interest-group
- keyboard-map
- language-detector
- language-model
- local-fonts
- local-network-access
- magnetometer
- media-playback-while-not-visible
- microphone
- midi
- on-device-speech-recognition
- otp-credentials
- payment
- picture-in-picture
- popins
- private-aggregation
- private-state-token-issuance
- private-state-token-redemption
- publickey-credentials-create
- publickey-credentials-get
- record-ad-auction-events
- rewriter
- run-ad-auction
- screen-wake-lock
- serial
- shared-autofill
- shared-storage
- shared-storage-select-url
- smart-card
- speaker-selection
- storage-access
- sub-apps
- summarizer
- sync-xhr
- translator
- unload
- usb
- usb-unrestricted
- vertical-scroll
- web-app-installation
- web-printing
- web-share
- window-management
- writer
- xr-spatial-tracking
- # LINT.ThenChange(//services/network/public/cpp/permissions_policy/permissions_policy_features.json5:PermissionsPolicy)
-
- # Reason for a permissions policy feature to be disabled.
- experimental type PermissionsPolicyBlockReason extends string
- enum
- # Declaration in HTTP header.
- Header
- # Declaration in iframe attribute.
- IframeAttribute
- # Inside fenced frame.
- InFencedFrameTree
- # Inside an Isolated Application.
- InIsolatedApp
-
- experimental type PermissionsPolicyBlockLocator extends object
- properties
- FrameId frameId
- PermissionsPolicyBlockReason blockReason
-
- experimental type PermissionsPolicyFeatureState extends object
- properties
- PermissionsPolicyFeature feature
- boolean allowed
- optional PermissionsPolicyBlockLocator locator
-
- # Origin Trial(https://www.chromium.org/blink/origin-trials) support.
- # Status for an Origin Trial token.
- experimental type OriginTrialTokenStatus extends string
- enum
- Success
- NotSupported
- Insecure
- Expired
- WrongOrigin
- InvalidSignature
- Malformed
- WrongVersion
- FeatureDisabled
- TokenDisabled
- FeatureDisabledForUser
- UnknownTrial
-
- # Status for an Origin Trial.
- experimental type OriginTrialStatus extends string
- enum
- Enabled
- ValidTokenNotProvided
- OSNotSupported
- TrialNotAllowed
-
- experimental type OriginTrialUsageRestriction extends string
- enum
- None
- Subset
-
- experimental type OriginTrialToken extends object
- properties
- string origin
- boolean matchSubDomains
- string trialName
- Network.TimeSinceEpoch expiryTime
- boolean isThirdParty
- OriginTrialUsageRestriction usageRestriction
-
- experimental type OriginTrialTokenWithStatus extends object
- properties
- string rawTokenText
- # `parsedToken` is present only when the token is extractable and
- # parsable.
- optional OriginTrialToken parsedToken
- OriginTrialTokenStatus status
-
- experimental type OriginTrial extends object
- properties
- string trialName
- OriginTrialStatus status
- array of OriginTrialTokenWithStatus tokensWithStatus
-
- # Additional information about the frame document's security origin.
- experimental type SecurityOriginDetails extends object
- properties
- # Indicates whether the frame document's security origin is one
- # of the local hostnames (e.g. "localhost") or IP addresses (IPv4
- # 127.0.0.0/8 or IPv6 ::1).
- boolean isLocalhost
-
- # Information about the Frame on the page.
- type Frame extends object
- properties
- # Frame unique identifier.
- FrameId id
- # Parent frame identifier.
- optional FrameId parentId
- # Identifier of the loader associated with this frame.
- Network.LoaderId loaderId
- # Frame's name as specified in the tag.
- optional string name
- # Frame document's URL without fragment.
- string url
- # Frame document's URL fragment including the '#'.
- experimental optional string urlFragment
- # Frame document's registered domain, taking the public suffixes list into account.
- # Extracted from the Frame's url.
- # Example URLs: http://www.google.com/file.html -> "google.com"
- # http://a.b.co.uk/file.html -> "b.co.uk"
- experimental string domainAndRegistry
- # Frame document's security origin.
- string securityOrigin
- # Additional details about the frame document's security origin.
- experimental optional SecurityOriginDetails securityOriginDetails
- # Frame document's mimeType as determined by the browser.
- string mimeType
- # If the frame failed to load, this contains the URL that could not be loaded. Note that unlike url above, this URL may contain a fragment.
- experimental optional string unreachableUrl
- # Indicates whether this frame was tagged as an ad and why.
- experimental optional AdFrameStatus adFrameStatus
- # Indicates whether the main document is a secure context and explains why that is the case.
- experimental SecureContextType secureContextType
- # Indicates whether this is a cross origin isolated context.
- experimental CrossOriginIsolatedContextType crossOriginIsolatedContextType
- # Indicated which gated APIs / features are available.
- experimental array of GatedAPIFeatures gatedAPIFeatures
-
- # Information about the Resource on the page.
- experimental type FrameResource extends object
- properties
- # Resource URL.
- string url
- # Type of this resource.
- Network.ResourceType type
- # Resource mimeType as determined by the browser.
- string mimeType
- # last-modified timestamp as reported by server.
- optional Network.TimeSinceEpoch lastModified
- # Resource content size.
- optional number contentSize
- # True if the resource failed to load.
- optional boolean failed
- # True if the resource was canceled during loading.
- optional boolean canceled
-
- # Information about the Frame hierarchy along with their cached resources.
- experimental type FrameResourceTree extends object
- properties
- # Frame information for this tree item.
- Frame frame
- # Child frames.
- optional array of FrameResourceTree childFrames
- # Information about frame resources.
- array of FrameResource resources
-
- # Information about the Frame hierarchy.
- type FrameTree extends object
- properties
- # Frame information for this tree item.
- Frame frame
- # Child frames.
- optional array of FrameTree childFrames
-
- # Unique script identifier.
- type ScriptIdentifier extends string
-
- # Transition type.
- type TransitionType extends string
- enum
- link
- typed
- address_bar
- auto_bookmark
- auto_subframe
- manual_subframe
- generated
- auto_toplevel
- form_submit
- reload
- keyword
- keyword_generated
- other
-
- # Navigation history entry.
- type NavigationEntry extends object
- properties
- # Unique id of the navigation history entry.
- integer id
- # URL of the navigation history entry.
- string url
- # URL that the user typed in the url bar.
- string userTypedURL
- # Title of the navigation history entry.
- string title
- # Transition type.
- TransitionType transitionType
-
- # Screencast frame metadata.
- experimental type ScreencastFrameMetadata extends object
- properties
- # Top offset in DIP.
- number offsetTop
- # Page scale factor.
- number pageScaleFactor
- # Device screen width in DIP.
- number deviceWidth
- # Device screen height in DIP.
- number deviceHeight
- # Position of horizontal scroll in CSS pixels.
- number scrollOffsetX
- # Position of vertical scroll in CSS pixels.
- number scrollOffsetY
- # Frame swap timestamp.
- optional Network.TimeSinceEpoch timestamp
-
- # Javascript dialog type.
- type DialogType extends string
- enum
- alert
- confirm
- prompt
- beforeunload
-
- # Error while paring app manifest.
- type AppManifestError extends object
- properties
- # Error message.
- string message
- # If critical, this is a non-recoverable parse error.
- integer critical
- # Error line.
- integer line
- # Error column.
- integer column
-
- # Parsed app manifest properties.
- experimental type AppManifestParsedProperties extends object
- properties
- # Computed scope value
- string scope
-
- # Layout viewport position and dimensions.
- type LayoutViewport extends object
- properties
- # Horizontal offset relative to the document (CSS pixels).
- integer pageX
- # Vertical offset relative to the document (CSS pixels).
- integer pageY
- # Width (CSS pixels), excludes scrollbar if present.
- integer clientWidth
- # Height (CSS pixels), excludes scrollbar if present.
- integer clientHeight
-
- # Visual viewport position, dimensions, and scale.
- type VisualViewport extends object
- properties
- # Horizontal offset relative to the layout viewport (CSS pixels).
- number offsetX
- # Vertical offset relative to the layout viewport (CSS pixels).
- number offsetY
- # Horizontal offset relative to the document (CSS pixels).
- number pageX
- # Vertical offset relative to the document (CSS pixels).
- number pageY
- # Width (CSS pixels), excludes scrollbar if present.
- number clientWidth
- # Height (CSS pixels), excludes scrollbar if present.
- number clientHeight
- # Scale relative to the ideal viewport (size at width=device-width).
- number scale
- # Page zoom factor (CSS to device independent pixels ratio).
- optional number zoom
-
- # Viewport for capturing screenshot.
- type Viewport extends object
- properties
- # X offset in device independent pixels (dip).
- number x
- # Y offset in device independent pixels (dip).
- number y
- # Rectangle width in device independent pixels (dip).
- number width
- # Rectangle height in device independent pixels (dip).
- number height
- # Page scale factor.
- number scale
-
- # Generic font families collection.
- experimental type FontFamilies extends object
- properties
- # The standard font-family.
- optional string standard
- # The fixed font-family.
- optional string fixed
- # The serif font-family.
- optional string serif
- # The sansSerif font-family.
- optional string sansSerif
- # The cursive font-family.
- optional string cursive
- # The fantasy font-family.
- optional string fantasy
- # The math font-family.
- optional string math
-
- # Font families collection for a script.
- experimental type ScriptFontFamilies extends object
- properties
- # Name of the script which these font families are defined for.
- string script
- # Generic font families collection for the script.
- FontFamilies fontFamilies
-
- # Default font sizes.
- experimental type FontSizes extends object
- properties
- # Default standard font size.
- optional integer standard
- # Default fixed font size.
- optional integer fixed
-
- experimental type ClientNavigationReason extends string
- enum
- anchorClick
- formSubmissionGet
- formSubmissionPost
- httpHeaderRefresh
- initialFrameNavigation
- metaTagRefresh
- other
- pageBlockInterstitial
- reload
- scriptInitiated
-
- experimental type ClientNavigationDisposition extends string
- enum
- currentTab
- newTab
- newWindow
- download
-
- experimental type InstallabilityErrorArgument extends object
- properties
- # Argument name (e.g. name:'minimum-icon-size-in-pixels').
- string name
- # Argument value (e.g. value:'64').
- string value
-
- # The installability error
- experimental type InstallabilityError extends object
- properties
- # The error id (e.g. 'manifest-missing-suitable-icon').
- string errorId
- # The list of error arguments (e.g. {name:'minimum-icon-size-in-pixels', value:'64'}).
- array of InstallabilityErrorArgument errorArguments
-
- # The referring-policy used for the navigation.
- experimental type ReferrerPolicy extends string
- enum
- noReferrer
- noReferrerWhenDowngrade
- origin
- originWhenCrossOrigin
- sameOrigin
- strictOrigin
- strictOriginWhenCrossOrigin
- unsafeUrl
-
- # Per-script compilation cache parameters for `Page.produceCompilationCache`
- experimental type CompilationCacheParams extends object
- properties
- # The URL of the script to produce a compilation cache entry for.
- string url
- # A hint to the backend whether eager compilation is recommended.
- # (the actual compilation mode used is upon backend discretion).
- optional boolean eager
-
- # Deprecated, please use addScriptToEvaluateOnNewDocument instead.
- experimental deprecated command addScriptToEvaluateOnLoad
- parameters
- string scriptSource
- returns
- # Identifier of the added script.
- ScriptIdentifier identifier
-
- # Evaluates given script in every frame upon creation (before loading frame's scripts).
- command addScriptToEvaluateOnNewDocument
- parameters
- string source
- # If specified, creates an isolated world with the given name and evaluates given script in it.
- # This world name will be used as the ExecutionContextDescription::name when the corresponding
- # event is emitted.
- experimental optional string worldName
- # Specifies whether command line API should be available to the script, defaults
- # to false.
- experimental optional boolean includeCommandLineAPI
- # If true, runs the script immediately on existing execution contexts or worlds.
- # Default: false.
- experimental optional boolean runImmediately
- returns
- # Identifier of the added script.
- ScriptIdentifier identifier
-
- # Brings page to front (activates tab).
- command bringToFront
-
- # Capture page screenshot.
- command captureScreenshot
- parameters
- # Image compression format (defaults to png).
- optional enum format
- jpeg
- png
- webp
- # Compression quality from range [0..100] (jpeg only).
- optional integer quality
- # Capture the screenshot of a given region only.
- optional Viewport clip
- # Capture the screenshot from the surface, rather than the view. Defaults to true.
- experimental optional boolean fromSurface
- # Capture the screenshot beyond the viewport. Defaults to false.
- experimental optional boolean captureBeyondViewport
- # Optimize image encoding for speed, not for resulting size (defaults to false)
- experimental optional boolean optimizeForSpeed
- returns
- # Base64-encoded image data.
- binary data
-
- # Returns a snapshot of the page as a string. For MHTML format, the serialization includes
- # iframes, shadow DOM, external resources, and element-inline styles.
- experimental command captureSnapshot
- parameters
- # Format (defaults to mhtml).
- optional enum format
- mhtml
- returns
- # Serialized page data.
- string data
-
- # Clears the overridden device metrics.
- experimental deprecated command clearDeviceMetricsOverride
- # Use 'Emulation.clearDeviceMetricsOverride' instead
- redirect Emulation
-
- # Clears the overridden Device Orientation.
- experimental deprecated command clearDeviceOrientationOverride
- # Use 'DeviceOrientation.clearDeviceOrientationOverride' instead
- redirect DeviceOrientation
-
- # Clears the overridden Geolocation Position and Error.
- deprecated command clearGeolocationOverride
- # Use 'Emulation.clearGeolocationOverride' instead
- redirect Emulation
-
- # Creates an isolated world for the given frame.
- command createIsolatedWorld
- parameters
- # Id of the frame in which the isolated world should be created.
- FrameId frameId
- # An optional name which is reported in the Execution Context.
- optional string worldName
- # Whether or not universal access should be granted to the isolated world. This is a powerful
- # option, use with caution.
- optional boolean grantUniveralAccess
- returns
- # Execution context of the isolated world.
- Runtime.ExecutionContextId executionContextId
-
- # Deletes browser cookie with given name, domain and path.
- experimental deprecated command deleteCookie
- # Use 'Network.deleteCookie' instead
- redirect Network
- parameters
- # Name of the cookie to remove.
- string cookieName
- # URL to match cooke domain and path.
- string url
-
- # Disables page domain notifications.
- command disable
-
- # Enables page domain notifications.
- command enable
- parameters
- # If true, the `Page.fileChooserOpened` event will be emitted regardless of the state set by
- # `Page.setInterceptFileChooserDialog` command (default: false).
- experimental optional boolean enableFileChooserOpenedEvent
-
- # The manifest of a webapp, see
- # https://www.w3.org/TR/appmanifest/#dfn-manifest.
- # Some fields do not appear in the standard since the API is designed to
- # expose more browser internal states.
-
- experimental type FileFilter extends object
- properties
- optional string name
- optional array of string accepts
-
- experimental type FileHandler extends object
- properties
- string action
- string name
- optional array of ImageResource icons
- # Mimic a map, name is the key, accepts is the value.
- optional array of FileFilter accepts
- # Won't repeat the enums, using string for easy comparison. Same as the
- # other enums below.
- string launchType
-
- # The image definition used in both icon and screenshot.
- experimental type ImageResource extends object
- properties
- # The src field in the definition, but changing to url in favor of
- # consistency.
- string url
- optional string sizes
- optional string type
-
- experimental type LaunchHandler extends object
- properties
- string clientMode
-
- experimental type ProtocolHandler extends object
- properties
- string protocol
- string url
-
- experimental type RelatedApplication extends object
- properties
- optional string id
- string url
-
- experimental type ScopeExtension extends object
- properties
- # Instead of using tuple, this field always returns the serialized string
- # for easy understanding and comparison.
- string origin
- boolean hasOriginWildcard
-
- experimental type Screenshot extends object
- properties
- ImageResource image
- string formFactor
- optional string label
-
- experimental type ShareTarget extends object
- properties
- string action
- string method
- string enctype
- # Embed the ShareTargetParams
- optional string title
- optional string text
- optional string url
- optional array of FileFilter files
-
- experimental type Shortcut extends object
- properties
- string name
- string url
-
- experimental type WebAppManifest extends object
- properties
- optional string backgroundColor
- # The extra description provided by the manifest.
- optional string description
- optional string dir
- optional string display
- # The overrided display mode controlled by the user.
- optional array of string displayOverrides
- # The handlers to open files.
- optional array of FileHandler fileHandlers
- optional array of ImageResource icons
- optional string id
- optional string lang
- # TODO(crbug.com/1231886): This field is non-standard and part of a Chrome
- # experiment. See:
- # https://github.com/WICG/web-app-launch/blob/main/launch_handler.md
- optional LaunchHandler launchHandler
- optional string name
- optional string orientation
- optional boolean preferRelatedApplications
- # The handlers to open protocols.
- optional array of ProtocolHandler protocolHandlers
- optional array of RelatedApplication relatedApplications
- optional string scope
- # Non-standard, see
- # https://github.com/WICG/manifest-incubations/blob/gh-pages/scope_extensions-explainer.md
- optional array of ScopeExtension scopeExtensions
- # The screenshots used by chromium.
- optional array of Screenshot screenshots
- optional ShareTarget shareTarget
- optional string shortName
- optional array of Shortcut shortcuts
- optional string startUrl
- optional string themeColor
-
- # Gets the processed manifest for this current document.
- # This API always waits for the manifest to be loaded.
- # If manifestId is provided, and it does not match the manifest of the
- # current document, this API errors out.
- # If there is not a loaded page, this API errors out immediately.
- command getAppManifest
- parameters
- optional string manifestId
- returns
- # Manifest location.
- string url
- array of AppManifestError errors
- # Manifest content.
- optional string data
- # Parsed manifest properties. Deprecated, use manifest instead.
- experimental deprecated optional AppManifestParsedProperties parsed
- experimental WebAppManifest manifest
-
- experimental command getInstallabilityErrors
- returns
- array of InstallabilityError installabilityErrors
-
- # Deprecated because it's not guaranteed that the returned icon is in fact the one used for PWA installation.
- experimental deprecated command getManifestIcons
- returns
- optional binary primaryIcon
-
- # Returns the unique (PWA) app id.
- # Only returns values if the feature flag 'WebAppEnableManifestId' is enabled
- experimental command getAppId
- returns
- # App id, either from manifest's id attribute or computed from start_url
- optional string appId
- # Recommendation for manifest's id attribute to match current id computed from start_url
- optional string recommendedId
-
- experimental command getAdScriptAncestry
- parameters
- FrameId frameId
- returns
- # The ancestry chain of ad script identifiers leading to this frame's
- # creation, along with the root script's filterlist rule. The ancestry
- # chain is ordered from the most immediate script (in the frame creation
- # stack) to more distant ancestors (that created the immediately preceding
- # script). Only sent if frame is labelled as an ad and ids are available.
- optional AdScriptAncestry adScriptAncestry
-
- # Returns present frame tree structure.
- command getFrameTree
- returns
- # Present frame tree structure.
- FrameTree frameTree
-
- # Returns metrics relating to the layouting of the page, such as viewport bounds/scale.
- command getLayoutMetrics
- returns
- # Deprecated metrics relating to the layout viewport. Is in device pixels. Use `cssLayoutViewport` instead.
- deprecated LayoutViewport layoutViewport
- # Deprecated metrics relating to the visual viewport. Is in device pixels. Use `cssVisualViewport` instead.
- deprecated VisualViewport visualViewport
- # Deprecated size of scrollable area. Is in DP. Use `cssContentSize` instead.
- deprecated DOM.Rect contentSize
- # Metrics relating to the layout viewport in CSS pixels.
- LayoutViewport cssLayoutViewport
- # Metrics relating to the visual viewport in CSS pixels.
- VisualViewport cssVisualViewport
- # Size of scrollable area in CSS pixels.
- DOM.Rect cssContentSize
-
- # Returns navigation history for the current page.
- command getNavigationHistory
- returns
- # Index of the current navigation history entry.
- integer currentIndex
- # Array of navigation history entries.
- array of NavigationEntry entries
-
- # Resets navigation history for the current page.
- command resetNavigationHistory
-
- # Returns content of the given resource.
- experimental command getResourceContent
- parameters
- # Frame id to get resource for.
- FrameId frameId
- # URL of the resource to get content for.
- string url
- returns
- # Resource content.
- string content
- # True, if content was served as base64.
- boolean base64Encoded
-
- # Returns present frame / resource tree structure.
- experimental command getResourceTree
- returns
- # Present frame / resource tree structure.
- FrameResourceTree frameTree
-
- # Accepts or dismisses a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload).
- command handleJavaScriptDialog
- parameters
- # Whether to accept or dismiss the dialog.
- boolean accept
- # The text to enter into the dialog prompt before accepting. Used only if this is a prompt
- # dialog.
- optional string promptText
-
- # Navigates current page to the given URL.
- command navigate
- parameters
- # URL to navigate the page to.
- string url
- # Referrer URL.
- optional string referrer
- # Intended transition type.
- optional TransitionType transitionType
- # Frame id to navigate, if not specified navigates the top frame.
- optional FrameId frameId
- # Referrer-policy used for the navigation.
- experimental optional ReferrerPolicy referrerPolicy
- returns
- # Frame id that has navigated (or failed to navigate)
- FrameId frameId
- # Loader identifier. This is omitted in case of same-document navigation,
- # as the previously committed loaderId would not change.
- optional Network.LoaderId loaderId
- # User friendly error message, present if and only if navigation has failed.
- optional string errorText
- # Whether the navigation resulted in a download.
- experimental optional boolean isDownload
-
- # Navigates current page to the given history entry.
- command navigateToHistoryEntry
- parameters
- # Unique id of the entry to navigate to.
- integer entryId
-
- # Print page as PDF.
- command printToPDF
- parameters
- # Paper orientation. Defaults to false.
- optional boolean landscape
- # Display header and footer. Defaults to false.
- optional boolean displayHeaderFooter
- # Print background graphics. Defaults to false.
- optional boolean printBackground
- # Scale of the webpage rendering. Defaults to 1.
- optional number scale
- # Paper width in inches. Defaults to 8.5 inches.
- optional number paperWidth
- # Paper height in inches. Defaults to 11 inches.
- optional number paperHeight
- # Top margin in inches. Defaults to 1cm (~0.4 inches).
- optional number marginTop
- # Bottom margin in inches. Defaults to 1cm (~0.4 inches).
- optional number marginBottom
- # Left margin in inches. Defaults to 1cm (~0.4 inches).
- optional number marginLeft
- # Right margin in inches. Defaults to 1cm (~0.4 inches).
- optional number marginRight
- # Paper ranges to print, one based, e.g., '1-5, 8, 11-13'. Pages are
- # printed in the document order, not in the order specified, and no
- # more than once.
- # Defaults to empty string, which implies the entire document is printed.
- # The page numbers are quietly capped to actual page count of the
- # document, and ranges beyond the end of the document are ignored.
- # If this results in no pages to print, an error is reported.
- # It is an error to specify a range with start greater than end.
- optional string pageRanges
- # HTML template for the print header. Should be valid HTML markup with following
- # classes used to inject printing values into them:
- # - `date`: formatted print date
- # - `title`: document title
- # - `url`: document location
- # - `pageNumber`: current page number
- # - `totalPages`: total pages in the document
- #
- # For example, `<span class=title></span>` would generate span containing the title.
- optional string headerTemplate
- # HTML template for the print footer. Should use the same format as the `headerTemplate`.
- optional string footerTemplate
- # Whether or not to prefer page size as defined by css. Defaults to false,
- # in which case the content will be scaled to fit the paper size.
- optional boolean preferCSSPageSize
- # return as stream
- experimental optional enum transferMode
- ReturnAsBase64
- ReturnAsStream
- # Whether or not to generate tagged (accessible) PDF. Defaults to embedder choice.
- experimental optional boolean generateTaggedPDF
- # Whether or not to embed the document outline into the PDF.
- experimental optional boolean generateDocumentOutline
- returns
- # Base64-encoded pdf data. Empty if |returnAsStream| is specified.
- binary data
- # A handle of the stream that holds resulting PDF data.
- experimental optional IO.StreamHandle stream
-
- # Reloads given page optionally ignoring the cache.
- command reload
- parameters
- # If true, browser cache is ignored (as if the user pressed Shift+refresh).
- optional boolean ignoreCache
- # If set, the script will be injected into all frames of the inspected page after reload.
- # Argument will be ignored if reloading dataURL origin.
- optional string scriptToEvaluateOnLoad
- # If set, an error will be thrown if the target page's main frame's
- # loader id does not match the provided id. This prevents accidentally
- # reloading an unintended target in case there's a racing navigation.
- experimental optional Network.LoaderId loaderId
-
- # Deprecated, please use removeScriptToEvaluateOnNewDocument instead.
- experimental deprecated command removeScriptToEvaluateOnLoad
- parameters
- ScriptIdentifier identifier
-
- # Removes given script from the list.
- command removeScriptToEvaluateOnNewDocument
- parameters
- ScriptIdentifier identifier
-
- # Acknowledges that a screencast frame has been received by the frontend.
- experimental command screencastFrameAck
- parameters
- # Frame number.
- integer sessionId
-
- # Searches for given string in resource content.
- experimental command searchInResource
- parameters
- # Frame id for resource to search in.
- FrameId frameId
- # URL of the resource to search in.
- string url
- # 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 Debugger.SearchMatch result
-
- # Enable Chrome's experimental ad filter on all sites.
- experimental command setAdBlockingEnabled
- parameters
- # Whether to block ads.
- boolean enabled
-
- # Enable page Content Security Policy by-passing.
- command setBypassCSP
- parameters
- # Whether to bypass page CSP.
- boolean enabled
-
- # Get Permissions Policy state on given frame.
- experimental command getPermissionsPolicyState
- parameters
- FrameId frameId
- returns
- array of PermissionsPolicyFeatureState states
-
- # Get Origin Trials on given frame.
- experimental command getOriginTrials
- parameters
- FrameId frameId
- returns
- array of OriginTrial originTrials
-
- # Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
- # window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
- # query results).
- experimental deprecated command setDeviceMetricsOverride
- # Use 'Emulation.setDeviceMetricsOverride' instead
- redirect Emulation
- parameters
- # Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
- integer width
- # Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
- integer height
- # Overriding device scale factor value. 0 disables the override.
- number deviceScaleFactor
- # Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
- # autosizing and more.
- boolean mobile
- # Scale to apply to resulting view image.
- optional number scale
- # Overriding screen width value in pixels (minimum 0, maximum 10000000).
- optional integer screenWidth
- # Overriding screen height value in pixels (minimum 0, maximum 10000000).
- optional integer screenHeight
- # Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
- optional integer positionX
- # Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
- optional integer positionY
- # Do not set visible view size, rely upon explicit setVisibleSize call.
- optional boolean dontSetVisibleSize
- # Screen orientation override.
- optional Emulation.ScreenOrientation screenOrientation
- # The viewport dimensions and scale. If not set, the override is cleared.
- optional Viewport viewport
-
- # Overrides the Device Orientation.
- experimental deprecated command setDeviceOrientationOverride
- # Use 'DeviceOrientation.setDeviceOrientationOverride' instead
- redirect DeviceOrientation
- parameters
- # Mock alpha
- number alpha
- # Mock beta
- number beta
- # Mock gamma
- number gamma
-
- # Set generic font families.
- experimental command setFontFamilies
- parameters
- # Specifies font families to set. If a font family is not specified, it won't be changed.
- FontFamilies fontFamilies
- # Specifies font families to set for individual scripts.
- optional array of ScriptFontFamilies forScripts
-
- # Set default font sizes.
- experimental command setFontSizes
- parameters
- # Specifies font sizes to set. If a font size is not specified, it won't be changed.
- FontSizes fontSizes
-
- # Sets given markup as the document's HTML.
- command setDocumentContent
- parameters
- # Frame id to set HTML for.
- FrameId frameId
- # HTML content to set.
- string html
-
- # Set the behavior when downloading a file.
- experimental deprecated command setDownloadBehavior
- parameters
- # Whether to allow all or deny all download requests, or use default Chrome behavior if
- # available (otherwise deny).
- enum behavior
- deny
- allow
- default
- # The default path to save downloaded files to. This is required if behavior is set to 'allow'
- optional string downloadPath
-
- # Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
- # unavailable.
- deprecated command setGeolocationOverride
- # Use 'Emulation.setGeolocationOverride' instead
- redirect Emulation
- parameters
- # Mock latitude
- optional number latitude
- # Mock longitude
- optional number longitude
- # Mock accuracy
- optional number accuracy
-
- # Controls whether page will emit lifecycle events.
- command setLifecycleEventsEnabled
- parameters
- # If true, starts emitting lifecycle events.
- boolean enabled
-
- # Toggles mouse event-based touch event emulation.
- experimental deprecated command setTouchEmulationEnabled
- # Use 'Emulation.setTouchEmulationEnabled' instead
- redirect Emulation
- parameters
- # Whether the touch event emulation should be enabled.
- boolean enabled
- # Touch/gesture events configuration. Default: current platform.
- optional enum configuration
- mobile
- desktop
-
- # Starts sending each frame using the `screencastFrame` event.
- experimental command startScreencast
- parameters
- # Image compression format.
- optional enum format
- jpeg
- png
- # Compression quality from range [0..100].
- optional integer quality
- # Maximum screenshot width.
- optional integer maxWidth
- # Maximum screenshot height.
- optional integer maxHeight
- # Send every n-th frame.
- optional integer everyNthFrame
-
- # Force the page stop all navigations and pending resource fetches.
- command stopLoading
-
- # Crashes renderer on the IO thread, generates minidumps.
- experimental command crash
-
- # Tries to close page, running its beforeunload hooks, if any.
- command close
-
- # Tries to update the web lifecycle state of the page.
- # It will transition the page to the given state according to:
- # https://github.com/WICG/web-lifecycle/
- experimental command setWebLifecycleState
- parameters
- # Target lifecycle state
- enum state
- frozen
- active
-
- # Stops sending each frame in the `screencastFrame`.
- experimental command stopScreencast
-
- # Requests backend to produce compilation cache for the specified scripts.
- # `scripts` are appended to the list of scripts for which the cache
- # would be produced. The list may be reset during page navigation.
- # When script with a matching URL is encountered, the cache is optionally
- # produced upon backend discretion, based on internal heuristics.
- # See also: `Page.compilationCacheProduced`.
- experimental command produceCompilationCache
- parameters
- array of CompilationCacheParams scripts
-
- # Seeds compilation cache for given url. Compilation cache does not survive
- # cross-process navigation.
- experimental command addCompilationCache
- parameters
- string url
- # Base64-encoded data
- binary data
-
- # Clears seeded compilation cache.
- experimental command clearCompilationCache
-
- # Sets the Secure Payment Confirmation transaction mode.
- # https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
- experimental command setSPCTransactionMode
- parameters
- enum mode
- none
- autoAccept
- autoChooseToAuthAnotherWay
- autoReject
- autoOptOut
-
- # Extensions for Custom Handlers API:
- # https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
- experimental command setRPHRegistrationMode
- parameters
- enum mode
- none
- autoAccept
- autoReject
-
- # Generates a report for testing.
- experimental command generateTestReport
- parameters
- # Message to be displayed in the report.
- string message
- # Specifies the endpoint group to deliver the report to.
- optional string group
-
- # Pauses page execution. Can be resumed using generic Runtime.runIfWaitingForDebugger.
- experimental command waitForDebugger
-
- # Intercept file chooser requests and transfer control to protocol clients.
- # When file chooser interception is enabled, native file chooser dialog is not shown.
- # Instead, a protocol event `Page.fileChooserOpened` is emitted.
- command setInterceptFileChooserDialog
- parameters
- boolean enabled
- # If true, cancels the dialog by emitting relevant events (if any)
- # in addition to not showing it if the interception is enabled
- # (default: false).
- experimental optional boolean cancel
-
- event domContentEventFired
- parameters
- Network.MonotonicTime timestamp
-
- # Emitted only when `page.interceptFileChooser` is enabled.
- event fileChooserOpened
- parameters
- # Id of the frame containing input node.
- experimental FrameId frameId
- # Input mode.
- enum mode
- selectSingle
- selectMultiple
- # Input node id. Only present for file choosers opened via an `<input type="file">` element.
- experimental optional DOM.BackendNodeId backendNodeId
-
- # Fired when frame has been attached to its parent.
- event frameAttached
- parameters
- # Id of the frame that has been attached.
- FrameId frameId
- # Parent frame identifier.
- FrameId parentFrameId
- # JavaScript stack trace of when frame was attached, only set if frame initiated from script.
- optional Runtime.StackTrace stack
-
- # Fired when frame no longer has a scheduled navigation.
- deprecated event frameClearedScheduledNavigation
- parameters
- # Id of the frame that has cleared its scheduled navigation.
- FrameId frameId
-
- # Fired when frame has been detached from its parent.
- event frameDetached
- parameters
- # Id of the frame that has been detached.
- FrameId frameId
- experimental enum reason
- # The frame is removed from the DOM.
- remove
- # The frame is being swapped out in favor of an out-of-process iframe.
- # A new frame target will be created (see Target.attachedToTarget).
- swap
-
- # Fired before frame subtree is detached. Emitted before any frame of the
- # subtree is actually detached.
- experimental event frameSubtreeWillBeDetached
- parameters
- # Id of the frame that is the root of the subtree that will be detached.
- FrameId frameId
-
- # The type of a frameNavigated event.
- experimental type NavigationType extends string
- enum
- Navigation
- BackForwardCacheRestore
-
- # Fired once navigation of the frame has completed. Frame is now associated with the new loader.
- event frameNavigated
- parameters
- # Frame object.
- Frame frame
- experimental NavigationType type
-
- # Fired when opening document to write to.
- experimental event documentOpened
- parameters
- # Frame object.
- Frame frame
-
- experimental event frameResized
-
- # Fired when a navigation starts. This event is fired for both
- # renderer-initiated and browser-initiated navigations. For renderer-initiated
- # navigations, the event is fired after `frameRequestedNavigation`.
- # Navigation may still be cancelled after the event is issued. Multiple events
- # can be fired for a single navigation, for example, when a same-document
- # navigation becomes a cross-document navigation (such as in the case of a
- # frameset).
- experimental event frameStartedNavigating
- parameters
- # ID of the frame that is being navigated.
- FrameId frameId
- # The URL the navigation started with. The final URL can be different.
- string url
- # Loader identifier. Even though it is present in case of same-document
- # navigation, the previously committed loaderId would not change unless
- # the navigation changes from a same-document to a cross-document
- # navigation.
- Network.LoaderId loaderId
- enum navigationType
- reload
- reloadBypassingCache
- restore
- restoreWithPost
- historySameDocument
- historyDifferentDocument
- sameDocument
- differentDocument
-
- # Fired when a renderer-initiated navigation is requested.
- # Navigation may still be cancelled after the event is issued.
- experimental event frameRequestedNavigation
- parameters
- # Id of the frame that is being navigated.
- FrameId frameId
- # The reason for the navigation.
- ClientNavigationReason reason
- # The destination URL for the requested navigation.
- string url
- # The disposition for the navigation.
- ClientNavigationDisposition disposition
-
- # Fired when frame schedules a potential navigation.
- deprecated event frameScheduledNavigation
- parameters
- # Id of the frame that has scheduled a navigation.
- FrameId frameId
- # Delay (in seconds) until the navigation is scheduled to begin. The navigation is not
- # guaranteed to start.
- number delay
- # The reason for the navigation.
- ClientNavigationReason reason
- # The destination URL for the scheduled navigation.
- string url
-
- # Fired when frame has started loading.
- experimental event frameStartedLoading
- parameters
- # Id of the frame that has started loading.
- FrameId frameId
-
- # Fired when frame has stopped loading.
- experimental event frameStoppedLoading
- parameters
- # Id of the frame that has stopped loading.
- FrameId frameId
-
- # Fired when page is about to start a download.
- # Deprecated. Use Browser.downloadWillBegin instead.
- experimental deprecated event downloadWillBegin
- parameters
- # Id of the frame that caused download to begin.
- FrameId frameId
- # Global unique identifier of the download.
- string guid
- # URL of the resource being downloaded.
- string url
- # Suggested file name of the resource (the actual name of the file saved on disk may differ).
- string suggestedFilename
-
- # Fired when download makes progress. Last call has |done| == true.
- # Deprecated. Use Browser.downloadProgress instead.
- experimental deprecated event downloadProgress
- parameters
- # Global unique identifier of the download.
- string guid
- # Total expected bytes to download.
- number totalBytes
- # Total bytes received.
- number receivedBytes
- # Download status.
- enum state
- inProgress
- completed
- canceled
-
- # Fired when interstitial page was hidden
- event interstitialHidden
-
- # Fired when interstitial page was shown
- event interstitialShown
-
- # Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) has been
- # closed.
- event javascriptDialogClosed
- parameters
- # Frame id.
- experimental FrameId frameId
- # Whether dialog was confirmed.
- boolean result
- # User input in case of prompt.
- string userInput
-
- # Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) is about to
- # open.
- event javascriptDialogOpening
- parameters
- # Frame url.
- string url
- # Frame id.
- experimental FrameId frameId
- # Message that will be displayed by the dialog.
- string message
- # Dialog type.
- DialogType type
- # True iff browser is capable showing or acting on the given dialog. When browser has no
- # dialog handler for given target, calling alert while Page domain is engaged will stall
- # the page execution. Execution can be resumed via calling Page.handleJavaScriptDialog.
- boolean hasBrowserHandler
- # Default dialog prompt.
- optional string defaultPrompt
-
- # Fired for lifecycle events (navigation, load, paint, etc) in the current
- # target (including local frames).
- event lifecycleEvent
- parameters
- # Id of the frame.
- FrameId frameId
- # Loader identifier. Empty string if the request is fetched from worker.
- Network.LoaderId loaderId
- string name
- Network.MonotonicTime timestamp
-
- # List of not restored reasons for back-forward cache.
- experimental type BackForwardCacheNotRestoredReason extends string
- enum
- NotPrimaryMainFrame
- BackForwardCacheDisabled
- RelatedActiveContentsExist
- HTTPStatusNotOK
- SchemeNotHTTPOrHTTPS
- Loading
- WasGrantedMediaAccess
- DisableForRenderFrameHostCalled
- DomainNotAllowed
- HTTPMethodNotGET
- SubframeIsNavigating
- Timeout
- CacheLimit
- JavaScriptExecution
- RendererProcessKilled
- RendererProcessCrashed
- SchedulerTrackedFeatureUsed
- ConflictingBrowsingInstance
- CacheFlushed
- ServiceWorkerVersionActivation
- SessionRestored
- ServiceWorkerPostMessage
- EnteredBackForwardCacheBeforeServiceWorkerHostAdded
- RenderFrameHostReused_SameSite
- RenderFrameHostReused_CrossSite
- ServiceWorkerClaim
- IgnoreEventAndEvict
- HaveInnerContents
- TimeoutPuttingInCache
- BackForwardCacheDisabledByLowMemory
- BackForwardCacheDisabledByCommandLine
- NetworkRequestDatapipeDrainedAsBytesConsumer
- NetworkRequestRedirected
- NetworkRequestTimeout
- NetworkExceedsBufferLimit
- NavigationCancelledWhileRestoring
- NotMostRecentNavigationEntry
- BackForwardCacheDisabledForPrerender
- UserAgentOverrideDiffers
- ForegroundCacheLimit
- BrowsingInstanceNotSwapped
- BackForwardCacheDisabledForDelegate
- UnloadHandlerExistsInMainFrame
- UnloadHandlerExistsInSubFrame
- ServiceWorkerUnregistration
- CacheControlNoStore
- CacheControlNoStoreCookieModified
- CacheControlNoStoreHTTPOnlyCookieModified
- NoResponseHead
- Unknown
- ActivationNavigationsDisallowedForBug1234857
- ErrorDocument
- FencedFramesEmbedder
- CookieDisabled
- HTTPAuthRequired
- CookieFlushed
- BroadcastChannelOnMessage
- WebViewSettingsChanged
- WebViewJavaScriptObjectChanged
- WebViewMessageListenerInjected
- WebViewSafeBrowsingAllowlistChanged
- WebViewDocumentStartJavascriptChanged
- #Blocklisted features
- WebSocket
- WebTransport
- WebRTC
- MainResourceHasCacheControlNoStore
- MainResourceHasCacheControlNoCache
- SubresourceHasCacheControlNoStore
- SubresourceHasCacheControlNoCache
- ContainsPlugins
- DocumentLoaded
- OutstandingNetworkRequestOthers
- RequestedMIDIPermission
- RequestedAudioCapturePermission
- RequestedVideoCapturePermission
- RequestedBackForwardCacheBlockedSensors
- RequestedBackgroundWorkPermission
- BroadcastChannel
- WebXR
- SharedWorker
- SharedWorkerMessage
- WebLocks
- WebHID
- WebShare
- RequestedStorageAccessGrant
- WebNfc
- OutstandingNetworkRequestFetch
- OutstandingNetworkRequestXHR
- AppBanner
- Printing
- WebDatabase
- PictureInPicture
- SpeechRecognizer
- IdleManager
- PaymentManager
- SpeechSynthesis
- KeyboardLock
- WebOTPService
- OutstandingNetworkRequestDirectSocket
- InjectedJavascript
- InjectedStyleSheet
- KeepaliveRequest
- IndexedDBEvent
- Dummy
- JsNetworkRequestReceivedCacheControlNoStoreResource
- WebRTCSticky
- WebTransportSticky
- WebSocketSticky
- SmartCard
- LiveMediaStreamTrack
- UnloadHandler
- ParserAborted
- # Disabled for RenderFrameHost reasons
- # See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
- ContentSecurityHandler
- ContentWebAuthenticationAPI
- ContentFileChooser
- ContentSerial
- ContentFileSystemAccess
- ContentMediaDevicesDispatcherHost
- ContentWebBluetooth
- ContentWebUSB
- ContentMediaSessionService
- ContentScreenReader
- ContentDiscarded
-
- # See components/back_forward_cache/back_forward_cache_disable.h for explanations.
- EmbedderPopupBlockerTabHelper
- EmbedderSafeBrowsingTriggeredPopupBlocker
- EmbedderSafeBrowsingThreatDetails
- EmbedderAppBannerManager
- EmbedderDomDistillerViewerSource
- EmbedderDomDistillerSelfDeletingRequestDelegate
- EmbedderOomInterventionTabHelper
- EmbedderOfflinePage
- EmbedderChromePasswordManagerClientBindCredentialManager
- EmbedderPermissionRequestManager
- EmbedderModalDialog
- EmbedderExtensions
- EmbedderExtensionMessaging
- EmbedderExtensionMessagingForOpenPort
- EmbedderExtensionSentMessageToCachedFrame
- RequestedByWebViewClient
- PostMessageByWebViewClient
- CacheControlNoStoreDeviceBoundSessionTerminated
- CacheLimitPrunedOnModerateMemoryPressure
- CacheLimitPrunedOnCriticalMemoryPressure
-
- # Types of not restored reasons for back-forward cache.
- experimental type BackForwardCacheNotRestoredReasonType extends string
- enum
- SupportPending
- PageSupportNeeded
- Circumstantial
-
- experimental type BackForwardCacheBlockingDetails extends object
- properties
- # Url of the file where blockage happened. Optional because of tests.
- optional string url
- # Function name where blockage happened. Optional because of anonymous functions and tests.
- optional string function
- # Line number in the script (0-based).
- integer lineNumber
- # Column number in the script (0-based).
- integer columnNumber
-
- experimental type BackForwardCacheNotRestoredExplanation extends object
- properties
- # Type of the reason
- BackForwardCacheNotRestoredReasonType type
- # Not restored reason
- BackForwardCacheNotRestoredReason reason
- # Context associated with the reason. The meaning of this context is
- # dependent on the reason:
- # - EmbedderExtensionSentMessageToCachedFrame: the extension ID.
- #
- optional string context
- optional array of BackForwardCacheBlockingDetails details
-
- experimental type BackForwardCacheNotRestoredExplanationTree extends object
- properties
- # URL of each frame
- string url
- # Not restored reasons of each frame
- array of BackForwardCacheNotRestoredExplanation explanations
- # Array of children frame
- array of BackForwardCacheNotRestoredExplanationTree children
-
- # 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.
- experimental event backForwardCacheNotUsed
- parameters
- # The loader id for the associated navigation.
- Network.LoaderId loaderId
- # The frame id of the associated frame.
- FrameId frameId
- # Array of reasons why the page could not be cached. This must not be empty.
- array of BackForwardCacheNotRestoredExplanation notRestoredExplanations
- # Tree structure of reasons why the page could not be cached for each frame.
- optional BackForwardCacheNotRestoredExplanationTree notRestoredExplanationsTree
-
- event loadEventFired
- parameters
- Network.MonotonicTime timestamp
-
- # Fired when same-document navigation happens, e.g. due to history API usage or anchor navigation.
- experimental event navigatedWithinDocument
- parameters
- # Id of the frame.
- FrameId frameId
- # Frame's new url.
- string url
- # Navigation type
- enum navigationType
- # Navigation due to fragment navigation.
- fragment
- # Navigation due to history API usage.
- historyApi
- # Navigation due to other reasons.
- other
-
-
- # Compressed image data requested by the `startScreencast`.
- experimental event screencastFrame
- parameters
- # Base64-encoded compressed image.
- binary data
- # Screencast frame metadata.
- ScreencastFrameMetadata metadata
- # Frame number.
- integer sessionId
-
- # Fired when the page with currently enabled screencast was shown or hidden `.
- experimental event screencastVisibilityChanged
- parameters
- # True if the page is visible.
- boolean visible
-
- # Fired when a new window is going to be opened, via window.open(), link click, form submission,
- # etc.
- event windowOpen
- parameters
- # The URL for the new window.
- string url
- # Window name.
- string windowName
- # An array of enabled window features.
- array of string windowFeatures
- # Whether or not it was triggered by user gesture.
- boolean userGesture
-
- # Issued for every compilation cache generated.
- experimental event compilationCacheProduced
- parameters
- string url
- # Base64-encoded data
- binary data
-
- # Enable/disable prerendering manually.
- #
- # This command is a short-term solution for https://crbug.com/1440085.
- # See https://docs.google.com/document/d/12HVmFxYj5Jc-eJr5OmWsa2bqTJsbgGLKI6ZIyx0_wpA
- # for more details.
- #
- # TODO(https://crbug.com/1440085): Remove this once Puppeteer supports tab targets.
- experimental command setPrerenderingAllowed
- parameters
- boolean isAllowed
-
-domain Performance
-
- # Run-time execution metric.
- type Metric extends object
- properties
- # Metric name.
- string name
- # Metric value.
- number value
-
- # Disable collecting and reporting metrics.
- command disable
-
- # Enable collecting and reporting metrics.
- command enable
- parameters
- # Time domain to use for collecting and reporting duration metrics.
- optional enum timeDomain
- # Use monotonically increasing abstract time (default).
- timeTicks
- # Use thread running time.
- threadTicks
-
- # Sets time domain to use for collecting and reporting duration metrics.
- # Note that this must be called before enabling metrics collection. Calling
- # this method while metrics collection is enabled returns an error.
- experimental deprecated command setTimeDomain
- parameters
- # Time domain
- enum timeDomain
- # Use monotonically increasing abstract time (default).
- timeTicks
- # Use thread running time.
- threadTicks
-
- # Retrieve current values of run-time metrics.
- command getMetrics
- returns
- # Current values for run-time metrics.
- array of Metric metrics
-
- # Current values of the metrics.
- event metrics
- parameters
- # Current values of the metrics.
- array of Metric metrics
- # Timestamp title.
- string title
-
-# Reporting of performance timeline events, as specified in
-# https://w3c.github.io/performance-timeline/#dom-performanceobserver.
-experimental domain PerformanceTimeline
- depends on DOM
- depends on Network
-
- # See https://github.com/WICG/LargestContentfulPaint and largest_contentful_paint.idl
- type LargestContentfulPaint extends object
- properties
- Network.TimeSinceEpoch renderTime
- Network.TimeSinceEpoch loadTime
- # The number of pixels being painted.
- number size
- # The id attribute of the element, if available.
- optional string elementId
- # The URL of the image (may be trimmed).
- optional string url
- optional DOM.BackendNodeId nodeId
-
- type LayoutShiftAttribution extends object
- properties
- DOM.Rect previousRect
- DOM.Rect currentRect
- optional DOM.BackendNodeId nodeId
-
- # See https://wicg.github.io/layout-instability/#sec-layout-shift and layout_shift.idl
- type LayoutShift extends object
- properties
- # Score increment produced by this event.
- number value
- boolean hadRecentInput
- Network.TimeSinceEpoch lastInputTime
- array of LayoutShiftAttribution sources
-
- type TimelineEvent extends object
- properties
- # Identifies the frame that this event is related to. Empty for non-frame targets.
- Page.FrameId frameId
- # The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
- # This determines which of the optional "details" fields is present.
- string type
- # Name may be empty depending on the type.
- string name
- # Time in seconds since Epoch, monotonically increasing within document lifetime.
- Network.TimeSinceEpoch time
- # Event duration, if applicable.
- optional number duration
- optional LargestContentfulPaint lcpDetails
- optional LayoutShift layoutShiftDetails
-
- # Previously buffered events would be reported before method returns.
- # See also: timelineEventAdded
- command enable
- parameters
- # The types of event to report, as specified in
- # https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
- # The specified filter overrides any previous filters, passing empty
- # filter disables recording.
- # Note that not all types exposed to the web platform are currently supported.
- array of string eventTypes
-
- # Sent when a performance timeline event is added. See reportPerformanceTimeline method.
- event timelineEventAdded
- parameters
- TimelineEvent event
-
-# Security
-domain Security
-
- # An internal certificate ID value.
- type CertificateId extends integer
-
- # A description of mixed content (HTTP resources on HTTPS pages), as defined by
- # https://www.w3.org/TR/mixed-content/#categories
- type MixedContentType extends string
- enum
- blockable
- optionally-blockable
- none
-
- # The security level of a page or resource.
- type SecurityState extends string
- enum
- unknown
- neutral
- insecure
- secure
- info
- insecure-broken
-
- # Details about the security state of the page certificate.
- experimental type CertificateSecurityState extends object
- properties
- # Protocol name (e.g. "TLS 1.2" or "QUIC").
- string protocol
- # Key Exchange used by the connection, or the empty string if not applicable.
- string keyExchange
- # (EC)DH group used by the connection, if applicable.
- optional string keyExchangeGroup
- # Cipher name.
- string cipher
- # TLS MAC. Note that AEAD ciphers do not have separate MACs.
- optional string mac
- # Page certificate.
- array of string certificate
- # Certificate subject name.
- string subjectName
- # Name of the issuing CA.
- string issuer
- # Certificate valid from date.
- Network.TimeSinceEpoch validFrom
- # Certificate valid to (expiration) date
- Network.TimeSinceEpoch validTo
- # The highest priority network error code, if the certificate has an error.
- optional string certificateNetworkError
- # True if the certificate uses a weak signature algorithm.
- boolean certificateHasWeakSignature
- # True if the certificate has a SHA1 signature in the chain.
- boolean certificateHasSha1Signature
- # True if modern SSL
- boolean modernSSL
- # True if the connection is using an obsolete SSL protocol.
- boolean obsoleteSslProtocol
- # True if the connection is using an obsolete SSL key exchange.
- boolean obsoleteSslKeyExchange
- # True if the connection is using an obsolete SSL cipher.
- boolean obsoleteSslCipher
- # True if the connection is using an obsolete SSL signature.
- boolean obsoleteSslSignature
-
- experimental type SafetyTipStatus extends string
- enum
- badReputation
- lookalike
-
- experimental type SafetyTipInfo extends object
- properties
- # Describes whether the page triggers any safety tips or reputation warnings. Default is unknown.
- SafetyTipStatus safetyTipStatus
- # The URL the safety tip suggested ("Did you mean?"). Only filled in for lookalike matches.
- optional string safeUrl
-
- # Security state information about the page.
- experimental type VisibleSecurityState extends object
- properties
- # The security level of the page.
- SecurityState securityState
- # Security state details about the page certificate.
- optional CertificateSecurityState certificateSecurityState
- # The type of Safety Tip triggered on the page. Note that this field will be set even if the Safety Tip UI was not actually shown.
- optional SafetyTipInfo safetyTipInfo
- # Array of security state issues ids.
- array of string securityStateIssueIds
-
- # An explanation of an factor contributing to the security state.
- type SecurityStateExplanation extends object
- properties
- # Security state representing the severity of the factor being explained.
- SecurityState securityState
- # Title describing the type of factor.
- string title
- # Short phrase describing the type of factor.
- string summary
- # Full text explanation of the factor.
- string description
- # The type of mixed content described by the explanation.
- MixedContentType mixedContentType
- # Page certificate.
- array of string certificate
- # Recommendations to fix any issues.
- optional array of string recommendations
-
- # Information about insecure content on the page.
- deprecated type InsecureContentStatus extends object
- properties
- # Always false.
- boolean ranMixedContent
- # Always false.
- boolean displayedMixedContent
- # Always false.
- boolean containedMixedForm
- # Always false.
- boolean ranContentWithCertErrors
- # Always false.
- boolean displayedContentWithCertErrors
- # Always set to unknown.
- SecurityState ranInsecureContentStyle
- # Always set to unknown.
- SecurityState displayedInsecureContentStyle
-
- # The action to take when a certificate error occurs. continue will continue processing the
- # request and cancel will cancel the request.
- type CertificateErrorAction extends string
- enum
- continue
- cancel
-
- # Disables tracking security state changes.
- command disable
-
- # Enables tracking security state changes.
- command enable
-
- # Enable/disable whether all certificate errors should be ignored.
- command setIgnoreCertificateErrors
- parameters
- # If true, all certificate errors will be ignored.
- boolean ignore
-
- # Handles a certificate error that fired a certificateError event.
- deprecated command handleCertificateError
- parameters
- # The ID of the event.
- integer eventId
- # The action to take on the certificate error.
- CertificateErrorAction action
-
- # Enable/disable overriding certificate errors. If enabled, all certificate error events need to
- # be handled by the DevTools client and should be answered with `handleCertificateError` commands.
- deprecated command setOverrideCertificateErrors
- parameters
- # If true, certificate errors will be overridden.
- boolean override
-
- # 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.
- deprecated event certificateError
- parameters
- # The ID of the event.
- integer eventId
- # The type of the error.
- string errorType
- # The url that was requested.
- string requestURL
-
- # The security state of the page changed.
- experimental event visibleSecurityStateChanged
- parameters
- # Security state information about the page.
- VisibleSecurityState visibleSecurityState
-
- # The security state of the page changed. No longer being sent.
- deprecated event securityStateChanged
- parameters
- # Security state.
- SecurityState securityState
- # True if the page was loaded over cryptographic transport such as HTTPS.
- deprecated boolean schemeIsCryptographic
- # Previously a list of explanations for the security state. Now always
- # empty.
- deprecated array of SecurityStateExplanation explanations
- # Information about insecure content on the page.
- deprecated InsecureContentStatus insecureContentStatus
- # Overrides user-visible description of the state. Always omitted.
- deprecated optional string summary
-
-experimental domain ServiceWorker
- depends on Target
-
- type RegistrationID extends string
-
- # ServiceWorker registration.
- type ServiceWorkerRegistration extends object
- properties
- RegistrationID registrationId
- string scopeURL
- boolean isDeleted
-
- type ServiceWorkerVersionRunningStatus extends string
- enum
- stopped
- starting
- running
- stopping
-
- type ServiceWorkerVersionStatus extends string
- enum
- new
- installing
- installed
- activating
- activated
- redundant
-
- # ServiceWorker version.
- type ServiceWorkerVersion extends object
- properties
- string versionId
- RegistrationID registrationId
- string scriptURL
- ServiceWorkerVersionRunningStatus runningStatus
- ServiceWorkerVersionStatus status
- # The Last-Modified header value of the main script.
- optional number scriptLastModified
- # The time at which the response headers of the main script were received from the server.
- # For cached script it is the last time the cache entry was validated.
- optional number scriptResponseTime
- optional array of Target.TargetID controlledClients
- optional Target.TargetID targetId
- optional string routerRules
-
- # ServiceWorker error message.
- type ServiceWorkerErrorMessage extends object
- properties
- string errorMessage
- RegistrationID registrationId
- string versionId
- string sourceURL
- integer lineNumber
- integer columnNumber
-
- command deliverPushMessage
- parameters
- string origin
- RegistrationID registrationId
- string data
-
- command disable
-
- command dispatchSyncEvent
- parameters
- string origin
- RegistrationID registrationId
- string tag
- boolean lastChance
-
- command dispatchPeriodicSyncEvent
- parameters
- string origin
- RegistrationID registrationId
- string tag
-
- command enable
-
- command setForceUpdateOnPageLoad
- parameters
- boolean forceUpdateOnPageLoad
-
- command skipWaiting
- parameters
- string scopeURL
-
- command startWorker
- parameters
- string scopeURL
-
- command stopAllWorkers
-
- command stopWorker
- parameters
- string versionId
-
- command unregister
- parameters
- string scopeURL
-
- command updateRegistration
- parameters
- string scopeURL
-
- event workerErrorReported
- parameters
- ServiceWorkerErrorMessage errorMessage
-
- event workerRegistrationUpdated
- parameters
- array of ServiceWorkerRegistration registrations
-
- event workerVersionUpdated
- parameters
- array of ServiceWorkerVersion versions
-
-experimental domain Storage
- depends on Browser
- depends on Network
-
- type SerializedStorageKey extends string
-
- # Enum of possible storage types.
- type StorageType extends string
- enum
- cookies
- file_systems
- indexeddb
- local_storage
- shader_cache
- websql
- service_workers
- cache_storage
- interest_groups
- shared_storage
- storage_buckets
- all
- other
-
- # Usage for a storage type.
- type UsageForType extends object
- properties
- # Name of storage type.
- StorageType storageType
- # Storage usage (bytes).
- number usage
-
- # Pair of issuer origin and number of available (signed, but not used) Trust
- # Tokens from that issuer.
- experimental type TrustTokens extends object
- properties
- string issuerOrigin
- number count
-
- # Protected audience interest group auction identifier.
- type InterestGroupAuctionId extends string
-
- # Enum of interest group access types.
- type InterestGroupAccessType extends string
- enum
- join
- leave
- update
- loaded
- bid
- win
- additionalBid
- additionalBidWin
- topLevelBid
- topLevelAdditionalBid
- clear
-
- # Enum of auction events.
- type InterestGroupAuctionEventType extends string
- enum
- started
- configResolved
-
- # Enum of network fetches auctions can do.
- type InterestGroupAuctionFetchType extends string
- enum
- bidderJs
- bidderWasm
- sellerJs
- bidderTrustedSignals
- sellerTrustedSignals
-
- # Enum of shared storage access scopes.
- type SharedStorageAccessScope extends string
- enum
- window
- sharedStorageWorklet
- protectedAudienceWorklet
- header
-
- # Enum of shared storage access methods.
- type SharedStorageAccessMethod extends string
- enum
- addModule
- createWorklet
- selectURL
- run
- batchUpdate
- set
- append
- delete
- clear
- get
- keys
- values
- entries
- length
- remainingBudget
-
- # Struct for a single key-value pair in an origin's shared storage.
- type SharedStorageEntry extends object
- properties
- string key
- string value
-
- # Details for an origin's shared storage.
- type SharedStorageMetadata extends object
- properties
- # Time when the origin's shared storage was last created.
- Network.TimeSinceEpoch creationTime
- # Number of key-value pairs stored in origin's shared storage.
- integer length
- # Current amount of bits of entropy remaining in the navigation budget.
- number remainingBudget
- # Total number of bytes stored as key-value pairs in origin's shared
- # storage.
- integer bytesUsed
-
- # Represents a dictionary object passed in as privateAggregationConfig to
- # run or selectURL.
- type SharedStoragePrivateAggregationConfig extends object
- properties
- # The chosen aggregation service deployment.
- optional string aggregationCoordinatorOrigin
- # The context ID provided.
- optional string contextId
- # Configures the maximum size allowed for filtering IDs.
- integer filteringIdMaxBytes
- # The limit on the number of contributions in the final report.
- optional integer maxContributions
-
- # Pair of reporting metadata details for a candidate URL for `selectURL()`.
- type SharedStorageReportingMetadata extends object
- properties
- string eventType
- string reportingUrl
-
- # Bundles a candidate URL with its reporting metadata.
- type SharedStorageUrlWithMetadata extends object
- properties
- # Spec of candidate URL.
- string url
- # Any associated reporting metadata.
- array of SharedStorageReportingMetadata reportingMetadata
-
- # Bundles the parameters for shared storage access events whose
- # presence/absence can vary according to SharedStorageAccessType.
- type SharedStorageAccessParams extends object
- properties
- # Spec of the module script URL.
- # Present only for SharedStorageAccessMethods: addModule and
- # createWorklet.
- optional string scriptSourceUrl
- # String denoting "context-origin", "script-origin", or a custom
- # origin to be used as the worklet's data origin.
- # Present only for SharedStorageAccessMethod: createWorklet.
- optional string dataOrigin
- # Name of the registered operation to be run.
- # Present only for SharedStorageAccessMethods: run and selectURL.
- optional string operationName
- # ID of the operation call.
- # Present only for SharedStorageAccessMethods: run and selectURL.
- optional string operationId
- # Whether or not to keep the worket alive for future run or selectURL
- # calls.
- # Present only for SharedStorageAccessMethods: run and selectURL.
- optional boolean keepAlive
- # Configures the private aggregation options.
- # Present only for SharedStorageAccessMethods: run and selectURL.
- optional SharedStoragePrivateAggregationConfig privateAggregationConfig
- # The operation's serialized data in bytes (converted to a string).
- # Present only for SharedStorageAccessMethods: run and selectURL.
- # TODO(crbug.com/401011862): Consider updating this parameter to binary.
- optional string serializedData
- # Array of candidate URLs' specs, along with any associated metadata.
- # Present only for SharedStorageAccessMethod: selectURL.
- optional array of SharedStorageUrlWithMetadata urlsWithMetadata
- # Spec of the URN:UUID generated for a selectURL call.
- # Present only for SharedStorageAccessMethod: selectURL.
- optional string urnUuid
- # Key for a specific entry in an origin's shared storage.
- # Present only for SharedStorageAccessMethods: set, append, delete, and
- # get.
- optional string key
- # Value for a specific entry in an origin's shared storage.
- # Present only for SharedStorageAccessMethods: set and append.
- optional string value
- # Whether or not to set an entry for a key if that key is already present.
- # Present only for SharedStorageAccessMethod: set.
- optional boolean ignoreIfPresent
- # A number denoting the (0-based) order of the worklet's
- # creation relative to all other shared storage worklets created by
- # documents using the current storage partition.
- # Present only for SharedStorageAccessMethods: addModule, createWorklet.
- optional integer workletOrdinal
- # Hex representation of the DevTools token used as the TargetID for the
- # associated shared storage worklet.
- # Present only for SharedStorageAccessMethods: addModule, createWorklet,
- # run, selectURL, and any other SharedStorageAccessMethod when the
- # SharedStorageAccessScope is sharedStorageWorklet.
- optional Target.TargetID workletTargetId
- # Name of the lock to be acquired, if present.
- # Optionally present only for SharedStorageAccessMethods: batchUpdate,
- # set, append, delete, and clear.
- optional string withLock
- # If the method has been called as part of a batchUpdate, then this
- # number identifies the batch to which it belongs.
- # Optionally present only for SharedStorageAccessMethods:
- # batchUpdate (required), set, append, delete, and clear.
- optional string batchUpdateId
- # Number of modifier methods sent in batch.
- # Present only for SharedStorageAccessMethod: batchUpdate.
- optional integer batchSize
-
- type StorageBucketsDurability extends string
- enum
- relaxed
- strict
-
- type StorageBucket extends object
- properties
- SerializedStorageKey storageKey
- # If not specified, it is the default bucket of the storageKey.
- optional string name
-
- type StorageBucketInfo extends object
- properties
- StorageBucket bucket
- string id
- Network.TimeSinceEpoch expiration
- # Storage quota (bytes).
- number quota
- boolean persistent
- StorageBucketsDurability durability
-
- # Returns a storage key given a frame id.
- command getStorageKeyForFrame
- parameters
- Page.FrameId frameId
- returns
- SerializedStorageKey storageKey
-
- # Clears storage for origin.
- command clearDataForOrigin
- parameters
- # Security origin.
- string origin
- # Comma separated list of StorageType to clear.
- string storageTypes
-
- # Clears storage for storage key.
- command clearDataForStorageKey
- parameters
- # Storage key.
- string storageKey
- # Comma separated list of StorageType to clear.
- string storageTypes
-
- # Returns all browser cookies.
- command getCookies
- parameters
- # Browser context to use when called on the browser endpoint.
- optional Browser.BrowserContextID browserContextId
- returns
- # Array of cookie objects.
- array of Network.Cookie cookies
-
- # Sets given cookies.
- command setCookies
- parameters
- # Cookies to be set.
- array of Network.CookieParam cookies
- # Browser context to use when called on the browser endpoint.
- optional Browser.BrowserContextID browserContextId
-
- # Clears cookies.
- command clearCookies
- parameters
- # Browser context to use when called on the browser endpoint.
- optional Browser.BrowserContextID browserContextId
-
- # Returns usage and quota in bytes.
- command getUsageAndQuota
- parameters
- # Security origin.
- string origin
- returns
- # Storage usage (bytes).
- number usage
- # Storage quota (bytes).
- number quota
- # Whether or not the origin has an active storage quota override
- boolean overrideActive
- # Storage usage per type (bytes).
- array of UsageForType usageBreakdown
-
- # Override quota for the specified origin
- experimental command overrideQuotaForOrigin
- parameters
- # Security origin.
- string origin
- # The quota size (in bytes) to override the original quota with.
- # If this is called multiple times, the overridden quota will be equal to
- # the quotaSize provided in the final call. If this is called without
- # specifying a quotaSize, the quota will be reset to the default value for
- # the specified origin. If this is called multiple times with different
- # origins, the override will be maintained for each origin until it is
- # disabled (called without a quotaSize).
- optional number quotaSize
-
- # Registers origin to be notified when an update occurs to its cache storage list.
- command trackCacheStorageForOrigin
- parameters
- # Security origin.
- string origin
-
- # Registers storage key to be notified when an update occurs to its cache storage list.
- command trackCacheStorageForStorageKey
- parameters
- # Storage key.
- string storageKey
-
- # Registers origin to be notified when an update occurs to its IndexedDB.
- command trackIndexedDBForOrigin
- parameters
- # Security origin.
- string origin
-
- # Registers storage key to be notified when an update occurs to its IndexedDB.
- command trackIndexedDBForStorageKey
- parameters
- # Storage key.
- string storageKey
-
- # Unregisters origin from receiving notifications for cache storage.
- command untrackCacheStorageForOrigin
- parameters
- # Security origin.
- string origin
-
- # Unregisters storage key from receiving notifications for cache storage.
- command untrackCacheStorageForStorageKey
- parameters
- # Storage key.
- string storageKey
-
- # Unregisters origin from receiving notifications for IndexedDB.
- command untrackIndexedDBForOrigin
- parameters
- # Security origin.
- string origin
-
- # Unregisters storage key from receiving notifications for IndexedDB.
- command untrackIndexedDBForStorageKey
- parameters
- # Storage key.
- string storageKey
-
- # Returns the number of stored Trust Tokens per issuer for the
- # current browsing context.
- experimental command getTrustTokens
- returns
- array of TrustTokens tokens
-
- # Removes all Trust Tokens issued by the provided issuerOrigin.
- # Leaves other stored data, including the issuer's Redemption Records, intact.
- experimental command clearTrustTokens
- parameters
- string issuerOrigin
- returns
- # True if any tokens were deleted, false otherwise.
- boolean didDeleteTokens
-
- # Gets details for a named interest group.
- experimental command getInterestGroupDetails
- parameters
- string ownerOrigin
- string name
- returns
- # This largely corresponds to:
- # https://wicg.github.io/turtledove/#dictdef-generatebidinterestgroup
- # but has absolute expirationTime instead of relative lifetimeMs and
- # also adds joiningOrigin.
- object details
-
- # Enables/Disables issuing of interestGroupAccessed events.
- experimental command setInterestGroupTracking
- parameters
- boolean enable
-
- # Enables/Disables issuing of interestGroupAuctionEventOccurred and
- # interestGroupAuctionNetworkRequestCreated.
- experimental command setInterestGroupAuctionTracking
- parameters
- boolean enable
-
- # Gets metadata for an origin's shared storage.
- experimental command getSharedStorageMetadata
- parameters
- string ownerOrigin
- returns
- SharedStorageMetadata metadata
-
- # Gets the entries in an given origin's shared storage.
- experimental command getSharedStorageEntries
- parameters
- string ownerOrigin
- returns
- array of SharedStorageEntry entries
-
- # Sets entry with `key` and `value` for a given origin's shared storage.
- experimental command setSharedStorageEntry
- parameters
- string ownerOrigin
- string key
- string value
- # If `ignoreIfPresent` is included and true, then only sets the entry if
- # `key` doesn't already exist.
- optional boolean ignoreIfPresent
-
- # Deletes entry for `key` (if it exists) for a given origin's shared storage.
- experimental command deleteSharedStorageEntry
- parameters
- string ownerOrigin
- string key
-
- # Clears all entries for a given origin's shared storage.
- experimental command clearSharedStorageEntries
- parameters
- string ownerOrigin
-
- # Resets the budget for `ownerOrigin` by clearing all budget withdrawals.
- experimental command resetSharedStorageBudget
- parameters
- string ownerOrigin
-
- # Enables/disables issuing of sharedStorageAccessed events.
- experimental command setSharedStorageTracking
- parameters
- boolean enable
-
- # Set tracking for a storage key's buckets.
- experimental command setStorageBucketTracking
- parameters
- string storageKey
- boolean enable
-
- # Deletes the Storage Bucket with the given storage key and bucket name.
- experimental command deleteStorageBucket
- parameters
- StorageBucket bucket
-
- # Deletes state for sites identified as potential bounce trackers, immediately.
- experimental command runBounceTrackingMitigations
- returns
- array of string deletedSites
-
- # A cache's contents have been modified.
- event cacheStorageContentUpdated
- parameters
- # Origin to update.
- string origin
- # Storage key to update.
- string storageKey
- # Storage bucket to update.
- string bucketId
- # Name of cache in origin.
- string cacheName
-
- # A cache has been added/deleted.
- event cacheStorageListUpdated
- parameters
- # Origin to update.
- string origin
- # Storage key to update.
- string storageKey
- # Storage bucket to update.
- string bucketId
-
- # The origin's IndexedDB object store has been modified.
- event indexedDBContentUpdated
- parameters
- # Origin to update.
- string origin
- # Storage key to update.
- string storageKey
- # Storage bucket to update.
- string bucketId
- # Database to update.
- string databaseName
- # ObjectStore to update.
- string objectStoreName
-
- # The origin's IndexedDB database list has been modified.
- event indexedDBListUpdated
- parameters
- # Origin to update.
- string origin
- # Storage key to update.
- string storageKey
- # Storage bucket to update.
- string bucketId
-
- # One of the interest groups was accessed. Note that these events are global
- # to all targets sharing an interest group store.
- event interestGroupAccessed
- parameters
- Network.TimeSinceEpoch accessTime
- InterestGroupAccessType type
- string ownerOrigin
- string name
- # For topLevelBid/topLevelAdditionalBid, and when appropriate,
- # win and additionalBidWin
- optional string componentSellerOrigin
- # For bid or somethingBid event, if done locally and not on a server.
- optional number bid
- optional string bidCurrency
- # For non-global events --- links to interestGroupAuctionEvent
- optional InterestGroupAuctionId uniqueAuctionId
-
- # An auction involving interest groups is taking place. These events are
- # target-specific.
- event interestGroupAuctionEventOccurred
- parameters
- Network.TimeSinceEpoch eventTime
- InterestGroupAuctionEventType type
- InterestGroupAuctionId uniqueAuctionId
- # Set for child auctions.
- optional InterestGroupAuctionId parentAuctionId
- # Set for started and configResolved
- optional object auctionConfig
-
- # Specifies which auctions a particular network fetch may be related to, and
- # in what role. Note that it is not ordered with respect to
- # Network.requestWillBeSent (but will happen before loadingFinished
- # loadingFailed).
- event interestGroupAuctionNetworkRequestCreated
- parameters
- InterestGroupAuctionFetchType type
- Network.RequestId requestId
- # This is the set of the auctions using the worklet that issued this
- # request. In the case of trusted signals, it's possible that only some of
- # them actually care about the keys being queried.
- array of InterestGroupAuctionId auctions
-
- # Shared storage was accessed by the associated page.
- # The following parameters are included in all events.
- event sharedStorageAccessed
- parameters
- # Time of the access.
- Network.TimeSinceEpoch accessTime
- # Enum value indicating the access scope.
- SharedStorageAccessScope scope
- # Enum value indicating the Shared Storage API method invoked.
- SharedStorageAccessMethod method
- # DevTools Frame Token for the primary frame tree's root.
- Page.FrameId mainFrameId
- # Serialization of the origin owning the Shared Storage data.
- string ownerOrigin
- # Serialization of the site owning the Shared Storage data.
- string ownerSite
- # The sub-parameters wrapped by `params` are all optional and their
- # presence/absence depends on `type`.
- SharedStorageAccessParams params
-
- # A shared storage run or selectURL operation finished its execution.
- # The following parameters are included in all events.
- event sharedStorageWorkletOperationExecutionFinished
- parameters
- # Time that the operation finished.
- Network.TimeSinceEpoch finishedTime
- # Time, in microseconds, from start of shared storage JS API call until
- # end of operation execution in the worklet.
- integer executionTime
- # Enum value indicating the Shared Storage API method invoked.
- SharedStorageAccessMethod method
- # ID of the operation call.
- string operationId
- # Hex representation of the DevTools token used as the TargetID for the
- # associated shared storage worklet.
- Target.TargetID workletTargetId
- # DevTools Frame Token for the primary frame tree's root.
- Page.FrameId mainFrameId
- # Serialization of the origin owning the Shared Storage data.
- string ownerOrigin
-
- event storageBucketCreatedOrUpdated
- parameters
- StorageBucketInfo bucketInfo
-
- event storageBucketDeleted
- parameters
- string bucketId
-
- # https://wicg.github.io/attribution-reporting-api/
- experimental command setAttributionReportingLocalTestingMode
- parameters
- # If enabled, noise is suppressed and reports are sent immediately.
- boolean enabled
-
- # Enables/disables issuing of Attribution Reporting events.
- experimental command setAttributionReportingTracking
- parameters
- boolean enable
-
- # Sends all pending Attribution Reports immediately, regardless of their
- # scheduled report time.
- experimental command sendPendingAttributionReports
- returns
- # The number of reports that were sent.
- integer numSent
-
- experimental type AttributionReportingSourceType extends string
- enum
- navigation
- event
-
- experimental type UnsignedInt64AsBase10 extends string
- experimental type UnsignedInt128AsBase16 extends string
- experimental type SignedInt64AsBase10 extends string
-
- experimental type AttributionReportingFilterDataEntry extends object
- properties
- string key
- array of string values
-
- experimental type AttributionReportingFilterConfig extends object
- properties
- array of AttributionReportingFilterDataEntry filterValues
- # duration in seconds
- optional integer lookbackWindow
-
- experimental type AttributionReportingFilterPair extends object
- properties
- array of AttributionReportingFilterConfig filters
- array of AttributionReportingFilterConfig notFilters
-
- experimental type AttributionReportingAggregationKeysEntry extends object
- properties
- string key
- UnsignedInt128AsBase16 value
-
- experimental type AttributionReportingEventReportWindows extends object
- properties
- # duration in seconds
- integer start
- # duration in seconds
- array of integer ends
-
- experimental type AttributionReportingTriggerDataMatching extends string
- enum
- exact
- modulus
-
- experimental type AttributionReportingAggregatableDebugReportingData extends object
- properties
- UnsignedInt128AsBase16 keyPiece
- # number instead of integer because not all uint32 can be represented by
- # int
- number value
- array of string types
-
- experimental type AttributionReportingAggregatableDebugReportingConfig extends object
- properties
- # number instead of integer because not all uint32 can be represented by
- # int, only present for source registrations
- optional number budget
- UnsignedInt128AsBase16 keyPiece
- array of AttributionReportingAggregatableDebugReportingData debugData
- optional string aggregationCoordinatorOrigin
-
- experimental type AttributionScopesData extends object
- properties
- array of string values
- # number instead of integer because not all uint32 can be represented by
- # int
- number limit
- number maxEventStates
-
- experimental type AttributionReportingNamedBudgetDef extends object
- properties
- string name
- integer budget
-
- experimental type AttributionReportingSourceRegistration extends object
- properties
- Network.TimeSinceEpoch time
- # duration in seconds
- integer expiry
- # number instead of integer because not all uint32 can be represented by
- # int
- array of number triggerData
- AttributionReportingEventReportWindows eventReportWindows
- # duration in seconds
- integer aggregatableReportWindow
- AttributionReportingSourceType type
- string sourceOrigin
- string reportingOrigin
- array of string destinationSites
- UnsignedInt64AsBase10 eventId
- SignedInt64AsBase10 priority
- array of AttributionReportingFilterDataEntry filterData
- array of AttributionReportingAggregationKeysEntry aggregationKeys
- optional UnsignedInt64AsBase10 debugKey
- AttributionReportingTriggerDataMatching triggerDataMatching
- SignedInt64AsBase10 destinationLimitPriority
- AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
- optional AttributionScopesData scopesData
- integer maxEventLevelReports
- array of AttributionReportingNamedBudgetDef namedBudgets
- boolean debugReporting
- number eventLevelEpsilon
-
- experimental type AttributionReportingSourceRegistrationResult extends string
- enum
- success
- internalError
- insufficientSourceCapacity
- insufficientUniqueDestinationCapacity
- excessiveReportingOrigins
- prohibitedByBrowserPolicy
- successNoised
- destinationReportingLimitReached
- destinationGlobalLimitReached
- destinationBothLimitsReached
- reportingOriginsPerSiteLimitReached
- exceedsMaxChannelCapacity
- exceedsMaxScopesChannelCapacity
- exceedsMaxTriggerStateCardinality
- exceedsMaxEventStatesLimit
- destinationPerDayReportingLimitReached
-
- experimental event attributionReportingSourceRegistered
- parameters
- AttributionReportingSourceRegistration registration
- AttributionReportingSourceRegistrationResult result
-
- experimental type AttributionReportingSourceRegistrationTimeConfig extends string
- enum
- include
- exclude
-
- experimental type AttributionReportingAggregatableValueDictEntry extends object
- properties
- string key
- # number instead of integer because not all uint32 can be represented by
- # int
- number value
- UnsignedInt64AsBase10 filteringId
-
-
- experimental type AttributionReportingAggregatableValueEntry extends object
- properties
- array of AttributionReportingAggregatableValueDictEntry values
- AttributionReportingFilterPair filters
-
- experimental type AttributionReportingEventTriggerData extends object
- properties
- UnsignedInt64AsBase10 data
- SignedInt64AsBase10 priority
- optional UnsignedInt64AsBase10 dedupKey
- AttributionReportingFilterPair filters
-
- experimental type AttributionReportingAggregatableTriggerData extends object
- properties
- UnsignedInt128AsBase16 keyPiece
- array of string sourceKeys
- AttributionReportingFilterPair filters
-
- experimental type AttributionReportingAggregatableDedupKey extends object
- properties
- optional UnsignedInt64AsBase10 dedupKey
- AttributionReportingFilterPair filters
-
- experimental type AttributionReportingNamedBudgetCandidate extends object
- properties
- optional string name
- AttributionReportingFilterPair filters
-
- experimental type AttributionReportingTriggerRegistration extends object
- properties
- AttributionReportingFilterPair filters
- optional UnsignedInt64AsBase10 debugKey
- array of AttributionReportingAggregatableDedupKey aggregatableDedupKeys
- array of AttributionReportingEventTriggerData eventTriggerData
- array of AttributionReportingAggregatableTriggerData aggregatableTriggerData
- array of AttributionReportingAggregatableValueEntry aggregatableValues
- integer aggregatableFilteringIdMaxBytes
- boolean debugReporting
- optional string aggregationCoordinatorOrigin
- AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
- optional string triggerContextId
- AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
- array of string scopes
- array of AttributionReportingNamedBudgetCandidate namedBudgets
-
- experimental type AttributionReportingEventLevelResult extends string
- enum
- success
- successDroppedLowerPriority
- internalError
- noCapacityForAttributionDestination
- noMatchingSources
- deduplicated
- excessiveAttributions
- priorityTooLow
- neverAttributedSource
- excessiveReportingOrigins
- noMatchingSourceFilterData
- prohibitedByBrowserPolicy
- noMatchingConfigurations
- excessiveReports
- falselyAttributedSource
- reportWindowPassed
- notRegistered
- reportWindowNotStarted
- noMatchingTriggerData
-
- experimental type AttributionReportingAggregatableResult extends string
- enum
- success
- internalError
- noCapacityForAttributionDestination
- noMatchingSources
- excessiveAttributions
- excessiveReportingOrigins
- noHistograms
- insufficientBudget
- insufficientNamedBudget
- noMatchingSourceFilterData
- notRegistered
- prohibitedByBrowserPolicy
- deduplicated
- reportWindowPassed
- excessiveReports
-
- experimental event attributionReportingTriggerRegistered
- parameters
- AttributionReportingTriggerRegistration registration
- AttributionReportingEventLevelResult eventLevel
- AttributionReportingAggregatableResult aggregatable
-
- experimental type AttributionReportingReportResult extends string
- enum
- # A network request was attempted for the report.
- sent
- # No request was attempted because of browser policy.
- prohibited
- # No request was attempted because of an error in report assembly,
- # e.g. the aggregation service was unavailable.
- failedToAssemble
- # No request was attempted because the report's expiry passed.
- expired
-
- experimental event attributionReportingReportSent
- parameters
- string url
- object body
- AttributionReportingReportResult result
- # If result is `sent`, populated with net/HTTP status.
- optional integer netError
- optional string netErrorName
- optional integer httpStatusCode
-
- experimental event attributionReportingVerboseDebugReportSent
- parameters
- string url
- optional array of object body
- optional integer netError
- optional string netErrorName
- optional integer httpStatusCode
-
- # A single Related Website Set object.
- experimental type RelatedWebsiteSet extends object
- properties
- # The primary site of this set, along with the ccTLDs if there is any.
- array of string primarySites
- # The associated sites of this set, along with the ccTLDs if there is any.
- array of string associatedSites
- # The service sites of this set, along with the ccTLDs if there is any.
- array of string serviceSites
-
- # Returns the effective Related Website Sets in use by this profile for the browser
- # session. The effective Related Website Sets will not change during a browser session.
- experimental command getRelatedWebsiteSets
- returns
- array of RelatedWebsiteSet sets
-
- # Returns the list of URLs from a page and its embedded resources that match
- # existing grace period URL pattern rules.
- # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
- experimental command getAffectedUrlsForThirdPartyCookieMetadata
- parameters
- # The URL of the page currently being visited.
- string firstPartyUrl
- # The list of embedded resource URLs from the page.
- array of string thirdPartyUrls
-
- returns
- # Array of matching URLs. If there is a primary pattern match for the first-
- # party URL, only the first-party URL is returned in the array.
- array of string matchedUrls
-
- command setProtectedAudienceKAnonymity
- parameters
- string owner
- string name
- array of binary hashes
-
-# The SystemInfo domain defines methods and events for querying low-level system information.
-experimental domain SystemInfo
-
- # Describes a single graphics processor (GPU).
- type GPUDevice extends object
- properties
- # PCI ID of the GPU vendor, if available; 0 otherwise.
- number vendorId
- # PCI ID of the GPU device, if available; 0 otherwise.
- number deviceId
- # Sub sys ID of the GPU, only available on Windows.
- optional number subSysId
- # Revision of the GPU, only available on Windows.
- optional number revision
- # String description of the GPU vendor, if the PCI ID is not available.
- string vendorString
- # String description of the GPU device, if the PCI ID is not available.
- string deviceString
- # String description of the GPU driver vendor.
- string driverVendor
- # String description of the GPU driver version.
- string driverVersion
-
- # Describes the width and height dimensions of an entity.
- type Size extends object
- properties
- # Width in pixels.
- integer width
- # Height in pixels.
- integer height
-
- # Describes a supported video decoding profile with its associated minimum and
- # maximum resolutions.
- type VideoDecodeAcceleratorCapability extends object
- properties
- # Video codec profile that is supported, e.g. VP9 Profile 2.
- string profile
- # Maximum video dimensions in pixels supported for this |profile|.
- Size maxResolution
- # Minimum video dimensions in pixels supported for this |profile|.
- Size minResolution
-
- # Describes a supported video encoding profile with its associated maximum
- # resolution and maximum framerate.
- type VideoEncodeAcceleratorCapability extends object
- properties
- # Video codec profile that is supported, e.g H264 Main.
- string profile
- # Maximum video dimensions in pixels supported for this |profile|.
- Size maxResolution
- # Maximum encoding framerate in frames per second supported for this
- # |profile|, as fraction's numerator and denominator, e.g. 24/1 fps,
- # 24000/1001 fps, etc.
- integer maxFramerateNumerator
- integer maxFramerateDenominator
-
- # YUV subsampling type of the pixels of a given image.
- type SubsamplingFormat extends string
- enum
- yuv420
- yuv422
- yuv444
-
- # Image format of a given image.
- type ImageType extends string
- enum
- jpeg
- webp
- unknown
-
- # Describes a supported image decoding profile with its associated minimum and
- # maximum resolutions and subsampling.
- type ImageDecodeAcceleratorCapability extends object
- properties
- # Image coded, e.g. Jpeg.
- ImageType imageType
- # Maximum supported dimensions of the image in pixels.
- Size maxDimensions
- # Minimum supported dimensions of the image in pixels.
- Size minDimensions
- # Optional array of supported subsampling formats, e.g. 4:2:0, if known.
- array of SubsamplingFormat subsamplings
-
- # Provides information about the GPU(s) on the system.
- type GPUInfo extends object
- properties
- # The graphics devices on the system. Element 0 is the primary GPU.
- array of GPUDevice devices
- # An optional dictionary of additional GPU related attributes.
- optional object auxAttributes
- # An optional dictionary of graphics features and their status.
- optional object featureStatus
- # An optional array of GPU driver bug workarounds.
- array of string driverBugWorkarounds
- # Supported accelerated video decoding capabilities.
- array of VideoDecodeAcceleratorCapability videoDecoding
- # Supported accelerated video encoding capabilities.
- array of VideoEncodeAcceleratorCapability videoEncoding
- # Supported accelerated image decoding capabilities.
- array of ImageDecodeAcceleratorCapability imageDecoding
-
- # Represents process info.
- type ProcessInfo extends object
- properties
- # Specifies process type.
- string type
- # Specifies process id.
- integer id
- # Specifies cumulative CPU usage in seconds across all threads of the
- # process since the process start.
- number cpuTime
-
- # Returns information about the system.
- command getInfo
- returns
- # Information about the GPUs on the system.
- GPUInfo gpu
- # A platform-dependent description of the model of the machine. On Mac OS, this is, for
- # example, 'MacBookPro'. Will be the empty string if not supported.
- string modelName
- # A platform-dependent description of the version of the machine. On Mac OS, this is, for
- # example, '10.1'. Will be the empty string if not supported.
- string modelVersion
- # The command line string used to launch the browser. Will be the empty string if not
- # supported.
- string commandLine
-
- # Returns information about the feature state.
- command getFeatureState
- parameters
- string featureState
- returns
- boolean featureEnabled
-
- # Returns information about all running processes.
- command getProcessInfo
- returns
- # An array of process info blocks.
- array of ProcessInfo processInfo
-
-# Supports additional targets discovery and allows to attach to them.
-domain Target
-
- type TargetID extends string
-
- # Unique identifier of attached debugging session.
- type SessionID extends string
-
- type TargetInfo extends object
- properties
- TargetID targetId
- # List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22
- string type
- string title
- string url
- # Whether the target has an attached client.
- boolean attached
- # Opener target Id
- optional TargetID openerId
- # Whether the target has access to the originating window.
- experimental boolean canAccessOpener
- # Frame id of originating window (is only set if target has an opener).
- experimental optional Page.FrameId openerFrameId
- experimental optional Browser.BrowserContextID browserContextId
- # Provides additional details for specific target types. For example, for
- # the type of "page", this may be set to "prerender".
- experimental optional string subtype
-
- # A filter used by target query/discovery/auto-attach operations.
- experimental type FilterEntry extends object
- properties
- # If set, causes exclusion of matching targets from the list.
- optional boolean exclude
- # If not present, matches any type.
- optional string type
-
- # The entries in TargetFilter are matched sequentially against targets and
- # the first entry that matches determines if the target is included or not,
- # depending on the value of `exclude` field in the entry.
- # If filter is not specified, the one assumed is
- # [{type: "browser", exclude: true}, {type: "tab", exclude: true}, {}]
- # (i.e. include everything but `browser` and `tab`).
- experimental type TargetFilter extends array of FilterEntry
-
- experimental type RemoteLocation extends object
- properties
- string host
- integer port
-
- # The state of the target window.
- experimental type WindowState extends string
- enum
- normal
- minimized
- maximized
- fullscreen
-
- # Activates (focuses) the target.
- command activateTarget
- parameters
- TargetID targetId
-
- # Attaches to the target with given id.
- command attachToTarget
- parameters
- TargetID targetId
- # Enables "flat" access to the session via specifying sessionId attribute in the commands.
- # We plan to make this the default, deprecate non-flattened mode,
- # and eventually retire it. See crbug.com/991325.
- optional boolean flatten
- returns
- # Id assigned to the session.
- SessionID sessionId
-
- # Attaches to the browser target, only uses flat sessionId mode.
- experimental command attachToBrowserTarget
- returns
- # Id assigned to the session.
- SessionID sessionId
-
- # Closes the target. If the target is a page that gets closed too.
- command closeTarget
- parameters
- TargetID targetId
- returns
- # Always set to true. If an error occurs, the response indicates protocol error.
- deprecated boolean success
-
- # Inject object to the target's main frame that provides a communication
- # channel with browser target.
- #
- # Injected object will be available as `window[bindingName]`.
- #
- # The object has the following API:
- # - `binding.send(json)` - a method to send messages over the remote debugging protocol
- # - `binding.onmessage = json => handleMessage(json)` - a callback that will be called for the protocol notifications and command responses.
- experimental command exposeDevToolsProtocol
- parameters
- TargetID targetId
- # Binding name, 'cdp' if not specified.
- optional string bindingName
- # If true, inherits the current root session's permissions (default: false).
- optional boolean inheritPermissions
-
- # Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
- # one.
- command createBrowserContext
- parameters
- # If specified, disposes this context when debugging session disconnects.
- experimental optional boolean disposeOnDetach
- # Proxy server, similar to the one passed to --proxy-server
- experimental optional string proxyServer
- # Proxy bypass list, similar to the one passed to --proxy-bypass-list
- experimental optional string proxyBypassList
- # An optional list of origins to grant unlimited cross-origin access to.
- # Parts of the URL other than those constituting origin are ignored.
- experimental optional array of string originsWithUniversalNetworkAccess
- returns
- # The id of the context created.
- Browser.BrowserContextID browserContextId
-
- # Returns all browser contexts created with `Target.createBrowserContext` method.
- command getBrowserContexts
- returns
- # An array of browser context ids.
- array of Browser.BrowserContextID browserContextIds
-
- # Creates a new page.
- command createTarget
- parameters
- # The initial URL the page will be navigated to. An empty string indicates about:blank.
- string url
- # Frame left origin in DIP (requires newWindow to be true or headless shell).
- experimental optional integer left
- # Frame top origin in DIP (requires newWindow to be true or headless shell).
- experimental optional integer top
- # Frame width in DIP (requires newWindow to be true or headless shell).
- optional integer width
- # Frame height in DIP (requires newWindow to be true or headless shell).
- optional integer height
- # Frame window state (requires newWindow to be true or headless shell).
- # Default is normal.
- optional WindowState windowState
- # The browser context to create the page in.
- experimental optional Browser.BrowserContextID browserContextId
- # Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
- # not supported on MacOS yet, false by default).
- experimental optional boolean enableBeginFrameControl
- # Whether to create a new Window or Tab (false by default, not supported by headless shell).
- optional boolean newWindow
- # Whether to create the target in background or foreground (false by default, not supported
- # by headless shell).
- optional boolean background
- # Whether to create the target of type "tab".
- experimental optional boolean forTab
- # Whether to create a hidden target. The hidden target is observable via protocol, but not
- # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
- # `background: false`. The life-time of the tab is limited to the life-time of the session.
- experimental optional boolean hidden
- returns
- # The id of the page opened.
- TargetID targetId
-
- # Detaches session with given id.
- command detachFromTarget
- parameters
- # Session to detach.
- optional SessionID sessionId
- # Deprecated.
- deprecated optional TargetID targetId
-
- # Deletes a BrowserContext. All the belonging pages will be closed without calling their
- # beforeunload hooks.
- command disposeBrowserContext
- parameters
- Browser.BrowserContextID browserContextId
-
- # Returns information about a target.
- experimental command getTargetInfo
- parameters
- optional TargetID targetId
- returns
- TargetInfo targetInfo
-
- # Retrieves a list of available targets.
- command getTargets
- parameters
- # Only targets matching filter will be reported. If filter is not specified
- # and target discovery is currently enabled, a filter used for target discovery
- # is used for consistency.
- experimental optional TargetFilter filter
- returns
- # The list of targets.
- array of TargetInfo targetInfos
-
- # Sends protocol message over session with given id.
- # Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
- # and crbug.com/991325.
- deprecated command sendMessageToTarget
- parameters
- string message
- # Identifier of the session.
- optional SessionID sessionId
- # Deprecated.
- deprecated optional TargetID targetId
-
- # Controls whether to automatically attach to new targets which are considered
- # to be directly related to this one (for example, iframes or workers).
- # When turned on, attaches to all existing related targets as well. When turned off,
- # automatically detaches from all currently attached targets.
- # This also clears all targets added by `autoAttachRelated` from the list of targets to watch
- # for creation of related targets.
- # You might want to call this recursively for auto-attached targets to attach
- # to all available targets.
- command setAutoAttach
- parameters
- # Whether to auto-attach to related targets.
- boolean autoAttach
- # Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
- # to run paused targets.
- boolean waitForDebuggerOnStart
- # Enables "flat" access to the session via specifying sessionId attribute in the commands.
- # We plan to make this the default, deprecate non-flattened mode,
- # and eventually retire it. See crbug.com/991325.
- experimental optional boolean flatten
- # Only targets matching filter will be attached.
- experimental optional TargetFilter filter
-
- # Adds the specified target to the list of targets that will be monitored for any related target
- # creation (such as child frames, child workers and new versions of service worker) and reported
- # through `attachedToTarget`. The specified target is also auto-attached.
- # This cancels the effect of any previous `setAutoAttach` and is also cancelled by subsequent
- # `setAutoAttach`. Only available at the Browser target.
- experimental command autoAttachRelated
- parameters
- TargetID targetId
- # Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
- # to run paused targets.
- boolean waitForDebuggerOnStart
- # Only targets matching filter will be attached.
- experimental optional TargetFilter filter
-
- # Controls whether to discover available targets and notify via
- # `targetCreated/targetInfoChanged/targetDestroyed` events.
- command setDiscoverTargets
- parameters
- # Whether to discover available targets.
- boolean discover
- # Only targets matching filter will be attached. If `discover` is false,
- # `filter` must be omitted or empty.
- experimental optional TargetFilter filter
-
- # Enables target discovery for the specified locations, when `setDiscoverTargets` was set to
- # `true`.
- experimental command setRemoteLocations
- parameters
- # List of remote locations.
- array of RemoteLocation locations
-
- # Issued when attached to target because of auto-attach or `attachToTarget` command.
- experimental event attachedToTarget
- parameters
- # Identifier assigned to the session used to send/receive messages.
- SessionID sessionId
- TargetInfo targetInfo
- boolean waitingForDebugger
-
- # 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.
- experimental event detachedFromTarget
- parameters
- # Detached session identifier.
- SessionID sessionId
- # Deprecated.
- deprecated optional TargetID targetId
-
- # Notifies about a new protocol message received from the session (as reported in
- # `attachedToTarget` event).
- event receivedMessageFromTarget
- parameters
- # Identifier of a session which sends a message.
- SessionID sessionId
- string message
- # Deprecated.
- deprecated optional TargetID targetId
-
- # Issued when a possible inspection target is created.
- event targetCreated
- parameters
- TargetInfo targetInfo
-
- # Issued when a target is destroyed.
- event targetDestroyed
- parameters
- TargetID targetId
-
- # Issued when a target has crashed.
- event targetCrashed
- parameters
- TargetID targetId
- # Termination status type.
- string status
- # Termination error code.
- integer errorCode
-
- # Issued when some information about a target has changed. This only happens between
- # `targetCreated` and `targetDestroyed`.
- event targetInfoChanged
- parameters
- TargetInfo targetInfo
-
- # Opens a DevTools window for the target.
- experimental command openDevTools
- parameters
- # This can be the page or tab target ID.
- TargetID targetId
- returns
- # The targetId of DevTools page target.
- TargetID targetId
-
-# The Tethering domain defines methods and events for browser port binding.
-experimental domain Tethering
-
- # Request browser port binding.
- command bind
- parameters
- # Port number to bind.
- integer port
-
- # Request browser port unbinding.
- command unbind
- parameters
- # Port number to unbind.
- integer port
-
- # Informs that port was successfully bound and got a specified connection id.
- event accepted
- parameters
- # Port number that was successfully bound.
- integer port
- # Connection id to be used.
- string connectionId
-
-domain Tracing
- depends on IO
-
- # Configuration for memory dump. Used only when "memory-infra" category is enabled.
- experimental type MemoryDumpConfig extends object
-
- type TraceConfig extends object
- properties
- # Controls how the trace buffer stores data. The default is `recordUntilFull`.
- experimental optional enum recordMode
- recordUntilFull
- recordContinuously
- recordAsMuchAsPossible
- echoToConsole
- # Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value
- # of 200 MB would be used.
- experimental optional number traceBufferSizeInKb
- # Turns on JavaScript stack sampling.
- experimental optional boolean enableSampling
- # Turns on system tracing.
- experimental optional boolean enableSystrace
- # Turns on argument filter.
- experimental optional boolean enableArgumentFilter
- # Included category filters.
- optional array of string includedCategories
- # Excluded category filters.
- optional array of string excludedCategories
- # Configuration to synthesize the delays in tracing.
- experimental optional array of string syntheticDelays
- # Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
- experimental optional MemoryDumpConfig memoryDumpConfig
-
- # Data format of a trace. Can be either the legacy JSON format or the
- # protocol buffer format. Note that the JSON format will be deprecated soon.
- experimental type StreamFormat extends string
- enum
- json
- proto
-
- # Compression type to use for traces returned via streams.
- experimental type StreamCompression extends string
- enum
- none
- gzip
-
- # Details exposed when memory request explicitly declared.
- # Keep consistent with memory_dump_request_args.h and
- # memory_instrumentation.mojom
- experimental type MemoryDumpLevelOfDetail extends string
- enum
- background
- light
- detailed
-
- # Backend type to use for tracing. `chrome` uses the Chrome-integrated
- # tracing service and is supported on all platforms. `system` is only
- # supported on Chrome OS and uses the Perfetto system tracing service.
- # `auto` chooses `system` when the perfettoConfig provided to Tracing.start
- # specifies at least one non-Chrome data source; otherwise uses `chrome`.
- experimental type TracingBackend extends string
- enum
- auto
- chrome
- system
-
- # Stop trace events collection.
- command end
-
- # Gets supported tracing categories.
- experimental command getCategories
- returns
- # A list of supported tracing categories.
- array of string categories
-
- # Record a clock sync marker in the trace.
- experimental command recordClockSyncMarker
- parameters
- # The ID of this clock sync marker
- string syncId
-
- # Request a global memory dump.
- experimental command requestMemoryDump
- parameters
- # Enables more deterministic results by forcing garbage collection
- optional boolean deterministic
- # Specifies level of details in memory dump. Defaults to "detailed".
- optional MemoryDumpLevelOfDetail levelOfDetail
- returns
- # GUID of the resulting global memory dump.
- string dumpGuid
- # True iff the global memory dump succeeded.
- boolean success
-
- # Start trace events collection.
- command start
- parameters
- # Category/tag filter
- experimental deprecated optional string categories
- # Tracing options
- experimental deprecated optional string options
- # If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
- experimental optional number bufferUsageReportingInterval
- # Whether to report trace events as series of dataCollected events or to save trace to a
- # stream (defaults to `ReportEvents`).
- optional enum transferMode
- ReportEvents
- ReturnAsStream
- # Trace data format to use. This only applies when using `ReturnAsStream`
- # transfer mode (defaults to `json`).
- optional StreamFormat streamFormat
- # Compression format to use. This only applies when using `ReturnAsStream`
- # transfer mode (defaults to `none`)
- experimental optional StreamCompression streamCompression
- optional TraceConfig traceConfig
- # Base64-encoded serialized perfetto.protos.TraceConfig protobuf message
- # When specified, the parameters `categories`, `options`, `traceConfig`
- # are ignored.
- experimental optional binary perfettoConfig
- # Backend type (defaults to `auto`)
- experimental optional TracingBackend tracingBackend
-
- experimental event bufferUsage
- parameters
- # A number in range [0..1] that indicates the used size of event buffer as a fraction of its
- # total size.
- optional number percentFull
- # An approximate number of events in the trace log.
- optional number eventCount
- # A number in range [0..1] that indicates the used size of event buffer as a fraction of its
- # total size.
- optional number value
-
- # Contains a bucket of collected trace events. When tracing is stopped collected events will be
- # sent as a sequence of dataCollected events followed by tracingComplete event.
- experimental event dataCollected
- parameters
- array of object value
-
- # Signals that tracing is stopped and there is no trace buffers pending flush, all data were
- # delivered via dataCollected events.
- event tracingComplete
- parameters
- # Indicates whether some trace data is known to have been lost, e.g. because the trace ring
- # buffer wrapped around.
- boolean dataLossOccurred
- # A handle of the stream that holds resulting trace data.
- optional IO.StreamHandle stream
- # Trace data format of returned stream.
- optional StreamFormat traceFormat
- # Compression format of returned stream.
- optional StreamCompression streamCompression
-
-# A domain for letting clients substitute browser's network layer with client code.
-domain Fetch
- depends on Network
- depends on IO
- depends on Page
-
- # Unique request identifier.
- # Note that this does not identify individual HTTP requests that are part of
- # a network request.
- type RequestId extends string
-
- # 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).
- type RequestStage extends string
- enum
- Request
- Response
-
- type RequestPattern extends object
- properties
- # Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
- # backslash. Omitting is equivalent to `"*"`.
- optional string urlPattern
- # If set, only requests for matching resource types will be intercepted.
- optional Network.ResourceType resourceType
- # Stage at which to begin intercepting requests. Default is Request.
- optional RequestStage requestStage
-
- # Response HTTP header entry
- type HeaderEntry extends object
- properties
- string name
- string value
-
- # Authorization challenge for HTTP status code 401 or 407.
- type AuthChallenge extends object
- properties
- # Source of the authentication challenge.
- optional enum source
- Server
- Proxy
- # Origin of the challenger.
- string origin
- # The authentication scheme used, such as basic or digest
- string scheme
- # The realm of the challenge. May be empty.
- string realm
-
- # Response to an AuthChallenge.
- type AuthChallengeResponse extends object
- properties
- # The decision on what to do in response to the authorization challenge. Default means
- # deferring to the default behavior of the net stack, which will likely either the Cancel
- # authentication or display a popup dialog box.
- enum response
- Default
- CancelAuth
- ProvideCredentials
- # The username to provide, possibly empty. Should only be set if response is
- # ProvideCredentials.
- optional string username
- # The password to provide, possibly empty. Should only be set if response is
- # ProvideCredentials.
- optional string password
-
- # Disables the fetch domain.
- command disable
-
- # Enables issuing of requestPaused events. A request will be paused until client
- # calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
- command enable
- parameters
- # If specified, only requests matching any of these patterns will produce
- # fetchRequested event and will be paused until clients response. If not set,
- # all requests will be affected.
- optional array of RequestPattern patterns
- # If true, authRequired events will be issued and requests will be paused
- # expecting a call to continueWithAuth.
- optional boolean handleAuthRequests
-
- # Causes the request to fail with specified reason.
- command failRequest
- parameters
- # An id the client received in requestPaused event.
- RequestId requestId
- # Causes the request to fail with the given reason.
- Network.ErrorReason errorReason
-
- # Provides response to the request.
- command fulfillRequest
- parameters
- # An id the client received in requestPaused event.
- RequestId requestId
- # An HTTP response code.
- integer responseCode
- # Response headers.
- optional array of HeaderEntry responseHeaders
- # Alternative way of specifying response headers as a \0-separated
- # series of name: value pairs. Prefer the above method unless you
- # need to represent some non-UTF8 values that can't be transmitted
- # over the protocol as text.
- optional binary binaryResponseHeaders
- # A response body. If absent, original response body will be used if
- # the request is intercepted at the response stage and empty body
- # will be used if the request is intercepted at the request stage.
- optional binary body
- # A textual representation of responseCode.
- # If absent, a standard phrase matching responseCode is used.
- optional string responsePhrase
-
- # Continues the request, optionally modifying some of its parameters.
- command continueRequest
- parameters
- # An id the client received in requestPaused event.
- RequestId requestId
- # If set, the request url will be modified in a way that's not observable by page.
- optional string url
- # If set, the request method is overridden.
- optional string method
- # If set, overrides the post data in the request.
- optional binary postData
- # If set, overrides the request headers. Note that the overrides do not
- # extend to subsequent redirect hops, if a redirect happens. Another override
- # may be applied to a different request produced by a redirect.
- optional array of HeaderEntry headers
- # If set, overrides response interception behavior for this request.
- experimental optional boolean interceptResponse
-
- # Continues a request supplying authChallengeResponse following authRequired event.
- command continueWithAuth
- parameters
- # An id the client received in authRequired event.
- RequestId requestId
- # Response to with an authChallenge.
- AuthChallengeResponse authChallengeResponse
-
- # Continues loading of the paused response, optionally modifying the
- # response headers. If either responseCode or headers are modified, all of them
- # must be present.
- experimental command continueResponse
- parameters
- # An id the client received in requestPaused event.
- RequestId requestId
- # An HTTP response code. If absent, original response code will be used.
- optional integer responseCode
- # A textual representation of responseCode.
- # If absent, a standard phrase matching responseCode is used.
- optional string responsePhrase
- # Response headers. If absent, original response headers will be used.
- optional array of HeaderEntry responseHeaders
- # Alternative way of specifying response headers as a \0-separated
- # series of name: value pairs. Prefer the above method unless you
- # need to represent some non-UTF8 values that can't be transmitted
- # over the protocol as text.
- optional binary binaryResponseHeaders
-
- # Causes the body of the response to be received from the server and
- # returned as a single string. May only be issued for a request that
- # is paused in the Response stage and is mutually exclusive with
- # takeResponseBodyForInterceptionAsStream. Calling other methods that
- # affect the request or disabling fetch domain before body is received
- # results in an undefined behavior.
- # Note that the response body is not available for redirects. Requests
- # paused in the _redirect received_ state may be differentiated by
- # `responseCode` and presence of `location` response header, see
- # comments to `requestPaused` for details.
- command getResponseBody
- parameters
- # Identifier for the intercepted request to get body for.
- RequestId requestId
- returns
- # Response body.
- string body
- # True, if content was sent as base64.
- boolean base64Encoded
-
- # Returns a handle to the stream representing the response body.
- # The request must be paused in the HeadersReceived stage.
- # Note that after this command the request can't be continued
- # as is -- client either needs to cancel it or to provide the
- # response body.
- # The stream only supports sequential read, IO.read will fail if the position
- # is specified.
- # This method is mutually exclusive with getResponseBody.
- # Calling other methods that affect the request or disabling fetch
- # domain before body is received results in an undefined behavior.
- command takeResponseBodyAsStream
- parameters
- RequestId requestId
- returns
- IO.StreamHandle stream
-
- # 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.
- # Redirect responses and subsequent requests are reported similarly to regular
- # responses and requests. Redirect responses may be distinguished by the value
- # of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
- # presence of the `location` header. Requests resulting from a redirect will
- # have `redirectedRequestId` field set.
- event requestPaused
- parameters
- # Each request the page makes will have a unique id.
- RequestId requestId
- # The details of the request.
- Network.Request request
- # The id of the frame that initiated the request.
- Page.FrameId frameId
- # How the requested resource will be used.
- Network.ResourceType resourceType
- # Response error if intercepted at response stage.
- optional Network.ErrorReason responseErrorReason
- # Response code if intercepted at response stage.
- optional integer responseStatusCode
- # Response status text if intercepted at response stage.
- optional string responseStatusText
- # Response headers if intercepted at the response stage.
- optional array of HeaderEntry responseHeaders
- # If the intercepted request had a corresponding Network.requestWillBeSent event fired for it,
- # then this networkId will be the same as the requestId present in the requestWillBeSent event.
- optional Network.RequestId networkId
- # If the request is due to a redirect response from the server, the id of the request that
- # has caused the redirect.
- experimental optional RequestId redirectedRequestId
-
- # Issued when the domain is enabled with handleAuthRequests set to true.
- # The request is paused until client responds with continueWithAuth.
- event authRequired
- parameters
- # Each request the page makes will have a unique id.
- RequestId requestId
- # The details of the request.
- Network.Request request
- # The id of the frame that initiated the request.
- Page.FrameId frameId
- # How the requested resource will be used.
- Network.ResourceType resourceType
- # Details of the Authorization Challenge encountered.
- # If this is set, client should respond with continueRequest that
- # contains AuthChallengeResponse.
- AuthChallenge authChallenge
-
-# This domain allows inspection of Web Audio API.
-# https://webaudio.github.io/web-audio-api/
-experimental domain WebAudio
-
- # An unique ID for a graph object (AudioContext, AudioNode, AudioParam) in Web Audio API
- type GraphObjectId extends string
-
- # Enum of BaseAudioContext types
- type ContextType extends string
- enum
- realtime
- offline
-
- # Enum of AudioContextState from the spec
- type ContextState extends string
- enum
- suspended
- running
- closed
- interrupted
-
- # Enum of AudioNode types
- type NodeType extends string
-
- # Enum of AudioNode::ChannelCountMode from the spec
- type ChannelCountMode extends string
- enum
- clamped-max
- explicit
- max
-
- # Enum of AudioNode::ChannelInterpretation from the spec
- type ChannelInterpretation extends string
- enum
- discrete
- speakers
-
- # Enum of AudioParam types
- type ParamType extends string
-
- # Enum of AudioParam::AutomationRate from the spec
- type AutomationRate extends string
- enum
- a-rate
- k-rate
-
- # Fields in AudioContext that change in real-time.
- type ContextRealtimeData extends object
- properties
- # The current context time in second in BaseAudioContext.
- number currentTime
- # The time spent on rendering graph divided by render quantum duration,
- # and multiplied by 100. 100 means the audio renderer reached the full
- # capacity and glitch may occur.
- number renderCapacity
- # A running mean of callback interval.
- number callbackIntervalMean
- # A running variance of callback interval.
- number callbackIntervalVariance
-
- # Protocol object for BaseAudioContext
- type BaseAudioContext extends object
- properties
- GraphObjectId contextId
- ContextType contextType
- ContextState contextState
- optional ContextRealtimeData realtimeData
- # Platform-dependent callback buffer size.
- number callbackBufferSize
- # Number of output channels supported by audio hardware in use.
- number maxOutputChannelCount
- # Context sample rate.
- number sampleRate
-
-# Protocol object for AudioListener
- type AudioListener extends object
- properties
- GraphObjectId listenerId
- GraphObjectId contextId
-
- # Protocol object for AudioNode
- type AudioNode extends object
- properties
- GraphObjectId nodeId
- GraphObjectId contextId
- NodeType nodeType
- number numberOfInputs
- number numberOfOutputs
- number channelCount
- ChannelCountMode channelCountMode
- ChannelInterpretation channelInterpretation
-
- # Protocol object for AudioParam
- type AudioParam extends object
- properties
- GraphObjectId paramId
- GraphObjectId nodeId
- GraphObjectId contextId
- ParamType paramType
- AutomationRate rate
- number defaultValue
- number minValue
- number maxValue
-
- # Enables the WebAudio domain and starts sending context lifetime events.
- command enable
-
- # Disables the WebAudio domain.
- command disable
-
- # Fetch the realtime data from the registered contexts.
- command getRealtimeData
- parameters
- GraphObjectId contextId
- returns
- ContextRealtimeData realtimeData
-
- # Notifies that a new BaseAudioContext has been created.
- event contextCreated
- parameters
- BaseAudioContext context
-
- # Notifies that an existing BaseAudioContext will be destroyed.
- event contextWillBeDestroyed
- parameters
- GraphObjectId contextId
-
- # Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
- event contextChanged
- parameters
- BaseAudioContext context
-
-# Notifies that the construction of an AudioListener has finished.
- event audioListenerCreated
- parameters
- AudioListener listener
-
- # Notifies that a new AudioListener has been created.
- event audioListenerWillBeDestroyed
- parameters
- GraphObjectId contextId
- GraphObjectId listenerId
-
- # Notifies that a new AudioNode has been created.
- event audioNodeCreated
- parameters
- AudioNode node
-
- # Notifies that an existing AudioNode has been destroyed.
- event audioNodeWillBeDestroyed
- parameters
- GraphObjectId contextId
- GraphObjectId nodeId
-
- # Notifies that a new AudioParam has been created.
- event audioParamCreated
- parameters
- AudioParam param
-
- # Notifies that an existing AudioParam has been destroyed.
- event audioParamWillBeDestroyed
- parameters
- GraphObjectId contextId
- GraphObjectId nodeId
- GraphObjectId paramId
-
- # Notifies that two AudioNodes are connected.
- event nodesConnected
- parameters
- GraphObjectId contextId
- GraphObjectId sourceId
- GraphObjectId destinationId
- optional number sourceOutputIndex
- optional number destinationInputIndex
-
- # Notifies that AudioNodes are disconnected. The destination can be null, and it means all the outgoing connections from the source are disconnected.
- event nodesDisconnected
- parameters
- GraphObjectId contextId
- GraphObjectId sourceId
- GraphObjectId destinationId
- optional number sourceOutputIndex
- optional number destinationInputIndex
-
- # Notifies that an AudioNode is connected to an AudioParam.
- event nodeParamConnected
- parameters
- GraphObjectId contextId
- GraphObjectId sourceId
- GraphObjectId destinationId
- optional number sourceOutputIndex
-
- # Notifies that an AudioNode is disconnected to an AudioParam.
- event nodeParamDisconnected
- parameters
- GraphObjectId contextId
- GraphObjectId sourceId
- GraphObjectId destinationId
- optional number sourceOutputIndex
-
-# This domain allows configuring virtual authenticators to test the WebAuthn
-# API.
-experimental domain WebAuthn
- type AuthenticatorId extends string
-
- type AuthenticatorProtocol extends string
- enum
- # Universal 2nd Factor.
- u2f
- # Client To Authenticator Protocol 2.
- ctap2
-
- type Ctap2Version extends string
- enum
- ctap2_0
- ctap2_1
-
- type AuthenticatorTransport extends string
- enum
- # Cross-Platform authenticator attachments:
- usb
- nfc
- ble
- cable
- # Platform authenticator attachment:
- internal
-
- type VirtualAuthenticatorOptions extends object
- properties
- AuthenticatorProtocol protocol
- # Defaults to ctap2_0. Ignored if |protocol| == u2f.
- optional Ctap2Version ctap2Version
- AuthenticatorTransport transport
- # Defaults to false.
- optional boolean hasResidentKey
- # Defaults to false.
- optional boolean hasUserVerification
- # If set to true, the authenticator will support the largeBlob extension.
- # https://w3c.github.io/webauthn#largeBlob
- # Defaults to false.
- optional boolean hasLargeBlob
- # If set to true, the authenticator will support the credBlob extension.
- # https://fidoalliance.org/specs/fido-v2.1-rd-20201208/fido-client-to-authenticator-protocol-v2.1-rd-20201208.html#sctn-credBlob-extension
- # Defaults to false.
- optional boolean hasCredBlob
- # If set to true, the authenticator will support the minPinLength extension.
- # https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-20210615.html#sctn-minpinlength-extension
- # Defaults to false.
- optional boolean hasMinPinLength
- # If set to true, the authenticator will support the prf extension.
- # https://w3c.github.io/webauthn/#prf-extension
- # Defaults to false.
- optional boolean hasPrf
- # If set to true, tests of user presence will succeed immediately.
- # Otherwise, they will not be resolved. Defaults to true.
- optional boolean automaticPresenceSimulation
- # Sets whether User Verification succeeds or fails for an authenticator.
- # Defaults to false.
- optional boolean isUserVerified
- # Credentials created by this authenticator will have the backup
- # eligibility (BE) flag set to this value. Defaults to false.
- # https://w3c.github.io/webauthn/#sctn-credential-backup
- optional boolean defaultBackupEligibility
- # Credentials created by this authenticator will have the backup state
- # (BS) flag set to this value. Defaults to false.
- # https://w3c.github.io/webauthn/#sctn-credential-backup
- optional boolean defaultBackupState
-
- type Credential extends object
- properties
- binary credentialId
- boolean isResidentCredential
- # Relying Party ID the credential is scoped to. Must be set when adding a
- # credential.
- optional string rpId
- # The ECDSA P-256 private key in PKCS#8 format.
- binary privateKey
- # An opaque byte sequence with a maximum size of 64 bytes mapping the
- # credential to a specific user.
- optional binary userHandle
- # Signature counter. This is incremented by one for each successful
- # assertion.
- # See https://w3c.github.io/webauthn/#signature-counter
- integer signCount
- # The large blob associated with the credential.
- # See https://w3c.github.io/webauthn/#sctn-large-blob-extension
- optional binary largeBlob
- # Assertions returned by this credential will have the backup eligibility
- # (BE) flag set to this value. Defaults to the authenticator's
- # defaultBackupEligibility value.
- optional boolean backupEligibility
- # Assertions returned by this credential will have the backup state (BS)
- # flag set to this value. Defaults to the authenticator's
- # defaultBackupState value.
- optional boolean backupState
- # The credential's user.name property. Equivalent to empty if not set.
- # https://w3c.github.io/webauthn/#dom-publickeycredentialentity-name
- optional string userName
- # The credential's user.displayName property. Equivalent to empty if
- # not set.
- # https://w3c.github.io/webauthn/#dom-publickeycredentialuserentity-displayname
- optional string userDisplayName
-
- # Enable the WebAuthn domain and start intercepting credential storage and
- # retrieval with a virtual authenticator.
- command enable
- parameters
- # Whether to enable the WebAuthn user interface. Enabling the UI is
- # recommended for debugging and demo purposes, as it is closer to the real
- # experience. Disabling the UI is recommended for automated testing.
- # Supported at the embedder's discretion if UI is available.
- # Defaults to false.
- optional boolean enableUI
-
- # Disable the WebAuthn domain.
- command disable
-
- # Creates and adds a virtual authenticator.
- command addVirtualAuthenticator
- parameters
- VirtualAuthenticatorOptions options
- returns
- AuthenticatorId authenticatorId
-
- # Resets parameters isBogusSignature, isBadUV, isBadUP to false if they are not present.
- command setResponseOverrideBits
- parameters
- AuthenticatorId authenticatorId
- # If isBogusSignature is set, overrides the signature in the authenticator response to be zero.
- # Defaults to false.
- optional boolean isBogusSignature
- # If isBadUV is set, overrides the UV bit in the flags in the authenticator response to
- # be zero. Defaults to false.
- optional boolean isBadUV
- # If isBadUP is set, overrides the UP bit in the flags in the authenticator response to
- # be zero. Defaults to false.
- optional boolean isBadUP
-
- # Removes the given authenticator.
- command removeVirtualAuthenticator
- parameters
- AuthenticatorId authenticatorId
-
- # Adds the credential to the specified authenticator.
- command addCredential
- parameters
- AuthenticatorId authenticatorId
- Credential credential
-
- # Returns a single credential stored in the given virtual authenticator that
- # matches the credential ID.
- command getCredential
- parameters
- AuthenticatorId authenticatorId
- binary credentialId
- returns
- Credential credential
-
- # Returns all the credentials stored in the given virtual authenticator.
- command getCredentials
- parameters
- AuthenticatorId authenticatorId
- returns
- array of Credential credentials
-
- # Removes a credential from the authenticator.
- command removeCredential
- parameters
- AuthenticatorId authenticatorId
- binary credentialId
-
- # Clears all the credentials from the specified device.
- command clearCredentials
- parameters
- AuthenticatorId authenticatorId
-
- # Sets whether User Verification succeeds or fails for an authenticator.
- # The default is true.
- command setUserVerified
- parameters
- AuthenticatorId authenticatorId
- boolean isUserVerified
-
- # Sets whether tests of user presence will succeed immediately (if true) or fail to resolve (if false) for an authenticator.
- # The default is true.
- command setAutomaticPresenceSimulation
- parameters
- AuthenticatorId authenticatorId
- boolean enabled
-
- # Allows setting credential properties.
- # https://w3c.github.io/webauthn/#sctn-automation-set-credential-properties
- command setCredentialProperties
- parameters
- AuthenticatorId authenticatorId
- binary credentialId
- optional boolean backupEligibility
- optional boolean backupState
-
- # Triggered when a credential is added to an authenticator.
- event credentialAdded
- parameters
- AuthenticatorId authenticatorId
- Credential credential
-
- # Triggered when a credential is deleted, e.g. through
- # PublicKeyCredential.signalUnknownCredential().
- event credentialDeleted
- parameters
- AuthenticatorId authenticatorId
- binary credentialId
-
- # Triggered when a credential is updated, e.g. through
- # PublicKeyCredential.signalCurrentUserDetails().
- event credentialUpdated
- parameters
- AuthenticatorId authenticatorId
- Credential credential
-
- # Triggered when a credential is used in a webauthn assertion.
- event credentialAsserted
- parameters
- AuthenticatorId authenticatorId
- Credential credential
-
-# This domain allows detailed inspection of media elements
-experimental domain Media
-
- # Players will get an ID that is unique within the agent context.
- type PlayerId extends string
-
- type Timestamp extends number
-
- # Have one type per entry in MediaLogRecord::Type
- # Corresponds to kMessage
- type PlayerMessage extends object
- properties
- # Keep in sync with MediaLogMessageLevel
- # We are currently keeping the message level 'error' separate from the
- # PlayerError type because right now they represent different things,
- # this one being a DVLOG(ERROR) style log message that gets printed
- # based on what log level is selected in the UI, and the other is a
- # representation of a media::PipelineStatus object. Soon however we're
- # going to be moving away from using PipelineStatus for errors and
- # introducing a new error type which should hopefully let us integrate
- # the error log level into the PlayerError type.
- enum level
- error
- warning
- info
- debug
- string message
-
- # Corresponds to kMediaPropertyChange
- type PlayerProperty extends object
- properties
- string name
- string value
-
- # Corresponds to kMediaEventTriggered
- type PlayerEvent extends object
- properties
- Timestamp timestamp
- string value
-
- # Represents logged source line numbers reported in an error.
- # NOTE: file and line are from chromium c++ implementation code, not js.
- type PlayerErrorSourceLocation extends object
- properties
- string file
- integer line
-
- # Corresponds to kMediaError
- type PlayerError extends object
- properties
- string errorType
- # Code is the numeric enum entry for a specific set of error codes, such
- # as PipelineStatusCodes in media/base/pipeline_status.h
- integer code
- # A trace of where this error was caused / where it passed through.
- array of PlayerErrorSourceLocation stack
- # Errors potentially have a root cause error, ie, a DecoderError might be
- # caused by an WindowsError
- array of PlayerError cause
- # Extra data attached to an error, such as an HRESULT, Video Codec, etc.
- object data
-
- # This can be called multiple times, and can be used to set / override /
- # remove player properties. A null propValue indicates removal.
- event playerPropertiesChanged
- parameters
- PlayerId playerId
- array of PlayerProperty properties
-
- # 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.
- event playerEventsAdded
- parameters
- PlayerId playerId
- array of PlayerEvent events
-
- # Send a list of any messages that need to be delivered.
- event playerMessagesLogged
- parameters
- PlayerId playerId
- array of PlayerMessage messages
-
- # Send a list of any errors that need to be delivered.
- event playerErrorsRaised
- parameters
- PlayerId playerId
- array of PlayerError errors
-
- # 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.
- event playersCreated
- parameters
- array of PlayerId players
-
- # Enables the Media domain
- command enable
-
- # Disables the Media domain.
- command disable
-
-experimental domain DeviceAccess
- # Device request id.
- type RequestId extends string
-
- # A device id.
- type DeviceId extends string
-
- # Device information displayed in a user prompt to select a device.
- type PromptDevice extends object
- properties
- DeviceId id
- # Display name as it appears in a device request user prompt.
- string name
-
- # Enable events in this domain.
- command enable
-
- # Disable events in this domain.
- command disable
-
- # Select a device in response to a DeviceAccess.deviceRequestPrompted event.
- command selectPrompt
- parameters
- RequestId id
- DeviceId deviceId
-
- # Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
- command cancelPrompt
- parameters
- RequestId id
-
- # A device request opened a user prompt to select a device. Respond with the
- # selectPrompt or cancelPrompt command.
- event deviceRequestPrompted
- parameters
- RequestId id
- array of PromptDevice devices
-
-experimental domain Preload
- # Unique id
- type RuleSetId extends string
-
- # Corresponds to SpeculationRuleSet
- type RuleSet extends object
- properties
- RuleSetId id
- # Identifies a document which the rule set is associated with.
- Network.LoaderId loaderId
- # Source text of JSON representing the rule set. If it comes from
- # `<script>` tag, it is the textContent of the node. Note that it is
- # a JSON for valid case.
- #
- # See also:
- # - https://wicg.github.io/nav-speculation/speculation-rules.html
- # - https://github.com/WICG/nav-speculation/blob/main/triggers.md
- string sourceText
- # A speculation rule set is either added through an inline
- # `<script>` tag or through an external resource via the
- # 'Speculation-Rules' HTTP header. For the first case, we include
- # the BackendNodeId of the relevant `<script>` tag. For the second
- # case, we include the external URL where the rule set was loaded
- # from, and also RequestId if Network domain is enabled.
- #
- # See also:
- # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-script
- # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-header
- optional DOM.BackendNodeId backendNodeId
- optional string url
- optional Network.RequestId requestId
- # Error information
- # `errorMessage` is null iff `errorType` is null.
- optional RuleSetErrorType errorType
- # TODO(https://crbug.com/1425354): Replace this property with structured error.
- deprecated optional string errorMessage
-
- type RuleSetErrorType extends string
- enum
- SourceIsNotJsonObject
- InvalidRulesSkipped
- InvalidRulesetLevelTag
-
- # The type of preloading attempted. It corresponds to
- # mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
- # isn't being used by clients).
- type SpeculationAction extends string
- enum
- Prefetch
- Prerender
-
- # Corresponds to mojom::SpeculationTargetHint.
- # See https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
- type SpeculationTargetHint extends string
- enum
- Blank
- Self
-
- # A key that identifies a preloading attempt.
- #
- # The url used is the url specified by the trigger (i.e. the initial URL), and
- # not the final url that is navigated to. For example, prerendering allows
- # same-origin main frame navigations during the attempt, but the attempt is
- # still keyed with the initial URL.
- type PreloadingAttemptKey extends object
- properties
- Network.LoaderId loaderId
- SpeculationAction action
- string url
- optional SpeculationTargetHint targetHint
-
- # Lists sources for a preloading attempt, specifically the ids of rule sets
- # that had a speculation rule that triggered the attempt, and the
- # BackendNodeIds of <a href> or <area href> elements that triggered the
- # attempt (in the case of attempts triggered by a document rule). It is
- # possible for multiple rule sets and links to trigger a single attempt.
- type PreloadingAttemptSource extends object
- properties
- PreloadingAttemptKey key
- array of RuleSetId ruleSetIds
- array of DOM.BackendNodeId nodeIds
-
- # Chrome manages different types of preloads together using a
- # concept of preloading pipeline. For example, if a site uses a
- # SpeculationRules for prerender, Chrome first starts a prefetch and
- # then upgrades it to prerender.
- #
- # CDP events for them are emitted separately but they share
- # `PreloadPipelineId`.
- type PreloadPipelineId extends string
-
- command enable
-
- command disable
-
- # Upsert. Currently, it is only emitted when a rule set added.
- event ruleSetUpdated
- parameters
- RuleSet ruleSet
-
- event ruleSetRemoved
- parameters
- RuleSetId id
-
- # List of FinalStatus reasons for Prerender2.
- type PrerenderFinalStatus extends string
- enum
- Activated
- Destroyed
- LowEndDevice
- InvalidSchemeRedirect
- InvalidSchemeNavigation
- NavigationRequestBlockedByCsp
- MojoBinderPolicy
- RendererProcessCrashed
- RendererProcessKilled
- Download
- TriggerDestroyed
- NavigationNotCommitted
- NavigationBadHttpStatus
- ClientCertRequested
- NavigationRequestNetworkError
- CancelAllHostsForTesting
- DidFailLoad
- Stop
- SslCertificateError
- LoginAuthRequested
- UaChangeRequiresReload
- BlockedByClient
- AudioOutputDeviceRequested
- MixedContent
- TriggerBackgrounded
- MemoryLimitExceeded
- DataSaverEnabled
- TriggerUrlHasEffectiveUrl
- ActivatedBeforeStarted
- InactivePageRestriction
- StartFailed
- TimeoutBackgrounded
- CrossSiteRedirectInInitialNavigation
- CrossSiteNavigationInInitialNavigation
- SameSiteCrossOriginRedirectNotOptInInInitialNavigation
- SameSiteCrossOriginNavigationNotOptInInInitialNavigation
- ActivationNavigationParameterMismatch
- ActivatedInBackground
- EmbedderHostDisallowed
- ActivationNavigationDestroyedBeforeSuccess
- TabClosedByUserGesture
- TabClosedWithoutUserGesture
- PrimaryMainFrameRendererProcessCrashed
- PrimaryMainFrameRendererProcessKilled
- ActivationFramePolicyNotCompatible
- PreloadingDisabled
- BatterySaverEnabled
- ActivatedDuringMainFrameNavigation
- PreloadingUnsupportedByWebContents
- CrossSiteRedirectInMainFrameNavigation
- CrossSiteNavigationInMainFrameNavigation
- SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation
- SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
- MemoryPressureOnTrigger
- MemoryPressureAfterTriggered
- PrerenderingDisabledByDevTools
- SpeculationRuleRemoved
- ActivatedWithAuxiliaryBrowsingContexts
- MaxNumOfRunningEagerPrerendersExceeded
- MaxNumOfRunningNonEagerPrerendersExceeded
- MaxNumOfRunningEmbedderPrerendersExceeded
- PrerenderingUrlHasEffectiveUrl
- RedirectedPrerenderingUrlHasEffectiveUrl
- ActivationUrlHasEffectiveUrl
- JavaScriptInterfaceAdded
- JavaScriptInterfaceRemoved
- AllPrerenderingCanceled
- WindowClosed
- SlowNetwork
- OtherPrerenderedPageActivated
- V8OptimizerDisabled
- PrerenderFailedDuringPrefetch
- BrowsingDataRemoved
- PrerenderHostReused
-
- # Fired when a preload enabled state is updated.
- event preloadEnabledStateUpdated
- parameters
- boolean disabledByPreference
- boolean disabledByDataSaver
- boolean disabledByBatterySaver
- boolean disabledByHoldbackPrefetchSpeculationRules
- boolean disabledByHoldbackPrerenderSpeculationRules
-
- # Preloading status values, see also PreloadingTriggeringOutcome. This
- # status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
- type PreloadingStatus extends string
- enum
- Pending
- Running
- Ready
- Success
- Failure
- # PreloadingTriggeringOutcome which not used by prefetch nor prerender.
- NotSupported
-
- # TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
- # filter out the ones that aren't necessary to the developers.
- type PrefetchStatus extends string
- enum
- # Prefetch is not disabled by PrefetchHeldback.
- PrefetchAllowed
- PrefetchFailedIneligibleRedirect
- PrefetchFailedInvalidRedirect
- PrefetchFailedMIMENotSupported
- PrefetchFailedNetError
- PrefetchFailedNon2XX
- PrefetchEvictedAfterBrowsingDataRemoved
- PrefetchEvictedAfterCandidateRemoved
- PrefetchEvictedForNewerPrefetch
- PrefetchHeldback
- # A previous prefetch to the origin got a HTTP 503 response with an
- # Retry-After header that has no elapsed yet.
- PrefetchIneligibleRetryAfter
- PrefetchIsPrivacyDecoy
- PrefetchIsStale
- PrefetchNotEligibleBrowserContextOffTheRecord
- PrefetchNotEligibleDataSaverEnabled
- PrefetchNotEligibleExistingProxy
- PrefetchNotEligibleHostIsNonUnique
- PrefetchNotEligibleNonDefaultStoragePartition
- PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy
- PrefetchNotEligibleSchemeIsNotHttps
- PrefetchNotEligibleUserHasCookies
- PrefetchNotEligibleUserHasServiceWorker
- PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler
- PrefetchNotEligibleRedirectFromServiceWorker
- PrefetchNotEligibleRedirectToServiceWorker
- PrefetchNotEligibleBatterySaverEnabled
- PrefetchNotEligiblePreloadingDisabled
- PrefetchNotFinishedInTime
- PrefetchNotStarted
- PrefetchNotUsedCookiesChanged
- PrefetchProxyNotAvailable
- # The response of the prefetch is used for the next navigation. This is
- # the final successful state.
- PrefetchResponseUsed
- # The prefetch finished successfully but was never used.
- PrefetchSuccessfulButNotUsed
- PrefetchNotUsedProbeFailed
-
- # Fired when a prefetch attempt is updated.
- event prefetchStatusUpdated
- parameters
- PreloadingAttemptKey key
- PreloadPipelineId pipelineId
- # The frame id of the frame initiating prefetch.
- Page.FrameId initiatingFrameId
- string prefetchUrl
- PreloadingStatus status
- PrefetchStatus prefetchStatus
- Network.RequestId requestId
-
- # Information of headers to be displayed when the header mismatch occurred.
- type PrerenderMismatchedHeaders extends object
- properties
- string headerName
- optional string initialValue
- optional string activationValue
-
- # Fired when a prerender attempt is updated.
- event prerenderStatusUpdated
- parameters
- PreloadingAttemptKey key
- PreloadPipelineId pipelineId
- PreloadingStatus status
- optional PrerenderFinalStatus prerenderStatus
- # This is used to give users more information about the name of Mojo interface
- # that is incompatible with prerender and has caused the cancellation of the attempt.
- optional string disallowedMojoInterface
- optional array of PrerenderMismatchedHeaders mismatchedHeaders
-
- # Send a list of sources for all preloading attempts in a document.
- event preloadingAttemptSourcesUpdated
- parameters
- Network.LoaderId loaderId
- array of PreloadingAttemptSource preloadingAttemptSources
-
-# This domain allows interacting with the FedCM dialog.
-experimental domain FedCm
- # Whether this is a sign-up or sign-in action for this account, i.e.
- # whether this account has ever been used to sign in to this RP before.
- type LoginState extends string
- enum
- SignIn
- SignUp
-
- # The types of FedCM dialogs.
- type DialogType extends string
- enum
- AccountChooser
- AutoReauthn
- ConfirmIdpLogin
- Error
-
- # The buttons on the FedCM dialog.
- type DialogButton extends string
- enum
- ConfirmIdpLoginContinue
- ErrorGotIt
- ErrorMoreDetails
-
- # The URLs that each account has
- type AccountUrlType extends string
- enum
- TermsOfService
- PrivacyPolicy
-
- # Corresponds to IdentityRequestAccount
- type Account extends object
- properties
- string accountId
- string email
- string name
- string givenName
- string pictureUrl
- string idpConfigUrl
- string idpLoginUrl
- LoginState loginState
- # These two are only set if the loginState is signUp
- optional string termsOfServiceUrl
- optional string privacyPolicyUrl
-
- event dialogShown
- parameters
- string dialogId
- DialogType dialogType
- array of Account accounts
- # These exist primarily so that the caller can verify the
- # RP context was used appropriately.
- string title
- optional string subtitle
-
- # Triggered when a dialog is closed, either by user action, JS abort,
- # or a command below.
- event dialogClosed
- parameters
- string dialogId
-
- command enable
- parameters
- # Allows callers to disable the promise rejection delay that would
- # normally happen, if this is unimportant to what's being tested.
- # (step 4 of https://fedidcg.github.io/FedCM/#browser-api-rp-sign-in)
- optional boolean disableRejectionDelay
-
- command disable
-
- command selectAccount
- parameters
- string dialogId
- integer accountIndex
-
- command clickDialogButton
- parameters
- string dialogId
- DialogButton dialogButton
-
- command openUrl
- parameters
- string dialogId
- integer accountIndex
- AccountUrlType accountUrlType
-
- command dismissDialog
- parameters
- string dialogId
- optional boolean triggerCooldown
-
- # Resets the cooldown time, if any, to allow the next FedCM call to show
- # a dialog even if one was recently dismissed by the user.
- command resetCooldown
-
-# This domain allows interacting with the browser to control PWAs.
-experimental domain PWA
-
- # The following types are the replica of
- # https://crsrc.org/c/chrome/browser/web_applications/proto/web_app_os_integration_state.proto;drc=9910d3be894c8f142c977ba1023f30a656bc13fc;l=67
- type FileHandlerAccept extends object
- properties
- # New name of the mimetype according to
- # https://www.iana.org/assignments/media-types/media-types.xhtml
- string mediaType
- array of string fileExtensions
-
- type FileHandler extends object
- properties
- string action
- array of FileHandlerAccept accepts
- string displayName
-
- # Returns the following OS state for the given manifest id.
- command getOsAppState
- parameters
- # The id from the webapp's manifest file, commonly it's the url of the
- # site installing the webapp. See
- # https://web.dev/learn/pwa/web-app-manifest.
- string manifestId
- returns
- integer badgeCount
- array of FileHandler fileHandlers
-
- # Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
- #
- # IWA-specific install description:
- # manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
- #
- # File installation mode:
- # The installUrlOrBundleUrl can be either file:// or http(s):// pointing
- # to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
- # The .swbn file's signing key.
- #
- # Dev proxy installation mode:
- # installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
- # web_package::SignedWebBundleId must be of type dev proxy.
- #
- # The advantage of dev proxy mode is that all changes to IWA
- # automatically will be reflected in the running app without
- # reinstallation.
- #
- # To generate bundle id for proxy mode:
- # 1. Generate 32 random bytes.
- # 2. Add a specific suffix 0x00 at the end.
- # 3. Encode the entire sequence using Base32 without padding.
- #
- # If Chrome is not in IWA dev
- # mode, the installation will fail, regardless of the state of the allowlist.
- command install
- parameters
- string manifestId
- # The location of the app or bundle overriding the one derived from the
- # manifestId.
- optional string installUrlOrBundleUrl
-
- # Uninstalls the given manifest_id and closes any opened app windows.
- command uninstall
- parameters
- string manifestId
-
- # Launches the installed web app, or an url in the same web app instead of the
- # default start url if it is provided. Returns a page Target.TargetID which
- # can be used to attach to via Target.attachToTarget or similar APIs.
- command launch
- parameters
- string manifestId
- optional string url
- returns
- # ID of the tab target created as a result.
- Target.TargetID targetId
-
- # Opens one or more local files from an installed web app identified by its
- # manifestId. The web app needs to have file handlers registered to process
- # the files. The API returns one or more page Target.TargetIDs which can be
- # used to attach to via Target.attachToTarget or similar APIs.
- # If some files in the parameters cannot be handled by the web app, they will
- # be ignored. If none of the files can be handled, this API returns an error.
- # If no files are provided as the parameter, this API also returns an error.
- #
- # According to the definition of the file handlers in the manifest file, one
- # Target.TargetID may represent a page handling one or more files. The order
- # of the returned Target.TargetIDs is not guaranteed.
- #
- # TODO(crbug.com/339454034): Check the existences of the input files.
- command launchFilesInApp
- parameters
- string manifestId
- array of string files
- returns
- # IDs of the tab targets created as the result.
- array of Target.TargetID targetIds
-
- # Opens the current page in its web app identified by the manifest id, needs
- # to be called on a page target. This function returns immediately without
- # waiting for the app to finish loading.
- command openCurrentPageInApp
- parameters
- string manifestId
-
- # If user prefers opening the app in browser or an app window.
- type DisplayMode extends string
- enum
- standalone
- browser
-
- # Changes user settings of the web app identified by its manifestId. If the
- # app was not installed, this command returns an error. Unset parameters will
- # be ignored; unrecognized values will cause an error.
- #
- # Unlike the ones defined in the manifest files of the web apps, these
- # settings are provided by the browser and controlled by the users, they
- # impact the way the browser handling the web apps.
- #
- # See the comment of each parameter.
- command changeAppUserSettings
- parameters
- string manifestId
- # If user allows the links clicked on by the user in the app's scope, or
- # extended scope if the manifest has scope extensions and the flags
- # `DesktopPWAsLinkCapturingWithScopeExtensions` and
- # `WebAppEnableScopeExtensions` are enabled.
- #
- # Note, the API does not support resetting the linkCapturing to the
- # initial value, uninstalling and installing the web app again will reset
- # it.
- #
- # TODO(crbug.com/339453269): Setting this value on ChromeOS is not
- # supported yet.
- optional boolean linkCapturing
- optional DisplayMode displayMode
-
-# This domain allows configuring virtual Bluetooth devices to test
-# the web-bluetooth API.
-experimental domain BluetoothEmulation
- # Indicates the various states of Central.
- type CentralState extends string
- enum
- absent
- powered-off
- powered-on
-
- # Indicates the various types of GATT event.
- type GATTOperationType extends string
- enum
- connection
- discovery
-
- # Indicates the various types of characteristic write.
- type CharacteristicWriteType extends string
- enum
- write-default-deprecated
- write-with-response
- write-without-response
-
- # Indicates the various types of characteristic operation.
- type CharacteristicOperationType extends string
- enum
- read
- write
- subscribe-to-notifications
- unsubscribe-from-notifications
-
- # Indicates the various types of descriptor operation.
- type DescriptorOperationType extends string
- enum
- read
- write
-
- # Stores the manufacturer data
- type ManufacturerData extends object
- properties
- # Company identifier
- # https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
- # https://usb.org/developers
- integer key
- # Manufacturer-specific data
- binary data
-
- # Stores the byte data of the advertisement packet sent by a Bluetooth device.
- type ScanRecord extends object
- properties
- optional string name
- optional array of string uuids
- # Stores the external appearance description of the device.
- optional integer appearance
- # Stores the transmission power of a broadcasting device.
- optional integer txPower
- # Key is the company identifier and the value is an array of bytes of
- # manufacturer specific data.
- optional array of ManufacturerData manufacturerData
-
- # Stores the advertisement packet information that is sent by a Bluetooth device.
- type ScanEntry extends object
- properties
- string deviceAddress
- integer rssi
- ScanRecord scanRecord
-
- # Describes the properties of a characteristic. This follows Bluetooth Core
- # Specification BT 4.2 Vol 3 Part G 3.3.1. Characteristic Properties.
- type CharacteristicProperties extends object
- properties
- optional boolean broadcast
- optional boolean read
- optional boolean writeWithoutResponse
- optional boolean write
- optional boolean notify
- optional boolean indicate
- optional boolean authenticatedSignedWrites
- optional boolean extendedProperties
-
- # Enable the BluetoothEmulation domain.
- command enable
- parameters
- # State of the simulated central.
- CentralState state
- # If the simulated central supports low-energy.
- boolean leSupported
-
- # Set the state of the simulated central.
- command setSimulatedCentralState
- parameters
- # State of the simulated central.
- CentralState state
-
- # Disable the BluetoothEmulation domain.
- command disable
-
- # Simulates a peripheral with |address|, |name| and |knownServiceUuids|
- # that has already been connected to the system.
- command simulatePreconnectedPeripheral
- parameters
- string address
- string name
- array of ManufacturerData manufacturerData
- array of string knownServiceUuids
-
- # Simulates an advertisement packet described in |entry| being received by
- # the central.
- command simulateAdvertisement
- parameters
- ScanEntry entry
-
- # Simulates the response code from the peripheral with |address| for a
- # GATT operation of |type|. The |code| value follows the HCI Error Codes from
- # Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
- command simulateGATTOperationResponse
- parameters
- string address
- GATTOperationType type
- integer code
-
- # Simulates the response from the characteristic with |characteristicId| for a
- # characteristic operation of |type|. The |code| value follows the Error
- # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
- # The |data| is expected to exist when simulating a successful read operation
- # response.
- command simulateCharacteristicOperationResponse
- parameters
- string characteristicId
- CharacteristicOperationType type
- integer code
- optional binary data
-
- # Simulates the response from the descriptor with |descriptorId| for a
- # descriptor operation of |type|. The |code| value follows the Error
- # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
- # The |data| is expected to exist when simulating a successful read operation
- # response.
- command simulateDescriptorOperationResponse
- parameters
- string descriptorId
- DescriptorOperationType type
- integer code
- optional binary data
-
- # Adds a service with |serviceUuid| to the peripheral with |address|.
- command addService
- parameters
- string address
- string serviceUuid
- returns
- # An identifier that uniquely represents this service.
- string serviceId
-
- # Removes the service respresented by |serviceId| from the simulated central.
- command removeService
- parameters
- string serviceId
-
- # Adds a characteristic with |characteristicUuid| and |properties| to the
- # service represented by |serviceId|.
- command addCharacteristic
- parameters
- string serviceId
- string characteristicUuid
- CharacteristicProperties properties
- returns
- # An identifier that uniquely represents this characteristic.
- string characteristicId
-
- # Removes the characteristic respresented by |characteristicId| from the
- # simulated central.
- command removeCharacteristic
- parameters
- string characteristicId
-
- # Adds a descriptor with |descriptorUuid| to the characteristic respresented
- # by |characteristicId|.
- command addDescriptor
- parameters
- string characteristicId
- string descriptorUuid
- returns
- # An identifier that uniquely represents this descriptor.
- string descriptorId
-
- # Removes the descriptor with |descriptorId| from the simulated central.
- command removeDescriptor
- parameters
- string descriptorId
-
- # Simulates a GATT disconnection from the peripheral with |address|.
- command simulateGATTDisconnection
- parameters
- string address
-
- # Event for when a GATT operation of |type| to the peripheral with |address|
- # happened.
- event gattOperationReceived
- parameters
- string address
- GATTOperationType type
-
- # Event for when a characteristic operation of |type| to the characteristic
- # respresented by |characteristicId| happened. |data| and |writeType| is
- # expected to exist when |type| is write.
- event characteristicOperationReceived
- parameters
- string characteristicId
- CharacteristicOperationType type
- optional binary data
- optional CharacteristicWriteType writeType
-
- # Event for when a descriptor operation of |type| to the descriptor
- # respresented by |descriptorId| happened. |data| is expected to exist when
- # |type| is write.
- event descriptorOperationReceived
- parameters
- string descriptorId
- DescriptorOperationType type
- optional binary data
+include domains/Accessibility.pdl
+include domains/Animation.pdl
+include domains/Audits.pdl
+include domains/Autofill.pdl
+include domains/BackgroundService.pdl
+include domains/BluetoothEmulation.pdl
+include domains/Browser.pdl
+include domains/CSS.pdl
+include domains/CacheStorage.pdl
+include domains/Cast.pdl
+include domains/DOM.pdl
+include domains/DOMDebugger.pdl
+include domains/DOMSnapshot.pdl
+include domains/DOMStorage.pdl
+include domains/DeviceAccess.pdl
+include domains/DeviceOrientation.pdl
+include domains/Emulation.pdl
+include domains/EventBreakpoints.pdl
+include domains/Extensions.pdl
+include domains/FedCm.pdl
+include domains/Fetch.pdl
+include domains/FileSystem.pdl
+include domains/HeadlessExperimental.pdl
+include domains/IO.pdl
+include domains/IndexedDB.pdl
+include domains/Input.pdl
+include domains/Inspector.pdl
+include domains/LayerTree.pdl
+include domains/Log.pdl
+include domains/Media.pdl
+include domains/Memory.pdl
+include domains/Network.pdl
+include domains/Overlay.pdl
+include domains/PWA.pdl
+include domains/Page.pdl
+include domains/Performance.pdl
+include domains/PerformanceTimeline.pdl
+include domains/Preload.pdl
+include domains/Security.pdl
+include domains/ServiceWorker.pdl
+include domains/Storage.pdl
+include domains/SystemInfo.pdl
+include domains/Target.pdl
+include domains/Tethering.pdl
+include domains/Tracing.pdl
+include domains/WebAudio.pdl
+include domains/WebAuthn.pdl
\ No newline at end of file
diff --git a/pdl/domains/Accessibility.pdl b/pdl/domains/Accessibility.pdl
new file mode 100644
index 00000000..093c7101
--- /dev/null
+++ b/pdl/domains/Accessibility.pdl
@@ -0,0 +1,290 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Accessibility
+ depends on DOM
+
+ # Unique accessibility node identifier.
+ type AXNodeId extends string
+
+ # Enum of possible property types.
+ type AXValueType extends string
+ enum
+ boolean
+ tristate
+ booleanOrUndefined
+ idref
+ idrefList
+ integer
+ node
+ nodeList
+ number
+ string
+ computedString
+ token
+ tokenList
+ domRelation
+ role
+ internalRole
+ valueUndefined
+
+ # Enum of possible property sources.
+ type AXValueSourceType extends string
+ enum
+ attribute
+ implicit
+ style
+ contents
+ placeholder
+ relatedElement
+
+ # Enum of possible native property sources (as a subtype of a particular AXValueSourceType).
+ type AXValueNativeSourceType extends string
+ enum
+ description
+ figcaption
+ label
+ labelfor
+ labelwrapped
+ legend
+ rubyannotation
+ tablecaption
+ title
+ other
+
+ # A single source for a computed AX property.
+ type AXValueSource extends object
+ properties
+ # What type of source this is.
+ AXValueSourceType type
+ # The value of this property source.
+ optional AXValue value
+ # The name of the relevant attribute, if any.
+ optional string attribute
+ # The value of the relevant attribute, if any.
+ optional AXValue attributeValue
+ # Whether this source is superseded by a higher priority source.
+ optional boolean superseded
+ # The native markup source for this value, e.g. a `<label>` element.
+ optional AXValueNativeSourceType nativeSource
+ # The value, such as a node or node list, of the native source.
+ optional AXValue nativeSourceValue
+ # Whether the value for this property is invalid.
+ optional boolean invalid
+ # Reason for the value being invalid, if it is.
+ optional string invalidReason
+
+ type AXRelatedNode extends object
+ properties
+ # The BackendNodeId of the related DOM node.
+ DOM.BackendNodeId backendDOMNodeId
+ # The IDRef value provided, if any.
+ optional string idref
+ # The text alternative of this node in the current context.
+ optional string text
+
+ type AXProperty extends object
+ properties
+ # The name of this property.
+ AXPropertyName name
+ # The value of this property.
+ AXValue value
+
+ # A single computed AX property.
+ type AXValue extends object
+ properties
+ # The type of this value.
+ AXValueType type
+ # The computed value of this property.
+ optional any value
+ # One or more related nodes, if applicable.
+ optional array of AXRelatedNode relatedNodes
+ # The sources which contributed to the computation of this property.
+ optional array of AXValueSource sources
+
+ # 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.
+ type AXPropertyName extends string
+ enum
+ actions
+ busy
+ disabled
+ editable
+ focusable
+ focused
+ hidden
+ hiddenRoot
+ invalid
+ keyshortcuts
+ settable
+ roledescription
+ live
+ atomic
+ relevant
+ root
+ autocomplete
+ hasPopup
+ level
+ multiselectable
+ orientation
+ multiline
+ readonly
+ required
+ valuemin
+ valuemax
+ valuetext
+ checked
+ expanded
+ modal
+ pressed
+ selected
+ activedescendant
+ controls
+ describedby
+ details
+ errormessage
+ flowto
+ labelledby
+ owns
+ url
+
+ # A node in the accessibility tree.
+ type AXNode extends object
+ properties
+ # Unique identifier for this node.
+ AXNodeId nodeId
+ # Whether this node is ignored for accessibility
+ boolean ignored
+ # Collection of reasons why this node is hidden.
+ optional array of AXProperty ignoredReasons
+ # This `Node`'s role, whether explicit or implicit.
+ optional AXValue role
+ # This `Node`'s Chrome raw role.
+ optional AXValue chromeRole
+ # The accessible name for this `Node`.
+ optional AXValue name
+ # The accessible description for this `Node`.
+ optional AXValue description
+ # The value for this `Node`.
+ optional AXValue value
+ # All other properties
+ optional array of AXProperty properties
+ # ID for this node's parent.
+ optional AXNodeId parentId
+ # IDs for each of this node's child nodes.
+ optional array of AXNodeId childIds
+ # The backend ID for the associated DOM node, if any.
+ optional DOM.BackendNodeId backendDOMNodeId
+ # The frame ID for the frame associated with this nodes document.
+ optional Page.FrameId frameId
+
+ # Disables the accessibility domain.
+ command disable
+
+ # Enables the accessibility domain which causes `AXNodeId`s to remain consistent between method calls.
+ # This turns on accessibility for the page, which can impact performance until accessibility is disabled.
+ command enable
+
+ # Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
+ experimental command getPartialAXTree
+ parameters
+ # Identifier of the node to get the partial accessibility tree for.
+ optional DOM.NodeId nodeId
+ # Identifier of the backend node to get the partial accessibility tree for.
+ optional DOM.BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper to get the partial accessibility tree for.
+ optional Runtime.RemoteObjectId objectId
+ # Whether to fetch this node's ancestors, siblings and children. Defaults to true.
+ optional boolean fetchRelatives
+ returns
+ # The `Accessibility.AXNode` for this DOM node, if it exists, plus its ancestors, siblings and
+ # children, if requested.
+ array of AXNode nodes
+
+ # Fetches the entire accessibility tree for the root Document
+ experimental command getFullAXTree
+ parameters
+ # The maximum depth at which descendants of the root node should be retrieved.
+ # If omitted, the full tree is returned.
+ optional integer depth
+ # The frame for whose document the AX tree should be retrieved.
+ # If omitted, the root frame is used.
+ optional Page.FrameId frameId
+ returns
+ array of AXNode nodes
+
+ # Fetches the root node.
+ # Requires `enable()` to have been called previously.
+ experimental command getRootAXNode
+ parameters
+ # The frame in whose document the node resides.
+ # If omitted, the root frame is used.
+ optional Page.FrameId frameId
+ returns
+ AXNode node
+
+ # Fetches a node and all ancestors up to and including the root.
+ # Requires `enable()` to have been called previously.
+ experimental command getAXNodeAndAncestors
+ parameters
+ # Identifier of the node to get.
+ optional DOM.NodeId nodeId
+ # Identifier of the backend node to get.
+ optional DOM.BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper to get.
+ optional Runtime.RemoteObjectId objectId
+ returns
+ array of AXNode nodes
+
+ # Fetches a particular accessibility node by AXNodeId.
+ # Requires `enable()` to have been called previously.
+ experimental command getChildAXNodes
+ parameters
+ AXNodeId id
+ # The frame in whose document the node resides.
+ # If omitted, the root frame is used.
+ optional Page.FrameId frameId
+ returns
+ array of AXNode nodes
+
+ # Query a DOM node's accessibility subtree for accessible name and role.
+ # This command computes the name and role for all nodes in the subtree, including those that are
+ # ignored for accessibility, and returns those that match the specified name and role. If no DOM
+ # node is specified, or the DOM node does not exist, the command returns an error. If neither
+ # `accessibleName` or `role` is specified, it returns all the accessibility nodes in the subtree.
+ experimental command queryAXTree
+ parameters
+ # Identifier of the node for the root to query.
+ optional DOM.NodeId nodeId
+ # Identifier of the backend node for the root to query.
+ optional DOM.BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper for the root to query.
+ optional Runtime.RemoteObjectId objectId
+ # Find nodes with this computed name.
+ optional string accessibleName
+ # Find nodes with this computed role.
+ optional string role
+ returns
+ # A list of `Accessibility.AXNode` matching the specified attributes,
+ # including nodes that are ignored for accessibility.
+ array of AXNode nodes
+
+ # The loadComplete event mirrors the load complete event sent by the browser to assistive
+ # technology when the web page has finished loading.
+ experimental event loadComplete
+ parameters
+ # New document root node.
+ AXNode root
+
+ # The nodesUpdated event is sent every time a previously requested node has changed the in tree.
+ experimental event nodesUpdated
+ parameters
+ # Updated node data.
+ array of AXNode nodes
diff --git a/pdl/domains/Animation.pdl b/pdl/domains/Animation.pdl
new file mode 100644
index 00000000..ed97c757
--- /dev/null
+++ b/pdl/domains/Animation.pdl
@@ -0,0 +1,195 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Animation
+ depends on Runtime
+ depends on DOM
+
+ # Animation instance.
+ type Animation extends object
+ properties
+ # `Animation`'s id.
+ string id
+ # `Animation`'s name.
+ string name
+ # `Animation`'s internal paused state.
+ boolean pausedState
+ # `Animation`'s play state.
+ string playState
+ # `Animation`'s playback rate.
+ number playbackRate
+ # `Animation`'s start time.
+ # Milliseconds for time based animations and
+ # percentage [0 - 100] for scroll driven animations
+ # (i.e. when viewOrScrollTimeline exists).
+ number startTime
+ # `Animation`'s current time.
+ number currentTime
+ # Animation type of `Animation`.
+ enum type
+ CSSTransition
+ CSSAnimation
+ WebAnimation
+ # `Animation`'s source animation node.
+ optional AnimationEffect source
+ # A unique ID for `Animation` representing the sources that triggered this CSS
+ # animation/transition.
+ optional string cssId
+ # View or scroll timeline
+ optional ViewOrScrollTimeline viewOrScrollTimeline
+
+ # Timeline instance
+ type ViewOrScrollTimeline extends object
+ properties
+ # Scroll container node
+ optional DOM.BackendNodeId sourceNodeId
+ # Represents the starting scroll position of the timeline
+ # as a length offset in pixels from scroll origin.
+ optional number startOffset
+ # Represents the ending scroll position of the timeline
+ # as a length offset in pixels from scroll origin.
+ optional number endOffset
+ # The element whose principal box's visibility in the
+ # scrollport defined the progress of the timeline.
+ # Does not exist for animations with ScrollTimeline
+ optional DOM.BackendNodeId subjectNodeId
+ # Orientation of the scroll
+ DOM.ScrollOrientation axis
+
+ # AnimationEffect instance
+ type AnimationEffect extends object
+ properties
+ # `AnimationEffect`'s delay.
+ number delay
+ # `AnimationEffect`'s end delay.
+ number endDelay
+ # `AnimationEffect`'s iteration start.
+ number iterationStart
+ # `AnimationEffect`'s iterations.
+ number iterations
+ # `AnimationEffect`'s iteration duration.
+ # Milliseconds for time based animations and
+ # percentage [0 - 100] for scroll driven animations
+ # (i.e. when viewOrScrollTimeline exists).
+ number duration
+ # `AnimationEffect`'s playback direction.
+ string direction
+ # `AnimationEffect`'s fill mode.
+ string fill
+ # `AnimationEffect`'s target node.
+ optional DOM.BackendNodeId backendNodeId
+ # `AnimationEffect`'s keyframes.
+ optional KeyframesRule keyframesRule
+ # `AnimationEffect`'s timing function.
+ string easing
+
+ # Keyframes Rule
+ type KeyframesRule extends object
+ properties
+ # CSS keyframed animation's name.
+ optional string name
+ # List of animation keyframes.
+ array of KeyframeStyle keyframes
+
+ # Keyframe Style
+ type KeyframeStyle extends object
+ properties
+ # Keyframe's time offset.
+ string offset
+ # `AnimationEffect`'s timing function.
+ string easing
+
+ # Disables animation domain notifications.
+ command disable
+
+ # Enables animation domain notifications.
+ command enable
+
+ # Returns the current time of the an animation.
+ command getCurrentTime
+ parameters
+ # Id of animation.
+ string id
+ returns
+ # Current time of the page.
+ number currentTime
+
+ # Gets the playback rate of the document timeline.
+ command getPlaybackRate
+ returns
+ # Playback rate for animations on page.
+ number playbackRate
+
+ # Releases a set of animations to no longer be manipulated.
+ command releaseAnimations
+ parameters
+ # List of animation ids to seek.
+ array of string animations
+
+ # Gets the remote object of the Animation.
+ command resolveAnimation
+ parameters
+ # Animation id.
+ string animationId
+ returns
+ # Corresponding remote object.
+ Runtime.RemoteObject remoteObject
+
+ # Seek a set of animations to a particular time within each animation.
+ command seekAnimations
+ parameters
+ # List of animation ids to seek.
+ array of string animations
+ # Set the current time of each animation.
+ number currentTime
+
+ # Sets the paused state of a set of animations.
+ command setPaused
+ parameters
+ # Animations to set the pause state of.
+ array of string animations
+ # Paused state to set to.
+ boolean paused
+
+ # Sets the playback rate of the document timeline.
+ command setPlaybackRate
+ parameters
+ # Playback rate for animations on page
+ number playbackRate
+
+ # Sets the timing of an animation node.
+ command setTiming
+ parameters
+ # Animation id.
+ string animationId
+ # Duration of the animation.
+ number duration
+ # Delay of the animation.
+ number delay
+
+ # Event for when an animation has been cancelled.
+ event animationCanceled
+ parameters
+ # Id of the animation that was cancelled.
+ string id
+
+ # Event for each animation that has been created.
+ event animationCreated
+ parameters
+ # Id of the animation that was created.
+ string id
+
+ # Event for animation that has been started.
+ event animationStarted
+ parameters
+ # Animation that was started.
+ Animation animation
+
+ # Event for animation that has been updated.
+ event animationUpdated
+ parameters
+ # Animation that was updated.
+ Animation animation
diff --git a/pdl/domains/Audits.pdl b/pdl/domains/Audits.pdl
new file mode 100644
index 00000000..3df619c3
--- /dev/null
+++ b/pdl/domains/Audits.pdl
@@ -0,0 +1,755 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Audits domain allows investigation of page violations and possible improvements.
+experimental domain Audits
+ depends on Network
+
+ # Information about a cookie that is affected by an inspector issue.
+ type AffectedCookie extends object
+ properties
+ # The following three properties uniquely identify a cookie
+ string name
+ string path
+ string domain
+
+ # Information about a request that is affected by an inspector issue.
+ type AffectedRequest extends object
+ properties
+ # The unique request id.
+ optional Network.RequestId requestId
+ string url
+
+ # Information about the frame affected by an inspector issue.
+ type AffectedFrame extends object
+ properties
+ Page.FrameId frameId
+
+ type CookieExclusionReason extends string
+ enum
+ ExcludeSameSiteUnspecifiedTreatedAsLax
+ ExcludeSameSiteNoneInsecure
+ ExcludeSameSiteLax
+ ExcludeSameSiteStrict
+ ExcludeInvalidSameParty
+ ExcludeSamePartyCrossPartyContext
+ ExcludeDomainNonASCII
+ ExcludeThirdPartyCookieBlockedInFirstPartySet
+ ExcludeThirdPartyPhaseout
+ ExcludePortMismatch
+ ExcludeSchemeMismatch
+
+ type CookieWarningReason extends string
+ enum
+ WarnSameSiteUnspecifiedCrossSiteContext
+ WarnSameSiteNoneInsecure
+ WarnSameSiteUnspecifiedLaxAllowUnsafe
+ WarnSameSiteStrictLaxDowngradeStrict
+ WarnSameSiteStrictCrossDowngradeStrict
+ WarnSameSiteStrictCrossDowngradeLax
+ WarnSameSiteLaxCrossDowngradeStrict
+ WarnSameSiteLaxCrossDowngradeLax
+ WarnAttributeValueExceedsMaxSize
+ WarnDomainNonASCII
+ WarnThirdPartyPhaseout
+ WarnCrossSiteRedirectDowngradeChangesInclusion
+ WarnDeprecationTrialMetadata
+ WarnThirdPartyCookieHeuristic
+
+ type CookieOperation extends string
+ enum
+ SetCookie
+ ReadCookie
+
+ # Represents the category of insight that a cookie issue falls under.
+ type InsightType extends string
+ enum
+ # Cookie domain has an entry in third-party cookie migration readiness
+ # list:
+ # https://github.com/privacysandbox/privacy-sandbox-dev-support/blob/main/3pc-migration-readiness.md
+ GitHubResource
+ # Cookie is exempted due to a grace period:
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
+ GracePeriod
+ # Cookie is exempted due a heuristics-based exemptiuon:
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/heuristics-based-exception
+ Heuristics
+
+ # Information about the suggested solution to a cookie issue.
+ type CookieIssueInsight extends object
+ properties
+ InsightType type
+ # Link to table entry in third-party cookie migration readiness list.
+ optional string tableEntryUrl
+
+ # 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.
+ type CookieIssueDetails extends object
+ properties
+ # If AffectedCookie is not set then rawCookieLine contains the raw
+ # Set-Cookie header string. This hints at a problem where the
+ # cookie line is syntactically or semantically malformed in a way
+ # that no valid cookie could be created.
+ optional AffectedCookie cookie
+ optional string rawCookieLine
+ array of CookieWarningReason cookieWarningReasons
+ array of CookieExclusionReason cookieExclusionReasons
+ # Optionally identifies the site-for-cookies and the cookie url, which
+ # may be used by the front-end as additional context.
+ CookieOperation operation
+ optional string siteForCookies
+ optional string cookieUrl
+ optional AffectedRequest request
+ # The recommended solution to the issue.
+ optional CookieIssueInsight insight
+
+ type MixedContentResolutionStatus extends string
+ enum
+ MixedContentBlocked
+ MixedContentAutomaticallyUpgraded
+ MixedContentWarning
+
+ type MixedContentResourceType extends string
+ enum
+ AttributionSrc
+ Audio
+ Beacon
+ CSPReport
+ Download
+ EventSource
+ Favicon
+ Font
+ Form
+ Frame
+ Image
+ Import
+ JSON
+ Manifest
+ Ping
+ PluginData
+ PluginResource
+ Prefetch
+ Resource
+ Script
+ ServiceWorker
+ SharedWorker
+ SpeculationRules
+ Stylesheet
+ Track
+ Video
+ Worker
+ XMLHttpRequest
+ XSLT
+
+ type MixedContentIssueDetails extends object
+ properties
+ # The type of resource causing the mixed content issue (css, js, iframe,
+ # form,...). Marked as optional because it is mapped to from
+ # blink::mojom::RequestContextType, which will be replaced
+ # by network::mojom::RequestDestination
+ optional MixedContentResourceType resourceType
+ # The way the mixed content issue is being resolved.
+ MixedContentResolutionStatus resolutionStatus
+ # The unsafe http url causing the mixed content issue.
+ string insecureURL
+ # The url responsible for the call to an unsafe url.
+ string mainResourceURL
+ # The mixed content request.
+ # Does not always exist (e.g. for unsafe form submission urls).
+ optional AffectedRequest request
+ # Optional because not every mixed content issue is necessarily linked to a frame.
+ optional AffectedFrame frame
+
+ # Enum indicating the reason a response has been blocked. These reasons are
+ # refinements of the net error BLOCKED_BY_RESPONSE.
+ type BlockedByResponseReason extends string
+ enum
+ CoepFrameResourceNeedsCoepHeader
+ CoopSandboxedIFrameCannotNavigateToCoopPage
+ CorpNotSameOrigin
+ CorpNotSameOriginAfterDefaultedToSameOriginByCoep
+ CorpNotSameOriginAfterDefaultedToSameOriginByDip
+ CorpNotSameOriginAfterDefaultedToSameOriginByCoepAndDip
+ CorpNotSameSite
+ SRIMessageSignatureMismatch
+
+ # 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.
+ type BlockedByResponseIssueDetails extends object
+ properties
+ AffectedRequest request
+ optional AffectedFrame parentFrame
+ optional AffectedFrame blockedFrame
+ BlockedByResponseReason reason
+
+ type HeavyAdResolutionStatus extends string
+ enum
+ HeavyAdBlocked
+ HeavyAdWarning
+
+ type HeavyAdReason extends string
+ enum
+ NetworkTotalLimit
+ CpuTotalLimit
+ CpuPeakLimit
+
+ type HeavyAdIssueDetails extends object
+ properties
+ # The resolution status, either blocking the content or warning.
+ HeavyAdResolutionStatus resolution
+ # The reason the ad was blocked, total network or cpu or peak cpu.
+ HeavyAdReason reason
+ # The frame that was blocked.
+ AffectedFrame frame
+
+ type ContentSecurityPolicyViolationType extends string
+ enum
+ kInlineViolation
+ kEvalViolation
+ kURLViolation
+ kSRIViolation
+ kTrustedTypesSinkViolation
+ kTrustedTypesPolicyViolation
+ kWasmEvalViolation
+
+ type SourceCodeLocation extends object
+ properties
+ optional Runtime.ScriptId scriptId
+ string url
+ integer lineNumber
+ integer columnNumber
+
+ type ContentSecurityPolicyIssueDetails extends object
+ properties
+ # The url not included in allowed sources.
+ optional string blockedURL
+ # Specific directive that is violated, causing the CSP issue.
+ string violatedDirective
+ boolean isReportOnly
+ ContentSecurityPolicyViolationType contentSecurityPolicyViolationType
+ optional AffectedFrame frameAncestor
+ optional SourceCodeLocation sourceCodeLocation
+ optional DOM.BackendNodeId violatingNodeId
+
+ type SharedArrayBufferIssueType extends string
+ enum
+ TransferIssue
+ CreationIssue
+
+ # Details for a issue arising from an SAB being instantiated in, or
+ # transferred to a context that is not cross-origin isolated.
+ type SharedArrayBufferIssueDetails extends object
+ properties
+ SourceCodeLocation sourceCodeLocation
+ boolean isWarning
+ SharedArrayBufferIssueType type
+
+ type LowTextContrastIssueDetails extends object
+ properties
+ DOM.BackendNodeId violatingNodeId
+ string violatingNodeSelector
+ number contrastRatio
+ number thresholdAA
+ number thresholdAAA
+ string fontSize
+ string fontWeight
+
+ # Details for a CORS related issue, e.g. a warning or error related to
+ # CORS RFC1918 enforcement.
+ type CorsIssueDetails extends object
+ properties
+ Network.CorsErrorStatus corsErrorStatus
+ boolean isWarning
+ AffectedRequest request
+ optional SourceCodeLocation location
+ optional string initiatorOrigin
+ optional Network.IPAddressSpace resourceIPAddressSpace
+ optional Network.ClientSecurityState clientSecurityState
+
+ type AttributionReportingIssueType extends string
+ enum
+ PermissionPolicyDisabled
+ UntrustworthyReportingOrigin
+ InsecureContext
+ # TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
+ InvalidHeader
+ InvalidRegisterTriggerHeader
+ SourceAndTriggerHeaders
+ SourceIgnored
+ TriggerIgnored
+ OsSourceIgnored
+ OsTriggerIgnored
+ InvalidRegisterOsSourceHeader
+ InvalidRegisterOsTriggerHeader
+ WebAndOsHeaders
+ NoWebOrOsSupport
+ NavigationRegistrationWithoutTransientUserActivation
+ InvalidInfoHeader
+ NoRegisterSourceHeader
+ NoRegisterTriggerHeader
+ NoRegisterOsSourceHeader
+ NoRegisterOsTriggerHeader
+ NavigationRegistrationUniqueScopeAlreadySet
+
+ type SharedDictionaryError extends string
+ enum
+ UseErrorCrossOriginNoCorsRequest
+ UseErrorDictionaryLoadFailure
+ UseErrorMatchingDictionaryNotUsed
+ UseErrorUnexpectedContentDictionaryHeader
+ WriteErrorCossOriginNoCorsRequest
+ WriteErrorDisallowedBySettings
+ WriteErrorExpiredResponse
+ WriteErrorFeatureDisabled
+ WriteErrorInsufficientResources
+ WriteErrorInvalidMatchField
+ WriteErrorInvalidStructuredHeader
+ WriteErrorNavigationRequest
+ WriteErrorNoMatchField
+ WriteErrorNonListMatchDestField
+ WriteErrorNonSecureContext
+ WriteErrorNonStringIdField
+ WriteErrorNonStringInMatchDestList
+ WriteErrorNonStringMatchField
+ WriteErrorNonTokenTypeField
+ WriteErrorRequestAborted
+ WriteErrorShuttingDown
+ WriteErrorTooLongIdField
+ WriteErrorUnsupportedType
+
+ type SRIMessageSignatureError extends string
+ enum
+ MissingSignatureHeader
+ MissingSignatureInputHeader
+ InvalidSignatureHeader
+ InvalidSignatureInputHeader
+ SignatureHeaderValueIsNotByteSequence
+ SignatureHeaderValueIsParameterized
+ SignatureHeaderValueIsIncorrectLength
+ SignatureInputHeaderMissingLabel
+ SignatureInputHeaderValueNotInnerList
+ SignatureInputHeaderValueMissingComponents
+ SignatureInputHeaderInvalidComponentType
+ SignatureInputHeaderInvalidComponentName
+ SignatureInputHeaderInvalidHeaderComponentParameter
+ SignatureInputHeaderInvalidDerivedComponentParameter
+ SignatureInputHeaderKeyIdLength
+ SignatureInputHeaderInvalidParameter
+ SignatureInputHeaderMissingRequiredParameters
+ ValidationFailedSignatureExpired
+ ValidationFailedInvalidLength
+ ValidationFailedSignatureMismatch
+ ValidationFailedIntegrityMismatch
+
+ type UnencodedDigestError extends string
+ enum
+ MalformedDictionary
+ UnknownAlgorithm
+ IncorrectDigestType
+ IncorrectDigestLength
+
+ # Details for issues around "Attribution Reporting API" usage.
+ # Explainer: https://github.com/WICG/attribution-reporting-api
+ type AttributionReportingIssueDetails extends object
+ properties
+ AttributionReportingIssueType violationType
+ optional AffectedRequest request
+ optional DOM.BackendNodeId violatingNodeId
+ optional string invalidParameter
+
+# Details for issues about documents in Quirks Mode
+# or Limited Quirks Mode that affects page layouting.
+ type QuirksModeIssueDetails extends object
+ properties
+ # If false, it means the document's mode is "quirks"
+ # instead of "limited-quirks".
+ boolean isLimitedQuirksMode
+ DOM.BackendNodeId documentNodeId
+ string url
+ Page.FrameId frameId
+ Network.LoaderId loaderId
+
+ deprecated type NavigatorUserAgentIssueDetails extends object
+ properties
+ string url
+ optional SourceCodeLocation location
+
+ type SharedDictionaryIssueDetails extends object
+ properties
+ SharedDictionaryError sharedDictionaryError
+ AffectedRequest request
+
+ type SRIMessageSignatureIssueDetails extends object
+ properties
+ SRIMessageSignatureError error
+ string signatureBase
+ array of string integrityAssertions
+ AffectedRequest request
+
+ type UnencodedDigestIssueDetails extends object
+ properties
+ UnencodedDigestError error
+ AffectedRequest request
+
+ type GenericIssueErrorType extends string
+ enum
+ FormLabelForNameError
+ FormDuplicateIdForInputError
+ FormInputWithNoLabelError
+ FormAutocompleteAttributeEmptyError
+ FormEmptyIdAndNameAttributesForInputError
+ FormAriaLabelledByToNonExistingId
+ FormInputAssignedAutocompleteValueToIdOrNameAttributeError
+ FormLabelHasNeitherForNorNestedInput
+ FormLabelForMatchesNonExistingIdError
+ FormInputHasWrongButWellIntendedAutocompleteValueError
+ ResponseWasBlockedByORB
+
+ # Depending on the concrete errorType, different properties are set.
+ type GenericIssueDetails extends object
+ properties
+ # Issues with the same errorType are aggregated in the frontend.
+ GenericIssueErrorType errorType
+ optional Page.FrameId frameId
+ optional DOM.BackendNodeId violatingNodeId
+ optional string violatingNodeAttribute
+ optional AffectedRequest request
+
+ # This issue tracks information needed to print a deprecation message.
+ # https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
+ type DeprecationIssueDetails extends object
+ properties
+ optional AffectedFrame affectedFrame
+ SourceCodeLocation sourceCodeLocation
+ # One of the deprecation names from third_party/blink/renderer/core/frame/deprecation/deprecation.json5
+ string type
+
+ # This issue warns about sites in the redirect chain of a finished navigation
+ # that may be flagged as trackers and have their state cleared if they don't
+ # receive a user interaction. Note that in this context 'site' means eTLD+1.
+ # For example, if the URL `https://example.test:80/bounce` was in the
+ # redirect chain, the site reported would be `example.test`.
+ type BounceTrackingIssueDetails extends object
+ properties
+ array of string trackingSites
+
+ # This issue warns about third-party sites that are accessing cookies on the
+ # current page, and have been permitted due to having a global metadata grant.
+ # Note that in this context 'site' means eTLD+1. For example, if the URL
+ # `https://example.test:80/web_page` was accessing cookies, the site reported
+ # would be `example.test`.
+ type CookieDeprecationMetadataIssueDetails extends object
+ properties
+ array of string allowedSites
+ number optOutPercentage
+ boolean isOptOutTopLevel
+ CookieOperation operation
+
+ type ClientHintIssueReason extends string
+ enum
+ # Items in the accept-ch meta tag allow list must be valid origins.
+ # No special values (e.g. self, none, and *) are permitted.
+ MetaTagAllowListInvalidOrigin
+ # Only accept-ch meta tags in the original HTML sent from the server
+ # are respected. Any injected via javascript (or other means) are ignored.
+ MetaTagModifiedHTML
+
+ type FederatedAuthRequestIssueDetails extends object
+ properties
+ FederatedAuthRequestIssueReason federatedAuthRequestIssueReason
+
+ # 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.
+ type FederatedAuthRequestIssueReason extends string
+ enum
+ ShouldEmbargo
+ TooManyRequests
+ WellKnownHttpNotFound
+ WellKnownNoResponse
+ WellKnownInvalidResponse
+ WellKnownListEmpty
+ WellKnownInvalidContentType
+ ConfigNotInWellKnown
+ WellKnownTooBig
+ ConfigHttpNotFound
+ ConfigNoResponse
+ ConfigInvalidResponse
+ ConfigInvalidContentType
+ ClientMetadataHttpNotFound
+ ClientMetadataNoResponse
+ ClientMetadataInvalidResponse
+ ClientMetadataInvalidContentType
+ IdpNotPotentiallyTrustworthy
+ DisabledInSettings
+ DisabledInFlags
+ ErrorFetchingSignin
+ InvalidSigninResponse
+ AccountsHttpNotFound
+ AccountsNoResponse
+ AccountsInvalidResponse
+ AccountsListEmpty
+ AccountsInvalidContentType
+ IdTokenHttpNotFound
+ IdTokenNoResponse
+ IdTokenInvalidResponse
+ IdTokenIdpErrorResponse
+ IdTokenCrossSiteIdpErrorResponse
+ IdTokenInvalidRequest
+ IdTokenInvalidContentType
+ ErrorIdToken
+ Canceled
+ RpPageNotVisible
+ SilentMediationFailure
+ ThirdPartyCookiesBlocked
+ NotSignedInWithIdp
+ MissingTransientUserActivation
+ ReplacedByActiveMode
+ InvalidFieldsSpecified
+ RelyingPartyOriginIsOpaque
+ TypeNotMatching
+ UiDismissedNoEmbargo
+ CorsError
+ SuppressedBySegmentationPlatform
+
+ type FederatedAuthUserInfoRequestIssueDetails extends object
+ properties
+ FederatedAuthUserInfoRequestIssueReason federatedAuthUserInfoRequestIssueReason
+
+ # Represents the failure reason when a getUserInfo() call fails.
+ # Should be updated alongside FederatedAuthUserInfoRequestResult in
+ # third_party/blink/public/mojom/devtools/inspector_issue.mojom.
+ type FederatedAuthUserInfoRequestIssueReason extends string
+ enum
+ NotSameOrigin
+ NotIframe
+ NotPotentiallyTrustworthy
+ NoApiPermission
+ NotSignedInWithIdp
+ NoAccountSharingPermission
+ InvalidConfigOrWellKnown
+ InvalidAccountsResponse
+ NoReturningUserFromFetchedAccounts
+
+ # This issue tracks client hints related issues. It's used to deprecate old
+ # features, encourage the use of new ones, and provide general guidance.
+ type ClientHintIssueDetails extends object
+ properties
+ SourceCodeLocation sourceCodeLocation
+ ClientHintIssueReason clientHintIssueReason
+
+ type FailedRequestInfo extends object
+ properties
+ # The URL that failed to load.
+ string url
+ # The failure message for the failed request.
+ string failureMessage
+ optional Network.RequestId requestId
+
+ type PartitioningBlobURLInfo extends string
+ enum
+ BlockedCrossPartitionFetching
+ EnforceNoopenerForNavigation
+
+ type PartitioningBlobURLIssueDetails extends object
+ properties
+ # The BlobURL that failed to load.
+ string url
+ # Additional information about the Partitioning Blob URL issue.
+ PartitioningBlobURLInfo partitioningBlobURLInfo
+
+ type ElementAccessibilityIssueReason extends string
+ enum
+ DisallowedSelectChild
+ DisallowedOptGroupChild
+ NonPhrasingContentOptionChild
+ InteractiveContentOptionChild
+ InteractiveContentLegendChild
+ InteractiveContentSummaryDescendant
+
+ # This issue warns about errors in the select or summary element content model.
+ type ElementAccessibilityIssueDetails extends object
+ properties
+ DOM.BackendNodeId nodeId
+ ElementAccessibilityIssueReason elementAccessibilityIssueReason
+ boolean hasDisallowedAttributes
+
+ type StyleSheetLoadingIssueReason extends string
+ enum
+ LateImportRule
+ RequestFailed
+
+ # This issue warns when a referenced stylesheet couldn't be loaded.
+ type StylesheetLoadingIssueDetails extends object
+ properties
+ # Source code position that referenced the failing stylesheet.
+ SourceCodeLocation sourceCodeLocation
+ # Reason why the stylesheet couldn't be loaded.
+ StyleSheetLoadingIssueReason styleSheetLoadingIssueReason
+ # Contains additional info when the failure was due to a request.
+ optional FailedRequestInfo failedRequestInfo
+
+ type PropertyRuleIssueReason extends string
+ enum
+ InvalidSyntax
+ InvalidInitialValue
+ InvalidInherits
+ InvalidName
+
+ # This issue warns about errors in property rules that lead to property
+ # registrations being ignored.
+ type PropertyRuleIssueDetails extends object
+ properties
+ # Source code position of the property rule.
+ SourceCodeLocation sourceCodeLocation
+ # Reason why the property rule was discarded.
+ PropertyRuleIssueReason propertyRuleIssueReason
+ # The value of the property rule property that failed to parse
+ optional string propertyValue
+
+ type UserReidentificationIssueType extends string
+ enum
+ BlockedFrameNavigation
+ BlockedSubresource
+ NoisedCanvasReadback
+
+ # This issue warns about uses of APIs that may be considered misuse to
+ # re-identify users.
+ type UserReidentificationIssueDetails extends object
+ properties
+ UserReidentificationIssueType type
+ # Applies to BlockedFrameNavigation and BlockedSubresource issue types.
+ optional AffectedRequest request
+ # Applies to NoisedCanvasReadback issue type.
+ optional SourceCodeLocation sourceCodeLocation
+
+ # 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.
+ type InspectorIssueCode extends string
+ enum
+ CookieIssue
+ MixedContentIssue
+ BlockedByResponseIssue
+ HeavyAdIssue
+ ContentSecurityPolicyIssue
+ SharedArrayBufferIssue
+ LowTextContrastIssue
+ CorsIssue
+ AttributionReportingIssue
+ QuirksModeIssue
+ PartitioningBlobURLIssue
+ # Deprecated
+ NavigatorUserAgentIssue
+ GenericIssue
+ DeprecationIssue
+ ClientHintIssue
+ FederatedAuthRequestIssue
+ BounceTrackingIssue
+ CookieDeprecationMetadataIssue
+ StylesheetLoadingIssue
+ FederatedAuthUserInfoRequestIssue
+ PropertyRuleIssue
+ SharedDictionaryIssue
+ ElementAccessibilityIssue
+ SRIMessageSignatureIssue
+ UnencodedDigestIssue
+ UserReidentificationIssue
+
+ # 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.
+ type InspectorIssueDetails extends object
+ properties
+ optional CookieIssueDetails cookieIssueDetails
+ optional MixedContentIssueDetails mixedContentIssueDetails
+ optional BlockedByResponseIssueDetails blockedByResponseIssueDetails
+ optional HeavyAdIssueDetails heavyAdIssueDetails
+ optional ContentSecurityPolicyIssueDetails contentSecurityPolicyIssueDetails
+ optional SharedArrayBufferIssueDetails sharedArrayBufferIssueDetails
+ optional LowTextContrastIssueDetails lowTextContrastIssueDetails
+ optional CorsIssueDetails corsIssueDetails
+ optional AttributionReportingIssueDetails attributionReportingIssueDetails
+ optional QuirksModeIssueDetails quirksModeIssueDetails
+ optional PartitioningBlobURLIssueDetails partitioningBlobURLIssueDetails
+ deprecated optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
+ optional GenericIssueDetails genericIssueDetails
+ optional DeprecationIssueDetails deprecationIssueDetails
+ optional ClientHintIssueDetails clientHintIssueDetails
+ optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
+ optional BounceTrackingIssueDetails bounceTrackingIssueDetails
+ optional CookieDeprecationMetadataIssueDetails cookieDeprecationMetadataIssueDetails
+ optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
+ optional PropertyRuleIssueDetails propertyRuleIssueDetails
+ optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
+ optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
+ optional ElementAccessibilityIssueDetails elementAccessibilityIssueDetails
+ optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
+ optional UnencodedDigestIssueDetails unencodedDigestIssueDetails
+ optional UserReidentificationIssueDetails userReidentificationIssueDetails
+
+ # A unique id for a DevTools inspector issue. Allows other entities (e.g.
+ # exceptions, CDP message, console messages, etc.) to reference an issue.
+ type IssueId extends string
+
+ # An inspector issue reported from the back-end.
+ type InspectorIssue extends object
+ properties
+ InspectorIssueCode code
+ InspectorIssueDetails details
+ # A unique id for this issue. May be omitted if no other entity (e.g.
+ # exception, CDP message, etc.) is referencing this issue.
+ optional IssueId issueId
+
+ # Returns the response body and size if it were re-encoded with the specified settings. Only
+ # applies to images.
+ command getEncodedResponse
+ parameters
+ # Identifier of the network request to get content for.
+ Network.RequestId requestId
+ # The encoding to use.
+ enum encoding
+ webp
+ jpeg
+ png
+ # The quality of the encoding (0-1). (defaults to 1)
+ optional number quality
+ # Whether to only return the size information (defaults to false).
+ optional boolean sizeOnly
+ returns
+ # The encoded body as a base64 string. Omitted if sizeOnly is true.
+ optional binary body
+ # Size before re-encoding.
+ integer originalSize
+ # Size after re-encoding.
+ integer encodedSize
+
+ # Disables issues domain, prevents further issues from being reported to the client.
+ command disable
+
+ # Enables issues domain, sends the issues collected so far to the client by means of the
+ # `issueAdded` event.
+ command enable
+
+ # Runs the contrast check for the target page. Found issues are reported
+ # using Audits.issueAdded event.
+ command checkContrast
+ parameters
+ # Whether to report WCAG AAA level issues. Default is false.
+ optional boolean reportAAA
+
+ # Runs the form issues check for the target page. Found issues are reported
+ # using Audits.issueAdded event.
+ command checkFormsIssues
+ returns
+ array of GenericIssueDetails formIssues
+
+ event issueAdded
+ parameters
+ InspectorIssue issue
diff --git a/pdl/domains/Autofill.pdl b/pdl/domains/Autofill.pdl
new file mode 100644
index 00000000..bafa83a2
--- /dev/null
+++ b/pdl/domains/Autofill.pdl
@@ -0,0 +1,106 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Defines commands and events for Autofill.
+experimental domain Autofill
+ type CreditCard extends object
+ properties
+ # 16-digit credit card number.
+ string number
+ # Name of the credit card owner.
+ string name
+ # 2-digit expiry month.
+ string expiryMonth
+ # 4-digit expiry year.
+ string expiryYear
+ # 3-digit card verification code.
+ string cvc
+
+ type AddressField extends object
+ properties
+ # address field name, for example GIVEN_NAME.
+ string name
+ # address field value, for example Jon Doe.
+ string value
+
+ # A list of address fields.
+ type AddressFields extends object
+ properties
+ array of AddressField fields
+
+ type Address extends object
+ properties
+ # fields and values defining an address.
+ array of AddressField fields
+
+ # Defines how an address can be displayed like in chrome://settings/addresses.
+ # Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
+ # The following address UI for instance:
+ # [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
+ # should allow the receiver to render:
+ # Jon Doe
+ # Munich 81456
+ type AddressUI extends object
+ properties
+ # A two dimension array containing the representation of values from an address profile.
+ array of AddressFields addressFields
+
+ # Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
+ type FillingStrategy extends string
+ enum
+ autocompleteAttribute
+ autofillInferred
+
+ type FilledField extends object
+ properties
+ # The type of the field, e.g text, password etc.
+ string htmlType
+ # the html id
+ string id
+ # the html name
+ string name
+ # the field value
+ string value
+ # The actual field type, e.g FAMILY_NAME
+ string autofillType
+ # The filling strategy
+ FillingStrategy fillingStrategy
+ # The frame the field belongs to
+ Page.FrameId frameId
+ # The form field's DOM node
+ DOM.BackendNodeId fieldId
+
+ # Emitted when an address form is filled.
+ event addressFormFilled
+ parameters
+ # Information about the fields that were filled
+ array of FilledField filledFields
+ # An UI representation of the address used to fill the form.
+ # Consists of a 2D array where each child represents an address/profile line.
+ AddressUI addressUi
+
+ # Trigger autofill on a form identified by the fieldId.
+ # If the field and related form cannot be autofilled, returns an error.
+ command trigger
+ parameters
+ # Identifies a field that serves as an anchor for autofill.
+ DOM.BackendNodeId fieldId
+ # Identifies the frame that field belongs to.
+ optional Page.FrameId frameId
+ # Credit card information to fill out the form. Credit card data is not saved.
+ CreditCard card
+
+ # Set addresses so that developers can verify their forms implementation.
+ command setAddresses
+ # Test addresses for the available countries.
+ parameters
+ array of Address addresses
+
+ # Disables autofill domain notifications.
+ command disable
+
+ # Enables autofill domain notifications.
+ command enable
diff --git a/pdl/domains/BackgroundService.pdl b/pdl/domains/BackgroundService.pdl
new file mode 100644
index 00000000..fc96ca5b
--- /dev/null
+++ b/pdl/domains/BackgroundService.pdl
@@ -0,0 +1,77 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Defines events for background web platform features.
+experimental domain BackgroundService
+ # The Background Service that will be associated with the commands/events.
+ # Every Background Service operates independently, but they share the same
+ # API.
+ type ServiceName extends string
+ enum
+ backgroundFetch
+ backgroundSync
+ pushMessaging
+ notifications
+ paymentHandler
+ periodicBackgroundSync
+
+ # Enables event updates for the service.
+ command startObserving
+ parameters
+ ServiceName service
+
+ # Disables event updates for the service.
+ command stopObserving
+ parameters
+ ServiceName service
+
+ # Set the recording state for the service.
+ command setRecording
+ parameters
+ boolean shouldRecord
+ ServiceName service
+
+ # Clears all stored data for the service.
+ command clearEvents
+ parameters
+ ServiceName service
+
+ # Called when the recording state for the service has been updated.
+ event recordingStateChanged
+ parameters
+ boolean isRecording
+ ServiceName service
+
+ # A key-value pair for additional event information to pass along.
+ type EventMetadata extends object
+ properties
+ string key
+ string value
+
+ type BackgroundServiceEvent extends object
+ properties
+ # Timestamp of the event (in seconds).
+ Network.TimeSinceEpoch timestamp
+ # The origin this event belongs to.
+ string origin
+ # The Service Worker ID that initiated the event.
+ ServiceWorker.RegistrationID serviceWorkerRegistrationId
+ # The Background Service this event belongs to.
+ ServiceName service
+ # A description of the event.
+ string eventName
+ # An identifier that groups related events together.
+ string instanceId
+ # A list of event-specific information.
+ array of EventMetadata eventMetadata
+ # Storage key this event belongs to.
+ string storageKey
+
+ # Called with all existing backgroundServiceEvents when enabled, and all new
+ # events afterwards if enabled and recording.
+ event backgroundServiceEventReceived
+ parameters
+ BackgroundServiceEvent backgroundServiceEvent
diff --git a/pdl/domains/BluetoothEmulation.pdl b/pdl/domains/BluetoothEmulation.pdl
new file mode 100644
index 00000000..261e3784
--- /dev/null
+++ b/pdl/domains/BluetoothEmulation.pdl
@@ -0,0 +1,227 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows configuring virtual Bluetooth devices to test
+# the web-bluetooth API.
+experimental domain BluetoothEmulation
+ # Indicates the various states of Central.
+ type CentralState extends string
+ enum
+ absent
+ powered-off
+ powered-on
+
+ # Indicates the various types of GATT event.
+ type GATTOperationType extends string
+ enum
+ connection
+ discovery
+
+ # Indicates the various types of characteristic write.
+ type CharacteristicWriteType extends string
+ enum
+ write-default-deprecated
+ write-with-response
+ write-without-response
+
+ # Indicates the various types of characteristic operation.
+ type CharacteristicOperationType extends string
+ enum
+ read
+ write
+ subscribe-to-notifications
+ unsubscribe-from-notifications
+
+ # Indicates the various types of descriptor operation.
+ type DescriptorOperationType extends string
+ enum
+ read
+ write
+
+ # Stores the manufacturer data
+ type ManufacturerData extends object
+ properties
+ # Company identifier
+ # https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
+ # https://usb.org/developers
+ integer key
+ # Manufacturer-specific data
+ binary data
+
+ # Stores the byte data of the advertisement packet sent by a Bluetooth device.
+ type ScanRecord extends object
+ properties
+ optional string name
+ optional array of string uuids
+ # Stores the external appearance description of the device.
+ optional integer appearance
+ # Stores the transmission power of a broadcasting device.
+ optional integer txPower
+ # Key is the company identifier and the value is an array of bytes of
+ # manufacturer specific data.
+ optional array of ManufacturerData manufacturerData
+
+ # Stores the advertisement packet information that is sent by a Bluetooth device.
+ type ScanEntry extends object
+ properties
+ string deviceAddress
+ integer rssi
+ ScanRecord scanRecord
+
+ # Describes the properties of a characteristic. This follows Bluetooth Core
+ # Specification BT 4.2 Vol 3 Part G 3.3.1. Characteristic Properties.
+ type CharacteristicProperties extends object
+ properties
+ optional boolean broadcast
+ optional boolean read
+ optional boolean writeWithoutResponse
+ optional boolean write
+ optional boolean notify
+ optional boolean indicate
+ optional boolean authenticatedSignedWrites
+ optional boolean extendedProperties
+
+ # Enable the BluetoothEmulation domain.
+ command enable
+ parameters
+ # State of the simulated central.
+ CentralState state
+ # If the simulated central supports low-energy.
+ boolean leSupported
+
+ # Set the state of the simulated central.
+ command setSimulatedCentralState
+ parameters
+ # State of the simulated central.
+ CentralState state
+
+ # Disable the BluetoothEmulation domain.
+ command disable
+
+ # Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+ # that has already been connected to the system.
+ command simulatePreconnectedPeripheral
+ parameters
+ string address
+ string name
+ array of ManufacturerData manufacturerData
+ array of string knownServiceUuids
+
+ # Simulates an advertisement packet described in |entry| being received by
+ # the central.
+ command simulateAdvertisement
+ parameters
+ ScanEntry entry
+
+ # Simulates the response code from the peripheral with |address| for a
+ # GATT operation of |type|. The |code| value follows the HCI Error Codes from
+ # Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
+ command simulateGATTOperationResponse
+ parameters
+ string address
+ GATTOperationType type
+ integer code
+
+ # Simulates the response from the characteristic with |characteristicId| for a
+ # characteristic operation of |type|. The |code| value follows the Error
+ # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
+ # The |data| is expected to exist when simulating a successful read operation
+ # response.
+ command simulateCharacteristicOperationResponse
+ parameters
+ string characteristicId
+ CharacteristicOperationType type
+ integer code
+ optional binary data
+
+ # Simulates the response from the descriptor with |descriptorId| for a
+ # descriptor operation of |type|. The |code| value follows the Error
+ # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
+ # The |data| is expected to exist when simulating a successful read operation
+ # response.
+ command simulateDescriptorOperationResponse
+ parameters
+ string descriptorId
+ DescriptorOperationType type
+ integer code
+ optional binary data
+
+ # Adds a service with |serviceUuid| to the peripheral with |address|.
+ command addService
+ parameters
+ string address
+ string serviceUuid
+ returns
+ # An identifier that uniquely represents this service.
+ string serviceId
+
+ # Removes the service respresented by |serviceId| from the simulated central.
+ command removeService
+ parameters
+ string serviceId
+
+ # Adds a characteristic with |characteristicUuid| and |properties| to the
+ # service represented by |serviceId|.
+ command addCharacteristic
+ parameters
+ string serviceId
+ string characteristicUuid
+ CharacteristicProperties properties
+ returns
+ # An identifier that uniquely represents this characteristic.
+ string characteristicId
+
+ # Removes the characteristic respresented by |characteristicId| from the
+ # simulated central.
+ command removeCharacteristic
+ parameters
+ string characteristicId
+
+ # Adds a descriptor with |descriptorUuid| to the characteristic respresented
+ # by |characteristicId|.
+ command addDescriptor
+ parameters
+ string characteristicId
+ string descriptorUuid
+ returns
+ # An identifier that uniquely represents this descriptor.
+ string descriptorId
+
+ # Removes the descriptor with |descriptorId| from the simulated central.
+ command removeDescriptor
+ parameters
+ string descriptorId
+
+ # Simulates a GATT disconnection from the peripheral with |address|.
+ command simulateGATTDisconnection
+ parameters
+ string address
+
+ # Event for when a GATT operation of |type| to the peripheral with |address|
+ # happened.
+ event gattOperationReceived
+ parameters
+ string address
+ GATTOperationType type
+
+ # Event for when a characteristic operation of |type| to the characteristic
+ # respresented by |characteristicId| happened. |data| and |writeType| is
+ # expected to exist when |type| is write.
+ event characteristicOperationReceived
+ parameters
+ string characteristicId
+ CharacteristicOperationType type
+ optional binary data
+ optional CharacteristicWriteType writeType
+
+ # Event for when a descriptor operation of |type| to the descriptor
+ # respresented by |descriptorId| happened. |data| is expected to exist when
+ # |type| is write.
+ event descriptorOperationReceived
+ parameters
+ string descriptorId
+ DescriptorOperationType type
+ optional binary data
diff --git a/pdl/domains/Browser.pdl b/pdl/domains/Browser.pdl
new file mode 100644
index 00000000..3c980f50
--- /dev/null
+++ b/pdl/domains/Browser.pdl
@@ -0,0 +1,345 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# The Browser domain defines methods and events for browser managing.
+domain Browser
+ experimental type BrowserContextID extends string
+ experimental type WindowID extends integer
+
+ # The state of the browser window.
+ experimental type WindowState extends string
+ enum
+ normal
+ minimized
+ maximized
+ fullscreen
+
+ # Browser window bounds information
+ experimental type Bounds extends object
+ properties
+ # The offset from the left edge of the screen to the window in pixels.
+ optional integer left
+ # The offset from the top edge of the screen to the window in pixels.
+ optional integer top
+ # The window width in pixels.
+ optional integer width
+ # The window height in pixels.
+ optional integer height
+ # The window state. Default to normal.
+ optional WindowState windowState
+
+ experimental type PermissionType extends string
+ enum
+ ar
+ audioCapture
+ automaticFullscreen
+ backgroundFetch
+ backgroundSync
+ cameraPanTiltZoom
+ capturedSurfaceControl
+ clipboardReadWrite
+ clipboardSanitizedWrite
+ displayCapture
+ durableStorage
+ geolocation
+ handTracking
+ idleDetection
+ keyboardLock
+ localFonts
+ localNetworkAccess
+ midi
+ midiSysex
+ nfc
+ notifications
+ paymentHandler
+ periodicBackgroundSync
+ pointerLock
+ protectedMediaIdentifier
+ sensors
+ smartCard
+ speakerSelection
+ storageAccess
+ topLevelStorageAccess
+ videoCapture
+ vr
+ wakeLockScreen
+ wakeLockSystem
+ webAppInstallation
+ webPrinting
+ windowManagement
+
+ experimental type PermissionSetting extends string
+ enum
+ granted
+ denied
+ prompt
+
+ # Definition of PermissionDescriptor defined in the Permissions API:
+ # https://w3c.github.io/permissions/#dom-permissiondescriptor.
+ experimental type PermissionDescriptor extends object
+ properties
+ # Name of permission.
+ # See https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/permissions/permission_descriptor.idl for valid permission names.
+ string name
+ # For "midi" permission, may also specify sysex control.
+ optional boolean sysex
+ # For "push" permission, may specify userVisibleOnly.
+ # Note that userVisibleOnly = true is the only currently supported type.
+ optional boolean userVisibleOnly
+ # For "clipboard" permission, may specify allowWithoutSanitization.
+ optional boolean allowWithoutSanitization
+ # For "fullscreen" permission, must specify allowWithoutGesture:true.
+ optional boolean allowWithoutGesture
+ # For "camera" permission, may specify panTiltZoom.
+ optional boolean panTiltZoom
+
+ # Browser command ids used by executeBrowserCommand.
+ experimental type BrowserCommandId extends string
+ enum
+ openTabSearch
+ closeTabSearch
+ openGlic
+
+ # Set permission settings for given origin.
+ experimental command setPermission
+ parameters
+ # Descriptor of permission to override.
+ PermissionDescriptor permission
+ # Setting of the permission.
+ PermissionSetting setting
+ # Origin the permission applies to, all origins if not specified.
+ optional string origin
+ # Context to override. When omitted, default browser context is used.
+ optional BrowserContextID browserContextId
+
+ # Grant specific permissions to the given origin and reject all others.
+ experimental command grantPermissions
+ parameters
+ array of PermissionType permissions
+ # Origin the permission applies to, all origins if not specified.
+ optional string origin
+ # BrowserContext to override permissions. When omitted, default browser context is used.
+ optional BrowserContextID browserContextId
+
+ # Reset all permission management for all origins.
+ command resetPermissions
+ parameters
+ # BrowserContext to reset permissions. When omitted, default browser context is used.
+ optional BrowserContextID browserContextId
+
+ # Set the behavior when downloading a file.
+ experimental command setDownloadBehavior
+ parameters
+ # Whether to allow all or deny all download requests, or use default Chrome behavior if
+ # available (otherwise deny). |allowAndName| allows download and names files according to
+ # their download guids.
+ enum behavior
+ deny
+ allow
+ allowAndName
+ default
+ # BrowserContext to set download behavior. When omitted, default browser context is used.
+ optional BrowserContextID browserContextId
+ # The default path to save downloaded files to. This is required if behavior is set to 'allow'
+ # or 'allowAndName'.
+ optional string downloadPath
+ # Whether to emit download events (defaults to false).
+ optional boolean eventsEnabled
+
+ # Cancel a download if in progress
+ experimental command cancelDownload
+ parameters
+ # Global unique identifier of the download.
+ string guid
+ # BrowserContext to perform the action in. When omitted, default browser context is used.
+ optional BrowserContextID browserContextId
+
+ # Fired when page is about to start a download.
+ experimental event downloadWillBegin
+ parameters
+ # Id of the frame that caused the download to begin.
+ Page.FrameId frameId
+ # Global unique identifier of the download.
+ string guid
+ # URL of the resource being downloaded.
+ string url
+ # Suggested file name of the resource (the actual name of the file saved on disk may differ).
+ string suggestedFilename
+
+ # Fired when download makes progress. Last call has |done| == true.
+ experimental event downloadProgress
+ parameters
+ # Global unique identifier of the download.
+ string guid
+ # Total expected bytes to download.
+ number totalBytes
+ # Total bytes received.
+ number receivedBytes
+ # Download status.
+ enum state
+ inProgress
+ completed
+ canceled
+ # If download is "completed", provides the path of the downloaded file.
+ # Depending on the platform, it is not guaranteed to be set, nor the file
+ # is guaranteed to exist.
+ experimental optional string filePath
+
+ # Close browser gracefully.
+ command close
+
+ # Crashes browser on the main thread.
+ experimental command crash
+
+ # Crashes GPU process.
+ experimental command crashGpuProcess
+
+ # Returns version information.
+ command getVersion
+ returns
+ # Protocol version.
+ string protocolVersion
+ # Product name.
+ string product
+ # Product revision.
+ string revision
+ # User-Agent.
+ string userAgent
+ # V8 version.
+ string jsVersion
+
+ # Returns the command line switches for the browser process if, and only if
+ # --enable-automation is on the commandline.
+ experimental command getBrowserCommandLine
+ returns
+ # Commandline parameters
+ array of string arguments
+
+ # Chrome histogram bucket.
+ experimental type Bucket extends object
+ properties
+ # Minimum value (inclusive).
+ integer low
+ # Maximum value (exclusive).
+ integer high
+ # Number of samples.
+ integer count
+
+ # Chrome histogram.
+ experimental type Histogram extends object
+ properties
+ # Name.
+ string name
+ # Sum of sample values.
+ integer sum
+ # Total number of samples.
+ integer count
+ # Buckets.
+ array of Bucket buckets
+
+ # Get Chrome histograms.
+ experimental command getHistograms
+ parameters
+ # Requested substring in name. Only histograms which have query as a
+ # substring in their name are extracted. An empty or absent query returns
+ # all histograms.
+ optional string query
+ # If true, retrieve delta since last delta call.
+ optional boolean delta
+
+ returns
+ # Histograms.
+ array of Histogram histograms
+
+ # Get a Chrome histogram by name.
+ experimental command getHistogram
+ parameters
+ # Requested histogram name.
+ string name
+ # If true, retrieve delta since last delta call.
+ optional boolean delta
+ returns
+ # Histogram.
+ Histogram histogram
+
+ # Get position and size of the browser window.
+ experimental command getWindowBounds
+ parameters
+ # Browser window id.
+ WindowID windowId
+ returns
+ # Bounds information of the window. When window state is 'minimized', the restored window
+ # position and size are returned.
+ Bounds bounds
+
+ # Get the browser window that contains the devtools target.
+ experimental command getWindowForTarget
+ parameters
+ # Devtools agent host id. If called as a part of the session, associated targetId is used.
+ optional Target.TargetID targetId
+ returns
+ # Browser window id.
+ WindowID windowId
+ # Bounds information of the window. When window state is 'minimized', the restored window
+ # position and size are returned.
+ Bounds bounds
+
+ # Set position and/or size of the browser window.
+ experimental command setWindowBounds
+ parameters
+ # Browser window id.
+ WindowID windowId
+ # New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
+ # with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
+ Bounds bounds
+
+ # Set size of the browser contents resizing browser window as necessary.
+ experimental command setContentsSize
+ parameters
+ # Browser window id.
+ WindowID windowId
+ # The window contents width in DIP. Assumes current width if omitted.
+ # Must be specified if 'height' is omitted.
+ optional integer width
+ # The window contents height in DIP. Assumes current height if omitted.
+ # Must be specified if 'width' is omitted.
+ optional integer height
+
+ # Set dock tile details, platform-specific.
+ experimental command setDockTile
+ parameters
+ optional string badgeLabel
+ # Png encoded image.
+ optional binary image
+
+ # Invoke custom browser commands used by telemetry.
+ experimental command executeBrowserCommand
+ parameters
+ BrowserCommandId commandId
+
+ # Allows a site to use privacy sandbox features that require enrollment
+ # without the site actually being enrolled. Only supported on page targets.
+ command addPrivacySandboxEnrollmentOverride
+ parameters
+ string url
+
+ experimental type PrivacySandboxAPI extends string
+ enum
+ BiddingAndAuctionServices
+ TrustedKeyValue
+
+ # Configures encryption keys used with a given privacy sandbox API to talk
+ # to a trusted coordinator. Since this is intended for test automation only,
+ # coordinatorOrigin must be a .test domain. No existing coordinator
+ # configuration for the origin may exist.
+ command addPrivacySandboxCoordinatorKeyConfig
+ parameters
+ PrivacySandboxAPI api
+ string coordinatorOrigin
+ string keyConfig
+ # BrowserContext to perform the action in. When omitted, default browser
+ # context is used.
+ optional BrowserContextID browserContextId
diff --git a/pdl/domains/CSS.pdl b/pdl/domains/CSS.pdl
new file mode 100644
index 00000000..e19aaed6
--- /dev/null
+++ b/pdl/domains/CSS.pdl
@@ -0,0 +1,996 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# 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.
+experimental domain CSS
+ depends on DOM
+ depends on Page
+
+ type StyleSheetId extends string
+
+ # 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.
+ type StyleSheetOrigin extends string
+ enum
+ injected
+ user-agent
+ inspector
+ regular
+
+ # CSS rule collection for a single pseudo style.
+ type PseudoElementMatches extends object
+ properties
+ # Pseudo element type.
+ DOM.PseudoType pseudoType
+ # Pseudo element custom ident.
+ optional string pseudoIdentifier
+ # Matches of CSS rules applicable to the pseudo style.
+ array of RuleMatch matches
+
+ # CSS style coming from animations with the name of the animation.
+ type CSSAnimationStyle extends object
+ properties
+ # The name of the animation.
+ optional string name
+ # The style coming from the animation.
+ CSSStyle style
+
+ # Inherited CSS rule collection from ancestor node.
+ type InheritedStyleEntry extends object
+ properties
+ # The ancestor node's inline style, if any, in the style inheritance chain.
+ optional CSSStyle inlineStyle
+ # Matches of CSS rules matching the ancestor node in the style inheritance chain.
+ array of RuleMatch matchedCSSRules
+
+ # Inherited CSS style collection for animated styles from ancestor node.
+ type InheritedAnimatedStyleEntry extends object
+ properties
+ # Styles coming from the animations of the ancestor, if any, in the style inheritance chain.
+ optional array of CSSAnimationStyle animationStyles
+ # The style coming from the transitions of the ancestor, if any, in the style inheritance chain.
+ optional CSSStyle transitionsStyle
+
+ # Inherited pseudo element matches from pseudos of an ancestor node.
+ type InheritedPseudoElementMatches extends object
+ properties
+ # Matches of pseudo styles from the pseudos of an ancestor node.
+ array of PseudoElementMatches pseudoElements
+
+ # Match data for a CSS rule.
+ type RuleMatch extends object
+ properties
+ # CSS rule in the match.
+ CSSRule rule
+ # Matching selector indices in the rule's selectorList selectors (0-based).
+ array of integer matchingSelectors
+
+ # Data for a simple selector (these are delimited by commas in a selector list).
+ type Value extends object
+ properties
+ # Value text.
+ string text
+ # Value range in the underlying resource (if available).
+ optional SourceRange range
+ # Specificity of the selector.
+ experimental optional Specificity specificity
+
+ # Specificity:
+ # https://drafts.csswg.org/selectors/#specificity-rules
+ experimental type Specificity extends object
+ properties
+ # The a component, which represents the number of ID selectors.
+ integer a
+ # The b component, which represents the number of class selectors, attributes selectors, and
+ # pseudo-classes.
+ integer b
+ # The c component, which represents the number of type selectors and pseudo-elements.
+ integer c
+
+ # Selector list data.
+ type SelectorList extends object
+ properties
+ # Selectors in the list.
+ array of Value selectors
+ # Rule selector text.
+ string text
+
+ # CSS stylesheet metainformation.
+ type CSSStyleSheetHeader extends object
+ properties
+ # The stylesheet identifier.
+ StyleSheetId styleSheetId
+ # Owner frame identifier.
+ Page.FrameId frameId
+ # Stylesheet resource URL. Empty if this is a constructed stylesheet created using
+ # new CSSStyleSheet() (but non-empty if this is a constructed stylesheet imported
+ # as a CSS module script).
+ string sourceURL
+ # URL of source map associated with the stylesheet (if any).
+ optional string sourceMapURL
+ # Stylesheet origin.
+ StyleSheetOrigin origin
+ # Stylesheet title.
+ string title
+ # The backend id for the owner node of the stylesheet.
+ optional DOM.BackendNodeId ownerNode
+ # Denotes whether the stylesheet is disabled.
+ boolean disabled
+ # Whether the sourceURL field value comes from the sourceURL comment.
+ optional boolean hasSourceURL
+ # Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
+ # document.written STYLE tags.
+ boolean isInline
+ # Whether this stylesheet is mutable. Inline stylesheets become mutable
+ # after they have been modified via CSSOM API.
+ # `<link>` element's stylesheets become mutable only if DevTools modifies them.
+ # Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
+ boolean isMutable
+ # True if this stylesheet is created through new CSSStyleSheet() or imported as a
+ # CSS module script.
+ boolean isConstructed
+ # Line offset of the stylesheet within the resource (zero based).
+ number startLine
+ # Column offset of the stylesheet within the resource (zero based).
+ number startColumn
+ # Size of the content (in characters).
+ number length
+ # Line offset of the end of the stylesheet within the resource (zero based).
+ number endLine
+ # Column offset of the end of the stylesheet within the resource (zero based).
+ number endColumn
+ # If the style sheet was loaded from a network resource, this indicates when the resource failed to load
+ experimental optional boolean loadingFailed
+
+ # CSS rule representation.
+ type CSSRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Rule selector data.
+ SelectorList selectorList
+ # Array of selectors from ancestor style rules, sorted by distance from the current rule.
+ experimental optional array of string nestingSelectors
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated style declaration.
+ CSSStyle style
+ # Media list array (for rules involving media queries). The array enumerates media queries
+ # starting with the innermost one, going outwards.
+ optional array of CSSMedia media
+ # Container query list array (for rules involving container queries).
+ # The array enumerates container queries starting with the innermost one, going outwards.
+ experimental optional array of CSSContainerQuery containerQueries
+ # @supports CSS at-rule array.
+ # The array enumerates @supports at-rules starting with the innermost one, going outwards.
+ experimental optional array of CSSSupports supports
+ # Cascade layer array. Contains the layer hierarchy that this rule belongs to starting
+ # with the innermost layer and going outwards.
+ experimental optional array of CSSLayer layers
+ # @scope CSS at-rule array.
+ # The array enumerates @scope at-rules starting with the innermost one, going outwards.
+ experimental optional array of CSSScope scopes
+ # The array keeps the types of ancestor CSSRules from the innermost going outwards.
+ experimental optional array of CSSRuleType ruleTypes
+ # @starting-style CSS at-rule array.
+ # The array enumerates @starting-style at-rules starting with the innermost one, going outwards.
+ experimental optional array of CSSStartingStyle startingStyles
+
+ # Enum indicating the type of a CSS rule, used to represent the order of a style rule's ancestors.
+ # This list only contains rule types that are collected during the ancestor rule collection.
+ experimental type CSSRuleType extends string
+ enum
+ MediaRule
+ SupportsRule
+ ContainerRule
+ LayerRule
+ ScopeRule
+ StyleRule
+ StartingStyleRule
+
+ # CSS coverage information.
+ type RuleUsage extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ StyleSheetId styleSheetId
+ # Offset of the start of the rule (including selector) from the beginning of the stylesheet.
+ number startOffset
+ # Offset of the end of the rule body from the beginning of the stylesheet.
+ number endOffset
+ # Indicates whether the rule was actually used by some element in the page.
+ boolean used
+
+ # Text range within a resource. All numbers are zero-based.
+ type SourceRange extends object
+ properties
+ # Start line of range.
+ integer startLine
+ # Start column of range (inclusive).
+ integer startColumn
+ # End line of range
+ integer endLine
+ # End column of range (exclusive).
+ integer endColumn
+
+ type ShorthandEntry extends object
+ properties
+ # Shorthand name.
+ string name
+ # Shorthand value.
+ string value
+ # Whether the property has "!important" annotation (implies `false` if absent).
+ optional boolean important
+
+ type CSSComputedStyleProperty extends object
+ properties
+ # Computed style property name.
+ string name
+ # Computed style property value.
+ string value
+
+ # CSS style representation.
+ type CSSStyle extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # CSS properties in the style.
+ array of CSSProperty cssProperties
+ # Computed values for all shorthands found in the style.
+ array of ShorthandEntry shorthandEntries
+ # Style declaration text (if available).
+ optional string cssText
+ # Style declaration range in the enclosing stylesheet (if available).
+ optional SourceRange range
+
+ # CSS property declaration data.
+ type CSSProperty extends object
+ properties
+ # The property name.
+ string name
+ # The property value.
+ string value
+ # Whether the property has "!important" annotation (implies `false` if absent).
+ optional boolean important
+ # Whether the property is implicit (implies `false` if absent).
+ optional boolean implicit
+ # The full property text as specified in the style.
+ optional string text
+ # Whether the property is understood by the browser (implies `true` if absent).
+ optional boolean parsedOk
+ # Whether the property is disabled by the user (present for source-based properties only).
+ optional boolean disabled
+ # The entire property range in the enclosing style declaration (if available).
+ optional SourceRange range
+ # Parsed longhand components of this property if it is a shorthand.
+ # This field will be empty if the given property is not a shorthand.
+ experimental optional array of CSSProperty longhandProperties
+
+ # CSS media rule descriptor.
+ type CSSMedia extends object
+ properties
+ # Media query text.
+ string text
+ # Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
+ # specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
+ # stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
+ # stylesheet's STYLE tag.
+ enum source
+ mediaRule
+ importRule
+ linkedSheet
+ inlineSheet
+ # URL of the document containing the media query description.
+ optional string sourceURL
+ # The associated rule (@media or @import) header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+ # Array of media queries.
+ optional array of MediaQuery mediaList
+
+ # Media query descriptor.
+ type MediaQuery extends object
+ properties
+ # Array of media query expressions.
+ array of MediaQueryExpression expressions
+ # Whether the media query condition is satisfied.
+ boolean active
+
+ # Media query expression descriptor.
+ type MediaQueryExpression extends object
+ properties
+ # Media query expression value.
+ number value
+ # Media query expression units.
+ string unit
+ # Media query expression feature.
+ string feature
+ # The associated range of the value text in the enclosing stylesheet (if available).
+ optional SourceRange valueRange
+ # Computed length of media query expression (if applicable).
+ optional number computedLength
+
+ # CSS container query rule descriptor.
+ experimental type CSSContainerQuery extends object
+ properties
+ # Container query text.
+ string text
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+ # Optional name for the container.
+ optional string name
+ # Optional physical axes queried for the container.
+ optional DOM.PhysicalAxes physicalAxes
+ # Optional logical axes queried for the container.
+ optional DOM.LogicalAxes logicalAxes
+ # true if the query contains scroll-state() queries.
+ optional boolean queriesScrollState
+ # true if the query contains anchored() queries.
+ optional boolean queriesAnchored
+
+ # CSS Supports at-rule descriptor.
+ experimental type CSSSupports extends object
+ properties
+ # Supports rule text.
+ string text
+ # Whether the supports condition is satisfied.
+ boolean active
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+
+ # CSS Scope at-rule descriptor.
+ experimental type CSSScope extends object
+ properties
+ # Scope rule text.
+ string text
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+
+ # CSS Layer at-rule descriptor.
+ experimental type CSSLayer extends object
+ properties
+ # Layer name.
+ string text
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+
+ # CSS Starting Style at-rule descriptor.
+ experimental type CSSStartingStyle extends object
+ properties
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+
+ # CSS Layer data.
+ experimental type CSSLayerData extends object
+ properties
+ # Layer name.
+ string name
+ # Direct sub-layers
+ optional array of CSSLayerData subLayers
+ # Layer order. The order determines the order of the layer in the cascade order.
+ # A higher number has higher priority in the cascade order.
+ number order
+
+ # Information about amount of glyphs that were rendered with given font.
+ type PlatformFontUsage extends object
+ properties
+ # Font's family name reported by platform.
+ string familyName
+ # Font's PostScript name reported by platform.
+ string postScriptName
+ # Indicates if the font was downloaded or resolved locally.
+ boolean isCustomFont
+ # Amount of glyphs that were rendered with this font.
+ number glyphCount
+
+ # Information about font variation axes for variable fonts
+ type FontVariationAxis extends object
+ properties
+ # The font-variation-setting tag (a.k.a. "axis tag").
+ string tag
+ # Human-readable variation name in the default language (normally, "en").
+ string name
+ # The minimum value (inclusive) the font supports for this tag.
+ number minValue
+ # The maximum value (inclusive) the font supports for this tag.
+ number maxValue
+ # The default value.
+ number defaultValue
+
+ # 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.
+ type FontFace extends object
+ properties
+ # The font-family.
+ string fontFamily
+ # The font-style.
+ string fontStyle
+ # The font-variant.
+ string fontVariant
+ # The font-weight.
+ string fontWeight
+ # The font-stretch.
+ string fontStretch
+ # The font-display.
+ string fontDisplay
+ # The unicode-range.
+ string unicodeRange
+ # The src.
+ string src
+ # The resolved platform font family
+ string platformFontFamily
+ # Available variation settings (a.k.a. "axes").
+ optional array of FontVariationAxis fontVariationAxes
+
+ # CSS try rule representation.
+ type CSSTryRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated style declaration.
+ CSSStyle style
+
+ # CSS @position-try rule representation.
+ type CSSPositionTryRule extends object
+ properties
+ # The prelude dashed-ident name
+ Value name
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated style declaration.
+ CSSStyle style
+ boolean active
+
+ # CSS keyframes rule representation.
+ type CSSKeyframesRule extends object
+ properties
+ # Animation name.
+ Value animationName
+ # List of keyframes.
+ array of CSSKeyframeRule keyframes
+
+ # Representation of a custom property registration through CSS.registerProperty
+ type CSSPropertyRegistration extends object
+ properties
+ string propertyName
+ optional Value initialValue
+ boolean inherits
+ string syntax
+
+
+ # CSS font-palette-values rule representation.
+ type CSSFontPaletteValuesRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated font palette name.
+ Value fontPaletteName
+ # Associated style declaration.
+ CSSStyle style
+
+ # CSS property at-rule representation.
+ type CSSPropertyRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated property name.
+ Value propertyName
+ # Associated style declaration.
+ CSSStyle style
+
+ # CSS function argument representation.
+ type CSSFunctionParameter extends object
+ properties
+ # The parameter name.
+ string name
+ # The parameter type.
+ string type
+
+ # CSS function conditional block representation.
+ type CSSFunctionConditionNode extends object
+ properties
+ # Media query for this conditional block. Only one type of condition should be set.
+ optional CSSMedia media
+ # Container query for this conditional block. Only one type of condition should be set.
+ optional CSSContainerQuery containerQueries
+ # @supports CSS at-rule condition. Only one type of condition should be set.
+ optional CSSSupports supports
+ # Block body.
+ array of CSSFunctionNode children
+ # The condition text.
+ string conditionText
+
+ # Section of the body of a CSS function rule.
+ type CSSFunctionNode extends object
+ properties
+ # A conditional block. If set, style should not be set.
+ optional CSSFunctionConditionNode condition
+ # Values set by this node. If set, condition should not be set.
+ optional CSSStyle style
+
+ # CSS function at-rule representation.
+ type CSSFunctionRule extends object
+ properties
+ # Name of the function.
+ Value name
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # List of parameters.
+ array of CSSFunctionParameter parameters
+ # Function body.
+ array of CSSFunctionNode children
+
+ # CSS keyframe rule representation.
+ type CSSKeyframeRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated key text.
+ Value keyText
+ # Associated style declaration.
+ CSSStyle style
+
+ # A descriptor of operation to mutate style declaration text.
+ type StyleDeclarationEdit extends object
+ properties
+ # The css style sheet identifier.
+ StyleSheetId styleSheetId
+ # The range of the style text in the enclosing stylesheet.
+ SourceRange range
+ # New style text.
+ string text
+
+ # Inserts a new rule with the given `ruleText` in a stylesheet with given `styleSheetId`, at the
+ # position specified by `location`.
+ command addRule
+ parameters
+ # The css style sheet identifier where a new rule should be inserted.
+ StyleSheetId styleSheetId
+ # The text of a new rule.
+ string ruleText
+ # Text position of a new rule in the target style sheet.
+ SourceRange location
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
+ # incorrect results if the declaration contains a var() for example.
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
+ returns
+ # The newly created rule.
+ CSSRule rule
+
+ # Returns all class names from specified stylesheet.
+ command collectClassNames
+ parameters
+ StyleSheetId styleSheetId
+ returns
+ # Class name list.
+ array of string classNames
+
+ # Creates a new special "via-inspector" stylesheet in the frame with given `frameId`.
+ command createStyleSheet
+ parameters
+ # Identifier of the frame where "via-inspector" stylesheet should be created.
+ Page.FrameId frameId
+ # If true, creates a new stylesheet for every call. If false,
+ # returns a stylesheet previously created by a call with force=false
+ # for the frame's document if it exists or creates a new stylesheet
+ # (default: false).
+ optional boolean force
+ returns
+ # Identifier of the created "via-inspector" stylesheet.
+ StyleSheetId styleSheetId
+
+ # Disables the CSS agent for the given page.
+ command disable
+
+ # Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been
+ # enabled until the result of this command is received.
+ command enable
+
+ # Ensures that the given node will have specified pseudo-classes whenever its style is computed by
+ # the browser.
+ command forcePseudoState
+ parameters
+ # The element id for which to force the pseudo state.
+ DOM.NodeId nodeId
+ # Element pseudo classes to force when computing the element's style.
+ array of string forcedPseudoClasses
+
+ # Ensures that the given node is in its starting-style state.
+ command forceStartingStyle
+ parameters
+ # The element id for which to force the starting-style state.
+ DOM.NodeId nodeId
+ # Boolean indicating if this is on or off.
+ boolean forced
+
+ command getBackgroundColors
+ parameters
+ # Id of the node to get background colors for.
+ DOM.NodeId nodeId
+ returns
+ # The range of background colors behind this element, if it contains any visible text. If no
+ # visible text is present, this will be undefined. In the case of a flat background color,
+ # this will consist of simply that color. In the case of a gradient, this will consist of each
+ # of the color stops. For anything more complicated, this will be an empty array. Images will
+ # be ignored (as if the image had failed to load).
+ optional array of string backgroundColors
+ # The computed font size for this node, as a CSS computed value string (e.g. '12px').
+ optional string computedFontSize
+ # The computed font weight for this node, as a CSS computed value string (e.g. 'normal' or
+ # '100').
+ optional string computedFontWeight
+
+ # Returns the computed style for a DOM node identified by `nodeId`.
+ command getComputedStyleForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Computed style for the specified DOM node.
+ array of CSSComputedStyleProperty computedStyle
+
+ # Resolve the specified values in the context of the provided element.
+ # For example, a value of '1em' is evaluated according to the computed
+ # 'font-size' of the element and a value 'calc(1px + 2px)' will be
+ # resolved to '3px'.
+ # If the `propertyName` was specified the `values` are resolved as if
+ # they were property's declaration. If a value cannot be parsed according
+ # to the provided property syntax, the value is parsed using combined
+ # syntax as if null `propertyName` was provided. If the value cannot be
+ # resolved even then, return the provided value without any changes.
+ experimental command resolveValues
+ parameters
+ # Cascade-dependent keywords (revert/revert-layer) do not work.
+ array of string values
+ # Id of the node in whose context the expression is evaluated
+ DOM.NodeId nodeId
+ # Only longhands and custom property names are accepted.
+ optional string propertyName
+ # Pseudo element type, only works for pseudo elements that generate
+ # elements in the tree, such as ::before and ::after.
+ optional DOM.PseudoType pseudoType
+ # Pseudo element custom ident.
+ optional string pseudoIdentifier
+ returns
+ array of string results
+
+ experimental command getLonghandProperties
+ parameters
+ string shorthandName
+ string value
+ returns
+ array of CSSProperty longhandProperties
+
+ # Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
+ # attributes) for a DOM node identified by `nodeId`.
+ command getInlineStylesForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Inline style for the specified DOM node.
+ optional CSSStyle inlineStyle
+ # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
+ optional CSSStyle attributesStyle
+
+ # Returns the styles coming from animations & transitions
+ # including the animation & transition styles coming from inheritance chain.
+ experimental command getAnimatedStylesForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Styles coming from animations.
+ optional array of CSSAnimationStyle animationStyles
+ # Style coming from transitions.
+ optional CSSStyle transitionsStyle
+ # Inherited style entries for animationsStyle and transitionsStyle from
+ # the inheritance chain of the element.
+ optional array of InheritedAnimatedStyleEntry inherited
+
+ # Returns requested styles for a DOM node identified by `nodeId`.
+ command getMatchedStylesForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Inline style for the specified DOM node.
+ optional CSSStyle inlineStyle
+ # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
+ optional CSSStyle attributesStyle
+ # CSS rules matching this node, from all applicable stylesheets.
+ optional array of RuleMatch matchedCSSRules
+ # Pseudo style matches for this node.
+ optional array of PseudoElementMatches pseudoElements
+ # A chain of inherited styles (from the immediate node parent up to the DOM tree root).
+ optional array of InheritedStyleEntry inherited
+ # A chain of inherited pseudo element styles (from the immediate node parent up to the DOM tree root).
+ optional array of InheritedPseudoElementMatches inheritedPseudoElements
+ # A list of CSS keyframed animations matching this node.
+ optional array of CSSKeyframesRule cssKeyframesRules
+ # A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
+ optional array of CSSPositionTryRule cssPositionTryRules
+ # Index of the active fallback in the applied position-try-fallback property,
+ # will not be set if there is no active position-try fallback.
+ optional integer activePositionFallbackIndex
+ # A list of CSS at-property rules matching this node.
+ optional array of CSSPropertyRule cssPropertyRules
+ # A list of CSS property registrations matching this node.
+ optional array of CSSPropertyRegistration cssPropertyRegistrations
+ # A font-palette-values rule matching this node.
+ optional CSSFontPaletteValuesRule cssFontPaletteValuesRule
+ # Id of the first parent element that does not have display: contents.
+ experimental optional DOM.NodeId parentLayoutNodeId
+ # A list of CSS at-function rules referenced by styles of this node.
+ experimental optional array of CSSFunctionRule cssFunctionRules
+
+ # Returns the values of the default UA-defined environment variables used in env()
+ experimental command getEnvironmentVariables
+ returns
+ object environmentVariables
+
+ # Returns all media queries parsed by the rendering engine.
+ command getMediaQueries
+ returns
+ array of CSSMedia medias
+
+ # Requests information about platform fonts which we used to render child TextNodes in the given
+ # node.
+ command getPlatformFontsForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Usage statistics for every employed platform font.
+ array of PlatformFontUsage fonts
+
+ # Returns the current textual content for a stylesheet.
+ command getStyleSheetText
+ parameters
+ StyleSheetId styleSheetId
+ returns
+ # The stylesheet text.
+ string text
+
+ # Returns all layers parsed by the rendering engine for the tree scope of a node.
+ # Given a DOM element identified by nodeId, getLayersForNode returns the root
+ # layer for the nearest ancestor document or shadow root. The layer root contains
+ # the full layer tree for the tree scope and their ordering.
+ experimental command getLayersForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ CSSLayerData rootLayer
+
+ # Given a CSS selector text and a style sheet ID, getLocationForSelector
+ # returns an array of locations of the CSS selector in the style sheet.
+ experimental command getLocationForSelector
+ parameters
+ StyleSheetId styleSheetId
+ string selectorText
+ returns
+ array of SourceRange ranges
+
+ # Starts tracking the given node for the computed style updates
+ # and whenever the computed style is updated for node, it queues
+ # a `computedStyleUpdated` event with throttling.
+ # There can only be 1 node tracked for computed style updates
+ # so passing a new node id removes tracking from the previous node.
+ # Pass `undefined` to disable tracking.
+ experimental command trackComputedStyleUpdatesForNode
+ parameters
+ optional DOM.NodeId nodeId
+
+ # Starts tracking the given computed styles for updates. The specified array of properties
+ # replaces the one previously specified. Pass empty array to disable tracking.
+ # Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
+ # The changes to computed style properties are only tracked for nodes pushed to the front-end
+ # by the DOM agent. If no changes to the tracked properties occur after the node has been pushed
+ # to the front-end, no updates will be issued for the node.
+ experimental command trackComputedStyleUpdates
+ parameters
+ array of CSSComputedStyleProperty propertiesToTrack
+
+ # Polls the next batch of computed style updates.
+ experimental command takeComputedStyleUpdates
+ returns
+ # The list of node Ids that have their tracked computed styles updated.
+ array of DOM.NodeId nodeIds
+
+ # Find a rule with the given active property for the given node and set the new value for this
+ # property
+ command setEffectivePropertyValueForNode
+ parameters
+ # The element id for which to set property.
+ DOM.NodeId nodeId
+ string propertyName
+ string value
+
+ # Modifies the property rule property name.
+ command setPropertyRulePropertyName
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string propertyName
+ returns
+ # The resulting key text after modification.
+ Value propertyName
+
+ # Modifies the keyframe rule key text.
+ command setKeyframeKey
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string keyText
+ returns
+ # The resulting key text after modification.
+ Value keyText
+
+ # Modifies the rule selector.
+ command setMediaText
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string text
+ returns
+ # The resulting CSS media rule after modification.
+ CSSMedia media
+
+ # Modifies the expression of a container query.
+ experimental command setContainerQueryText
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string text
+ returns
+ # The resulting CSS container query rule after modification.
+ CSSContainerQuery containerQuery
+
+ # Modifies the expression of a supports at-rule.
+ experimental command setSupportsText
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string text
+ returns
+ # The resulting CSS Supports rule after modification.
+ CSSSupports supports
+
+ # Modifies the expression of a scope at-rule.
+ experimental command setScopeText
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string text
+ returns
+ # The resulting CSS Scope rule after modification.
+ CSSScope scope
+
+ # Modifies the rule selector.
+ command setRuleSelector
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string selector
+ returns
+ # The resulting selector list after modification.
+ SelectorList selectorList
+
+ # Sets the new stylesheet text.
+ command setStyleSheetText
+ parameters
+ StyleSheetId styleSheetId
+ string text
+ returns
+ # URL of source map associated with script (if any).
+ optional string sourceMapURL
+
+ # Applies specified style edits one after another in the given order.
+ command setStyleTexts
+ parameters
+ array of StyleDeclarationEdit edits
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
+ # incorrect results if the declaration contains a var() for example.
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
+ returns
+ # The resulting styles after modification.
+ array of CSSStyle styles
+
+ # Enables the selector recording.
+ command startRuleUsageTracking
+
+ # Stop tracking rule usage and return the list of rules that were used since last call to
+ # `takeCoverageDelta` (or since start of coverage instrumentation).
+ command stopRuleUsageTracking
+ returns
+ array of RuleUsage ruleUsage
+
+ # Obtain list of rules that became used since last call to this method (or since start of coverage
+ # instrumentation).
+ command takeCoverageDelta
+ returns
+ array of RuleUsage coverage
+ # Monotonically increasing time, in seconds.
+ number timestamp
+
+ # Enables/disables rendering of local CSS fonts (enabled by default).
+ experimental command setLocalFontsEnabled
+ parameters
+ # Whether rendering of local fonts is enabled.
+ boolean enabled
+
+ # Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded
+ # web font.
+ event fontsUpdated
+ parameters
+ # The web font that has loaded.
+ optional FontFace font
+
+ # Fires whenever a MediaQuery result changes (for example, after a browser window has been
+ # resized.) The current implementation considers only viewport-dependent media features.
+ event mediaQueryResultChanged
+
+ # Fired whenever an active document stylesheet is added.
+ event styleSheetAdded
+ parameters
+ # Added stylesheet metainfo.
+ CSSStyleSheetHeader header
+
+ # Fired whenever a stylesheet is changed as a result of the client operation.
+ event styleSheetChanged
+ parameters
+ StyleSheetId styleSheetId
+
+ # Fired whenever an active document stylesheet is removed.
+ event styleSheetRemoved
+ parameters
+ # Identifier of the removed stylesheet.
+ StyleSheetId styleSheetId
+
+ experimental event computedStyleUpdated
+ parameters
+ # The node id that has updated computed styles.
+ DOM.NodeId nodeId
diff --git a/pdl/domains/CacheStorage.pdl b/pdl/domains/CacheStorage.pdl
new file mode 100644
index 00000000..061253da
--- /dev/null
+++ b/pdl/domains/CacheStorage.pdl
@@ -0,0 +1,125 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain CacheStorage
+ depends on Storage
+
+ # Unique identifier of the Cache object.
+ type CacheId extends string
+
+ # type of HTTP response cached
+ type CachedResponseType extends string
+ enum
+ basic
+ cors
+ default
+ error
+ opaqueResponse
+ opaqueRedirect
+
+ # Data entry.
+ type DataEntry extends object
+ properties
+ # Request URL.
+ string requestURL
+ # Request method.
+ string requestMethod
+ # Request headers
+ array of Header requestHeaders
+ # Number of seconds since epoch.
+ number responseTime
+ # HTTP response status code.
+ integer responseStatus
+ # HTTP response status text.
+ string responseStatusText
+ # HTTP response type
+ CachedResponseType responseType
+ # Response headers
+ array of Header responseHeaders
+
+ # Cache identifier.
+ type Cache extends object
+ properties
+ # An opaque unique id of the cache.
+ CacheId cacheId
+ # Security origin of the cache.
+ string securityOrigin
+ # Storage key of the cache.
+ string storageKey
+ # Storage bucket of the cache.
+ optional Storage.StorageBucket storageBucket
+ # The name of the cache.
+ string cacheName
+
+ type Header extends object
+ properties
+ string name
+ string value
+
+ # Cached response
+ type CachedResponse extends object
+ properties
+ # Entry content, base64-encoded.
+ binary body
+
+ # Deletes a cache.
+ command deleteCache
+ parameters
+ # Id of cache for deletion.
+ CacheId cacheId
+
+ # Deletes a cache entry.
+ command deleteEntry
+ parameters
+ # Id of cache where the entry will be deleted.
+ CacheId cacheId
+ # URL spec of the request.
+ string request
+
+ # Requests cache names.
+ command requestCacheNames
+ parameters
+ # At least and at most one of securityOrigin, storageKey, storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ returns
+ # Caches for the security origin.
+ array of Cache caches
+
+ # Fetches cache entry.
+ command requestCachedResponse
+ parameters
+ # Id of cache that contains the entry.
+ CacheId cacheId
+ # URL spec of the request.
+ string requestURL
+ # headers of the request.
+ array of Header requestHeaders
+ returns
+ # Response read from the cache.
+ CachedResponse response
+
+ # Requests data from cache.
+ command requestEntries
+ parameters
+ # ID of cache to get entries from.
+ CacheId cacheId
+ # Number of records to skip.
+ optional integer skipCount
+ # Number of records to fetch.
+ optional integer pageSize
+ # If present, only return the entries containing this substring in the path
+ optional string pathFilter
+ returns
+ # Array of object store data entries.
+ array of DataEntry cacheDataEntries
+ # Count of returned entries from this storage. If pathFilter is empty, it
+ # is the count of all entries from this storage.
+ number returnCount
diff --git a/pdl/domains/Cast.pdl b/pdl/domains/Cast.pdl
new file mode 100644
index 00000000..23f27733
--- /dev/null
+++ b/pdl/domains/Cast.pdl
@@ -0,0 +1,62 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# A domain for interacting with Cast, Presentation API, and Remote Playback API
+# functionalities.
+experimental domain Cast
+
+ type Sink extends object
+ properties
+ string name
+ string id
+ # Text describing the current session. Present only if there is an active
+ # session on the sink.
+ optional string session
+
+ # Starts observing for sinks that can be used for tab mirroring, and if set,
+ # sinks compatible with |presentationUrl| as well. When sinks are found, a
+ # |sinksUpdated| event is fired.
+ # Also starts observing for issue messages. When an issue is added or removed,
+ # an |issueUpdated| event is fired.
+ command enable
+ parameters
+ optional string presentationUrl
+
+ # Stops observing for sinks and issues.
+ command disable
+
+ # Sets a sink to be used when the web page requests the browser to choose a
+ # sink via Presentation API, Remote Playback API, or Cast SDK.
+ command setSinkToUse
+ parameters
+ string sinkName
+
+ # Starts mirroring the desktop to the sink.
+ command startDesktopMirroring
+ parameters
+ string sinkName
+
+ # Starts mirroring the tab to the sink.
+ command startTabMirroring
+ parameters
+ string sinkName
+
+ # Stops the active Cast session on the sink.
+ command stopCasting
+ parameters
+ string sinkName
+
+ # This is fired whenever the list of available sinks changes. A sink is a
+ # device or a software surface that you can cast to.
+ event sinksUpdated
+ parameters
+ array of Sink sinks
+
+ # This is fired whenever the outstanding issue/error message changes.
+ # |issueMessage| is empty if there is no issue.
+ event issueUpdated
+ parameters
+ string issueMessage
diff --git a/pdl/domains/DOM.pdl b/pdl/domains/DOM.pdl
new file mode 100644
index 00000000..5a16c329
--- /dev/null
+++ b/pdl/domains/DOM.pdl
@@ -0,0 +1,932 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# 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.
+domain DOM
+ depends on Runtime
+
+ # Unique DOM node identifier.
+ type NodeId extends integer
+
+ # Unique DOM node identifier used to reference a node that may not have been pushed to the
+ # front-end.
+ type BackendNodeId extends integer
+
+ # Backend node with a friendly name.
+ type BackendNode extends object
+ properties
+ # `Node`'s nodeType.
+ integer nodeType
+ # `Node`'s nodeName.
+ string nodeName
+ BackendNodeId backendNodeId
+
+ # Pseudo element type.
+ type PseudoType extends string
+ enum
+ first-line
+ first-letter
+ checkmark
+ before
+ after
+ picker-icon
+ interest-hint
+ marker
+ backdrop
+ column
+ selection
+ search-text
+ target-text
+ spelling-error
+ grammar-error
+ highlight
+ first-line-inherited
+ scroll-marker
+ scroll-marker-group
+ scroll-button
+ scrollbar
+ scrollbar-thumb
+ scrollbar-button
+ scrollbar-track
+ scrollbar-track-piece
+ scrollbar-corner
+ resizer
+ input-list-button
+ view-transition
+ view-transition-group
+ view-transition-image-pair
+ view-transition-group-children
+ view-transition-old
+ view-transition-new
+ placeholder
+ file-selector-button
+ details-content
+ picker
+ permission-icon
+
+ # Shadow root type.
+ type ShadowRootType extends string
+ enum
+ user-agent
+ open
+ closed
+
+ # Document compatibility mode.
+ type CompatibilityMode extends string
+ enum
+ QuirksMode
+ LimitedQuirksMode
+ NoQuirksMode
+
+ # ContainerSelector physical axes
+ type PhysicalAxes extends string
+ enum
+ Horizontal
+ Vertical
+ Both
+
+ # ContainerSelector logical axes
+ type LogicalAxes extends string
+ enum
+ Inline
+ Block
+ Both
+
+ # Physical scroll orientation
+ type ScrollOrientation extends string
+ enum
+ horizontal
+ vertical
+
+ # DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes.
+ # DOMNode is a base node mirror type.
+ type Node extends object
+ properties
+ # Node identifier that is passed into the rest of the DOM messages as the `nodeId`. Backend
+ # will only push node with given `id` once. It is aware of all requested nodes and will only
+ # fire DOM events for nodes known to the client.
+ NodeId nodeId
+ # The id of the parent node if any.
+ optional NodeId parentId
+ # The BackendNodeId for this node.
+ BackendNodeId backendNodeId
+ # `Node`'s nodeType.
+ integer nodeType
+ # `Node`'s nodeName.
+ string nodeName
+ # `Node`'s localName.
+ string localName
+ # `Node`'s nodeValue.
+ string nodeValue
+ # Child count for `Container` nodes.
+ optional integer childNodeCount
+ # Child nodes of this node when requested with children.
+ optional array of Node children
+ # Attributes of the `Element` node in the form of flat array `[name1, value1, name2, value2]`.
+ optional array of string attributes
+ # Document URL that `Document` or `FrameOwner` node points to.
+ optional string documentURL
+ # Base URL that `Document` or `FrameOwner` node uses for URL completion.
+ optional string baseURL
+ # `DocumentType`'s publicId.
+ optional string publicId
+ # `DocumentType`'s systemId.
+ optional string systemId
+ # `DocumentType`'s internalSubset.
+ optional string internalSubset
+ # `Document`'s XML version in case of XML documents.
+ optional string xmlVersion
+ # `Attr`'s name.
+ optional string name
+ # `Attr`'s value.
+ optional string value
+ # Pseudo element type for this node.
+ optional PseudoType pseudoType
+ # Pseudo element identifier for this node. Only present if there is a
+ # valid pseudoType.
+ optional string pseudoIdentifier
+ # Shadow root type.
+ optional ShadowRootType shadowRootType
+ # Frame ID for frame owner elements.
+ optional Page.FrameId frameId
+ # Content document for frame owner elements.
+ optional Node contentDocument
+ # Shadow root list for given element host.
+ optional array of Node shadowRoots
+ # Content document fragment for template elements.
+ optional Node templateContent
+ # Pseudo elements associated with this node.
+ optional array of Node pseudoElements
+ # Deprecated, as the HTML Imports API has been removed (crbug.com/937746).
+ # This property used to return the imported document for the HTMLImport links.
+ # The property is always undefined now.
+ deprecated optional Node importedDocument
+ # Distributed nodes for given insertion point.
+ optional array of BackendNode distributedNodes
+ # Whether the node is SVG.
+ optional boolean isSVG
+ optional CompatibilityMode compatibilityMode
+ optional BackendNode assignedSlot
+ experimental optional boolean isScrollable
+
+ # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
+ type DetachedElementInfo extends object
+ properties
+ Node treeNode
+ array of NodeId retainedNodeIds
+
+ # A structure holding an RGBA color.
+ type RGBA extends object
+ properties
+ # The red component, in the [0-255] range.
+ integer r
+ # The green component, in the [0-255] range.
+ integer g
+ # The blue component, in the [0-255] range.
+ integer b
+ # The alpha component, in the [0-1] range (default: 1).
+ optional number a
+
+ # An array of quad vertices, x immediately followed by y for each point, points clock-wise.
+ type Quad extends array of number
+
+ # Box model.
+ type BoxModel extends object
+ properties
+ # Content box
+ Quad content
+ # Padding box
+ Quad padding
+ # Border box
+ Quad border
+ # Margin box
+ Quad margin
+ # Node width
+ integer width
+ # Node height
+ integer height
+ # Shape outside coordinates
+ optional ShapeOutsideInfo shapeOutside
+
+ # CSS Shape Outside details.
+ type ShapeOutsideInfo extends object
+ properties
+ # Shape bounds
+ Quad bounds
+ # Shape coordinate details
+ array of any shape
+ # Margin shape bounds
+ array of any marginShape
+
+ # Rectangle.
+ type Rect extends object
+ properties
+ # X coordinate
+ number x
+ # Y coordinate
+ number y
+ # Rectangle width
+ number width
+ # Rectangle height
+ number height
+
+ type CSSComputedStyleProperty extends object
+ properties
+ # Computed style property name.
+ string name
+ # Computed style property value.
+ string value
+
+ # Collects class names for the node with given id and all of it's child nodes.
+ experimental command collectClassNamesFromSubtree
+ parameters
+ # Id of the node to collect class names.
+ NodeId nodeId
+ returns
+ # Class name list.
+ array of string classNames
+
+ # Creates a deep copy of the specified node and places it into the target container before the
+ # given anchor.
+ experimental command copyTo
+ parameters
+ # Id of the node to copy.
+ NodeId nodeId
+ # Id of the element to drop the copy into.
+ NodeId targetNodeId
+ # Drop the copy before this node (if absent, the copy becomes the last child of
+ # `targetNodeId`).
+ optional NodeId insertBeforeNodeId
+ returns
+ # Id of the node clone.
+ NodeId nodeId
+
+ # Describes node given its id, does not require domain to be enabled. Does not start tracking any
+ # objects, can be used for automation.
+ command describeNode
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+ # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
+ # entire subtree or provide an integer larger than 0.
+ optional integer depth
+ # Whether or not iframes and shadow roots should be traversed when returning the subtree
+ # (default is false).
+ optional boolean pierce
+ returns
+ # Node description.
+ Node node
+
+ # Scrolls the specified rect of the given node into view if not already visible.
+ # Note: exactly one between nodeId, backendNodeId and objectId should be passed
+ # to identify the node.
+ command scrollIntoViewIfNeeded
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+ # The rect to be scrolled into view, relative to the node's border box, in CSS pixels.
+ # When omitted, center of the node will be used, similar to Element.scrollIntoView.
+ optional Rect rect
+
+ # Disables DOM agent for the given page.
+ command disable
+
+ # Discards search results from the session with the given id. `getSearchResults` should no longer
+ # be called for that search.
+ experimental command discardSearchResults
+ parameters
+ # Unique search session identifier.
+ string searchId
+
+ # Enables DOM agent for the given page.
+ command enable
+ parameters
+ # Whether to include whitespaces in the children array of returned Nodes.
+ experimental optional enum includeWhitespace
+ # Strip whitespaces from child arrays (default).
+ none
+ # Return all children including block-level whitespace nodes.
+ all
+
+ # Focuses the given element.
+ command focus
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+
+ # Returns attributes for the specified node.
+ command getAttributes
+ parameters
+ # Id of the node to retrieve attributes for.
+ NodeId nodeId
+ returns
+ # An interleaved array of node attribute names and values.
+ array of string attributes
+
+ # Returns boxes for the given node.
+ command getBoxModel
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+ returns
+ # Box model for the node.
+ BoxModel model
+
+ # Returns quads that describe node position on the page. This method
+ # might return multiple quads for inline nodes.
+ experimental command getContentQuads
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+ returns
+ # Quads that describe node layout relative to viewport.
+ array of Quad quads
+
+ # Returns the root DOM node (and optionally the subtree) to the caller.
+ # Implicitly enables the DOM domain events for the current target.
+ command getDocument
+ parameters
+ # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
+ # entire subtree or provide an integer larger than 0.
+ optional integer depth
+ # Whether or not iframes and shadow roots should be traversed when returning the subtree
+ # (default is false).
+ optional boolean pierce
+ returns
+ # Resulting node.
+ Node root
+
+ # Returns the root DOM node (and optionally the subtree) to the caller.
+ # Deprecated, as it is not designed to work well with the rest of the DOM agent.
+ # Use DOMSnapshot.captureSnapshot instead.
+ deprecated command getFlattenedDocument
+ parameters
+ # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
+ # entire subtree or provide an integer larger than 0.
+ optional integer depth
+ # Whether or not iframes and shadow roots should be traversed when returning the subtree
+ # (default is false).
+ optional boolean pierce
+ returns
+ # Resulting node.
+ array of Node nodes
+
+ # Finds nodes with a given computed style in a subtree.
+ experimental command getNodesForSubtreeByStyle
+ parameters
+ # Node ID pointing to the root of a subtree.
+ NodeId nodeId
+ # The style to filter nodes by (includes nodes if any of properties matches).
+ array of CSSComputedStyleProperty computedStyles
+ # Whether or not iframes and shadow roots in the same target should be traversed when returning the
+ # results (default is false).
+ optional boolean pierce
+ returns
+ # Resulting nodes.
+ array of NodeId nodeIds
+
+ # Returns node id at given location. Depending on whether DOM domain is enabled, nodeId is
+ # either returned or not.
+ command getNodeForLocation
+ parameters
+ # X coordinate.
+ integer x
+ # Y coordinate.
+ integer y
+ # False to skip to the nearest non-UA shadow root ancestor (default: false).
+ optional boolean includeUserAgentShadowDOM
+ # Whether to ignore pointer-events: none on elements and hit test them.
+ optional boolean ignorePointerEventsNone
+ returns
+ # Resulting node.
+ BackendNodeId backendNodeId
+ # Frame this node belongs to.
+ Page.FrameId frameId
+ # Id of the node at given coordinates, only when enabled and requested document.
+ optional NodeId nodeId
+
+ # Returns node's HTML markup.
+ command getOuterHTML
+ parameters
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+ # Include all shadow roots. Equals to false if not specified.
+ experimental optional boolean includeShadowDOM
+ returns
+ # Outer HTML markup.
+ string outerHTML
+
+ # Returns the id of the nearest ancestor that is a relayout boundary.
+ experimental command getRelayoutBoundary
+ parameters
+ # Id of the node.
+ NodeId nodeId
+ returns
+ # Relayout boundary node id for the given node.
+ NodeId nodeId
+
+ # Returns search results from given `fromIndex` to given `toIndex` from the search with the given
+ # identifier.
+ experimental command getSearchResults
+ parameters
+ # Unique search session identifier.
+ string searchId
+ # Start index of the search result to be returned.
+ integer fromIndex
+ # End index of the search result to be returned.
+ integer toIndex
+ returns
+ # Ids of the search result nodes.
+ array of NodeId nodeIds
+
+ # Hides any highlight.
+ command hideHighlight
+ # Use 'Overlay.hideHighlight' instead
+ redirect Overlay
+
+ # Highlights DOM node.
+ command highlightNode
+ # Use 'Overlay.highlightNode' instead
+ redirect Overlay
+
+ # Highlights given rectangle.
+ command highlightRect
+ # Use 'Overlay.highlightRect' instead
+ redirect Overlay
+
+ # Marks last undoable state.
+ experimental command markUndoableState
+
+ # Moves node into the new container, places it before the given anchor.
+ command moveTo
+ parameters
+ # Id of the node to move.
+ NodeId nodeId
+ # Id of the element to drop the moved node into.
+ NodeId targetNodeId
+ # Drop node before this one (if absent, the moved node becomes the last child of
+ # `targetNodeId`).
+ optional NodeId insertBeforeNodeId
+ returns
+ # New id of the moved node.
+ NodeId nodeId
+
+ # Searches for a given string in the DOM tree. Use `getSearchResults` to access search results or
+ # `cancelSearch` to end this search session.
+ experimental command performSearch
+ parameters
+ # Plain text or query selector or XPath search query.
+ string query
+ # True to search in user agent shadow DOM.
+ optional boolean includeUserAgentShadowDOM
+ returns
+ # Unique search session identifier.
+ string searchId
+ # Number of search results.
+ integer resultCount
+
+ # Requests that the node is sent to the caller given its path. // FIXME, use XPath
+ experimental command pushNodeByPathToFrontend
+ parameters
+ # Path to node in the proprietary format.
+ string path
+ returns
+ # Id of the node for given path.
+ NodeId nodeId
+
+ # Requests that a batch of nodes is sent to the caller given their backend node ids.
+ experimental command pushNodesByBackendIdsToFrontend
+ parameters
+ # The array of backend node ids.
+ array of BackendNodeId backendNodeIds
+ returns
+ # The array of ids of pushed nodes that correspond to the backend ids specified in
+ # backendNodeIds.
+ array of NodeId nodeIds
+
+ # Executes `querySelector` on a given node.
+ command querySelector
+ parameters
+ # Id of the node to query upon.
+ NodeId nodeId
+ # Selector string.
+ string selector
+ returns
+ # Query selector result.
+ NodeId nodeId
+
+ # Executes `querySelectorAll` on a given node.
+ command querySelectorAll
+ parameters
+ # Id of the node to query upon.
+ NodeId nodeId
+ # Selector string.
+ string selector
+ returns
+ # Query selector result.
+ array of NodeId nodeIds
+
+ # Returns NodeIds of current top layer elements.
+ # Top layer is rendered closest to the user within a viewport, therefore its elements always
+ # appear on top of all other content.
+ experimental command getTopLayerElements
+ returns
+ # NodeIds of top layer elements
+ array of NodeId nodeIds
+
+ # Returns the NodeId of the matched element according to certain relations.
+ experimental command getElementByRelation
+ parameters
+ # Id of the node from which to query the relation.
+ NodeId nodeId
+ # Type of relation to get.
+ enum relation
+ # Get the popover target for a given element. In this case, this given
+ # element can only be an HTMLFormControlElement (<input>, <button>).
+ PopoverTarget
+ # Get the interestfor target (the attribute used to be named
+ # `interesttarget`) for for a given element.
+ InterestTarget
+ # Get the commandfor target for a given element. In this case, this given
+ # element can only be an HTMLButtonElement.
+ CommandFor
+ returns
+ # NodeId of the element matching the queried relation.
+ NodeId nodeId
+
+ # Re-does the last undone action.
+ experimental command redo
+
+ # Removes attribute with given name from an element with given id.
+ command removeAttribute
+ parameters
+ # Id of the element to remove attribute from.
+ NodeId nodeId
+ # Name of the attribute to remove.
+ string name
+
+ # Removes node with given id.
+ command removeNode
+ parameters
+ # Id of the node to remove.
+ NodeId nodeId
+
+ # Requests that children of the node with given id are returned to the caller in form of
+ # `setChildNodes` events where not only immediate children are retrieved, but all children down to
+ # the specified depth.
+ command requestChildNodes
+ parameters
+ # Id of the node to get children for.
+ NodeId nodeId
+ # The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
+ # entire subtree or provide an integer larger than 0.
+ optional integer depth
+ # Whether or not iframes and shadow roots should be traversed when returning the sub-tree
+ # (default is false).
+ optional boolean pierce
+
+ # Requests that the node is sent to the caller given the JavaScript node object reference. All
+ # nodes that form the path from the node to the root are also sent to the client as a series of
+ # `setChildNodes` notifications.
+ command requestNode
+ parameters
+ # JavaScript object id to convert into node.
+ Runtime.RemoteObjectId objectId
+ returns
+ # Node id for given object.
+ NodeId nodeId
+
+ # Resolves the JavaScript node object for a given NodeId or BackendNodeId.
+ command resolveNode
+ parameters
+ # Id of the node to resolve.
+ optional NodeId nodeId
+ # Backend identifier of the node to resolve.
+ optional DOM.BackendNodeId backendNodeId
+ # Symbolic group name that can be used to release multiple objects.
+ optional string objectGroup
+ # Execution context in which to resolve the node.
+ optional Runtime.ExecutionContextId executionContextId
+ returns
+ # JavaScript object wrapper for given node.
+ Runtime.RemoteObject object
+
+ # Sets attribute for an element with given id.
+ command setAttributeValue
+ parameters
+ # Id of the element to set attribute for.
+ NodeId nodeId
+ # Attribute name.
+ string name
+ # Attribute value.
+ string value
+
+ # Sets attributes on element with given id. This method is useful when user edits some existing
+ # attribute value and types in several attribute name/value pairs.
+ command setAttributesAsText
+ parameters
+ # Id of the element to set attributes for.
+ NodeId nodeId
+ # Text with a number of attributes. Will parse this text using HTML parser.
+ string text
+ # Attribute name to replace with new attributes derived from text in case text parsed
+ # successfully.
+ optional string name
+
+ # Sets files for the given file input element.
+ command setFileInputFiles
+ parameters
+ # Array of file paths to set.
+ array of string files
+ # Identifier of the node.
+ optional NodeId nodeId
+ # Identifier of the backend node.
+ optional BackendNodeId backendNodeId
+ # JavaScript object id of the node wrapper.
+ optional Runtime.RemoteObjectId objectId
+
+ # Sets if stack traces should be captured for Nodes. See `Node.getNodeStackTraces`. Default is disabled.
+ experimental command setNodeStackTracesEnabled
+ parameters
+ # Enable or disable.
+ boolean enable
+
+ # Gets stack traces associated with a Node. As of now, only provides stack trace for Node creation.
+ experimental command getNodeStackTraces
+ parameters
+ # Id of the node to get stack traces for.
+ NodeId nodeId
+ returns
+ # Creation stack trace, if available.
+ optional Runtime.StackTrace creation
+
+ # Returns file information for the given
+ # File wrapper.
+ experimental command getFileInfo
+ parameters
+ # JavaScript object id of the node wrapper.
+ Runtime.RemoteObjectId objectId
+ returns
+ string path
+
+ # Returns list of detached nodes
+ experimental command getDetachedDomNodes
+ returns
+ # The list of detached nodes
+ array of DetachedElementInfo detachedNodes
+
+ # Enables console to refer to the node with given id via $x (see Command Line API for more details
+ # $x functions).
+ experimental command setInspectedNode
+ parameters
+ # DOM node id to be accessible by means of $x command line API.
+ NodeId nodeId
+
+ # Sets node name for a node with given id.
+ command setNodeName
+ parameters
+ # Id of the node to set name for.
+ NodeId nodeId
+ # New node's name.
+ string name
+ returns
+ # New node's id.
+ NodeId nodeId
+
+ # Sets node value for a node with given id.
+ command setNodeValue
+ parameters
+ # Id of the node to set value for.
+ NodeId nodeId
+ # New node's value.
+ string value
+
+ # Sets node HTML markup, returns new node id.
+ command setOuterHTML
+ parameters
+ # Id of the node to set markup for.
+ NodeId nodeId
+ # Outer HTML markup to set.
+ string outerHTML
+
+ # Undoes the last performed action.
+ experimental command undo
+
+ # Returns iframe node that owns iframe with the given domain.
+ experimental command getFrameOwner
+ parameters
+ Page.FrameId frameId
+ returns
+ # Resulting node.
+ BackendNodeId backendNodeId
+ # Id of the node at given coordinates, only when enabled and requested document.
+ optional NodeId nodeId
+
+ # Returns the query container of the given node based on container query
+ # conditions: containerName, physical and logical axes, and whether it queries
+ # scroll-state or anchored elements. If no axes are provided and
+ # queriesScrollState is false, the style container is returned, which is the
+ # direct parent or the closest element with a matching container-name.
+ experimental command getContainerForNode
+ parameters
+ NodeId nodeId
+ optional string containerName
+ optional PhysicalAxes physicalAxes
+ optional LogicalAxes logicalAxes
+ optional boolean queriesScrollState
+ optional boolean queriesAnchored
+ returns
+ # The container node for the given node, or null if not found.
+ optional NodeId nodeId
+
+ # Returns the descendants of a container query container that have
+ # container queries against this container.
+ experimental command getQueryingDescendantsForContainer
+ parameters
+ # Id of the container node to find querying descendants from.
+ NodeId nodeId
+ returns
+ # Descendant nodes with container queries against the given container.
+ array of NodeId nodeIds
+
+ # Returns the target anchor element of the given anchor query according to
+ # https://www.w3.org/TR/css-anchor-position-1/#target.
+ experimental command getAnchorElement
+ parameters
+ # Id of the positioned element from which to find the anchor.
+ NodeId nodeId
+ # An optional anchor specifier, as defined in
+ # https://www.w3.org/TR/css-anchor-position-1/#anchor-specifier.
+ # If not provided, it will return the implicit anchor element for
+ # the given positioned element.
+ optional string anchorSpecifier
+ returns
+ # The anchor element of the given anchor query.
+ NodeId nodeId
+
+ # When enabling, this API force-opens the popover identified by nodeId
+ # and keeps it open until disabled.
+ experimental command forceShowPopover
+ parameters
+ # Id of the popover HTMLElement
+ NodeId nodeId
+ # If true, opens the popover and keeps it open. If false, closes the
+ # popover if it was previously force-opened.
+ boolean enable
+ returns
+ # List of popovers that were closed in order to respect popover stacking order.
+ array of NodeId nodeIds
+
+ # Fired when `Element`'s attribute is modified.
+ event attributeModified
+ parameters
+ # Id of the node that has changed.
+ NodeId nodeId
+ # Attribute name.
+ string name
+ # Attribute value.
+ string value
+
+ # Fired when `Element`'s attribute is removed.
+ event attributeRemoved
+ parameters
+ # Id of the node that has changed.
+ NodeId nodeId
+ # A ttribute name.
+ string name
+
+ # Mirrors `DOMCharacterDataModified` event.
+ event characterDataModified
+ parameters
+ # Id of the node that has changed.
+ NodeId nodeId
+ # New text value.
+ string characterData
+
+ # Fired when `Container`'s child node count has changed.
+ event childNodeCountUpdated
+ parameters
+ # Id of the node that has changed.
+ NodeId nodeId
+ # New node count.
+ integer childNodeCount
+
+ # Mirrors `DOMNodeInserted` event.
+ event childNodeInserted
+ parameters
+ # Id of the node that has changed.
+ NodeId parentNodeId
+ # Id of the previous sibling.
+ NodeId previousNodeId
+ # Inserted node data.
+ Node node
+
+ # Mirrors `DOMNodeRemoved` event.
+ event childNodeRemoved
+ parameters
+ # Parent id.
+ NodeId parentNodeId
+ # Id of the node that has been removed.
+ NodeId nodeId
+
+ # Called when distribution is changed.
+ experimental event distributedNodesUpdated
+ parameters
+ # Insertion point where distributed nodes were updated.
+ NodeId insertionPointId
+ # Distributed nodes for given insertion point.
+ array of BackendNode distributedNodes
+
+ # Fired when `Document` has been totally updated. Node ids are no longer valid.
+ event documentUpdated
+
+ # Fired when `Element`'s inline style is modified via a CSS property modification.
+ experimental event inlineStyleInvalidated
+ parameters
+ # Ids of the nodes for which the inline styles have been invalidated.
+ array of NodeId nodeIds
+
+ # Called when a pseudo element is added to an element.
+ experimental event pseudoElementAdded
+ parameters
+ # Pseudo element's parent element id.
+ NodeId parentId
+ # The added pseudo element.
+ Node pseudoElement
+
+ # Called when top layer elements are changed.
+ experimental event topLayerElementsUpdated
+
+ # Fired when a node's scrollability state changes.
+ experimental event scrollableFlagUpdated
+ parameters
+ # The id of the node.
+ DOM.NodeId nodeId
+ # If the node is scrollable.
+ boolean isScrollable
+
+ # Called when a pseudo element is removed from an element.
+ experimental event pseudoElementRemoved
+ parameters
+ # Pseudo element's parent element id.
+ NodeId parentId
+ # The removed pseudo element id.
+ NodeId pseudoElementId
+
+ # Fired when backend wants to provide client with the missing DOM structure. This happens upon
+ # most of the calls requesting node ids.
+ event setChildNodes
+ parameters
+ # Parent node id to populate with children.
+ NodeId parentId
+ # Child nodes array.
+ array of Node nodes
+
+ # Called when shadow root is popped from the element.
+ experimental event shadowRootPopped
+ parameters
+ # Host element id.
+ NodeId hostId
+ # Shadow root id.
+ NodeId rootId
+
+ # Called when shadow root is pushed into the element.
+ experimental event shadowRootPushed
+ parameters
+ # Host element id.
+ NodeId hostId
+ # Shadow root.
+ Node root
diff --git a/pdl/domains/DOMDebugger.pdl b/pdl/domains/DOMDebugger.pdl
new file mode 100644
index 00000000..1f6e6add
--- /dev/null
+++ b/pdl/domains/DOMDebugger.pdl
@@ -0,0 +1,128 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# 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.
+domain DOMDebugger
+ depends on DOM
+ depends on Runtime
+
+ # DOM breakpoint type.
+ type DOMBreakpointType extends string
+ enum
+ subtree-modified
+ attribute-modified
+ node-removed
+
+ # CSP Violation type.
+ experimental type CSPViolationType extends string
+ enum
+ trustedtype-sink-violation
+ trustedtype-policy-violation
+
+ # Object event listener.
+ type EventListener extends object
+ properties
+ # `EventListener`'s type.
+ string type
+ # `EventListener`'s useCapture.
+ boolean useCapture
+ # `EventListener`'s passive flag.
+ boolean passive
+ # `EventListener`'s once flag.
+ boolean once
+ # Script id of the handler code.
+ Runtime.ScriptId scriptId
+ # Line number in the script (0-based).
+ integer lineNumber
+ # Column number in the script (0-based).
+ integer columnNumber
+ # Event handler function value.
+ optional Runtime.RemoteObject handler
+ # Event original handler function value.
+ optional Runtime.RemoteObject originalHandler
+ # Node the listener is added to (if any).
+ optional DOM.BackendNodeId backendNodeId
+
+ # Returns event listeners of the given object.
+ command getEventListeners
+ parameters
+ # Identifier of the object to return listeners for.
+ Runtime.RemoteObjectId objectId
+ # The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the
+ # entire subtree or provide an integer larger than 0.
+ optional integer depth
+ # Whether or not iframes and shadow roots should be traversed when returning the subtree
+ # (default is false). Reports listeners for all contexts if pierce is enabled.
+ optional boolean pierce
+ returns
+ # Array of relevant listeners.
+ array of EventListener listeners
+
+ # Removes DOM breakpoint that was set using `setDOMBreakpoint`.
+ command removeDOMBreakpoint
+ parameters
+ # Identifier of the node to remove breakpoint from.
+ DOM.NodeId nodeId
+ # Type of the breakpoint to remove.
+ DOMBreakpointType type
+
+ # Removes breakpoint on particular DOM event.
+ command removeEventListenerBreakpoint
+ parameters
+ # Event name.
+ string eventName
+ # EventTarget interface name.
+ experimental optional string targetName
+
+ # Removes breakpoint on particular native event.
+ experimental deprecated command removeInstrumentationBreakpoint
+ redirect EventBreakpoints
+ parameters
+ # Instrumentation name to stop on.
+ string eventName
+
+ # Removes breakpoint from XMLHttpRequest.
+ command removeXHRBreakpoint
+ parameters
+ # Resource URL substring.
+ string url
+
+ # Sets breakpoint on particular CSP violations.
+ experimental command setBreakOnCSPViolation
+ parameters
+ # CSP Violations to stop upon.
+ array of CSPViolationType violationTypes
+
+ # Sets breakpoint on particular operation with DOM.
+ command setDOMBreakpoint
+ parameters
+ # Identifier of the node to set breakpoint on.
+ DOM.NodeId nodeId
+ # Type of the operation to stop upon.
+ DOMBreakpointType type
+
+ # Sets breakpoint on particular DOM event.
+ command setEventListenerBreakpoint
+ parameters
+ # DOM Event name to stop on (any DOM event will do).
+ string eventName
+ # EventTarget interface name to stop on. If equal to `"*"` or not provided, will stop on any
+ # EventTarget.
+ experimental optional string targetName
+
+ # Sets breakpoint on particular native event.
+ experimental deprecated command setInstrumentationBreakpoint
+ redirect EventBreakpoints
+ parameters
+ # Instrumentation name to stop on.
+ string eventName
+
+ # Sets breakpoint on XMLHttpRequest.
+ command setXHRBreakpoint
+ parameters
+ # Resource URL substring. All XHRs having this substring in the URL will get stopped upon.
+ string url
diff --git a/pdl/domains/DOMSnapshot.pdl b/pdl/domains/DOMSnapshot.pdl
new file mode 100644
index 00000000..ef470b7a
--- /dev/null
+++ b/pdl/domains/DOMSnapshot.pdl
@@ -0,0 +1,319 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain facilitates obtaining document snapshots with DOM, layout, and style information.
+experimental domain DOMSnapshot
+ depends on CSS
+ depends on DOM
+ depends on DOMDebugger
+ depends on Page
+
+ # A Node in the DOM tree.
+ type DOMNode extends object
+ properties
+ # `Node`'s nodeType.
+ integer nodeType
+ # `Node`'s nodeName.
+ string nodeName
+ # `Node`'s nodeValue.
+ string nodeValue
+ # Only set for textarea elements, contains the text value.
+ optional string textValue
+ # Only set for input elements, contains the input's associated text value.
+ optional string inputValue
+ # Only set for radio and checkbox input elements, indicates if the element has been checked
+ optional boolean inputChecked
+ # Only set for option elements, indicates if the element has been selected
+ optional boolean optionSelected
+ # `Node`'s id, corresponds to DOM.Node.backendNodeId.
+ DOM.BackendNodeId backendNodeId
+ # The indexes of the node's child nodes in the `domNodes` array returned by `getSnapshot`, if
+ # any.
+ optional array of integer childNodeIndexes
+ # Attributes of an `Element` node.
+ optional array of NameValue attributes
+ # Indexes of pseudo elements associated with this node in the `domNodes` array returned by
+ # `getSnapshot`, if any.
+ optional array of integer pseudoElementIndexes
+ # The index of the node's related layout tree node in the `layoutTreeNodes` array returned by
+ # `getSnapshot`, if any.
+ optional integer layoutNodeIndex
+ # Document URL that `Document` or `FrameOwner` node points to.
+ optional string documentURL
+ # Base URL that `Document` or `FrameOwner` node uses for URL completion.
+ optional string baseURL
+ # Only set for documents, contains the document's content language.
+ optional string contentLanguage
+ # Only set for documents, contains the document's character set encoding.
+ optional string documentEncoding
+ # `DocumentType` node's publicId.
+ optional string publicId
+ # `DocumentType` node's systemId.
+ optional string systemId
+ # Frame ID for frame owner elements and also for the document node.
+ optional Page.FrameId frameId
+ # The index of a frame owner element's content document in the `domNodes` array returned by
+ # `getSnapshot`, if any.
+ optional integer contentDocumentIndex
+ # Type of a pseudo element node.
+ optional DOM.PseudoType pseudoType
+ # Shadow root type.
+ optional DOM.ShadowRootType shadowRootType
+ # Whether this DOM node responds to mouse clicks. This includes nodes that have had click
+ # event listeners attached via JavaScript as well as anchor tags that naturally navigate when
+ # clicked.
+ optional boolean isClickable
+ # Details of the node's event listeners, if any.
+ optional array of DOMDebugger.EventListener eventListeners
+ # The selected url for nodes with a srcset attribute.
+ optional string currentSourceURL
+ # The url of the script (if any) that generates this node.
+ optional string originURL
+ # Scroll offsets, set when this node is a Document.
+ optional number scrollOffsetX
+ optional number scrollOffsetY
+
+ # Details of post layout rendered text positions. The exact layout should not be regarded as
+ # stable and may change between versions.
+ type InlineTextBox extends object
+ properties
+ # The bounding box in document coordinates. Note that scroll offset of the document is ignored.
+ DOM.Rect boundingBox
+ # The starting index in characters, for this post layout textbox substring. Characters that
+ # would be represented as a surrogate pair in UTF-16 have length 2.
+ integer startCharacterIndex
+ # The number of characters in this post layout textbox substring. Characters that would be
+ # represented as a surrogate pair in UTF-16 have length 2.
+ integer numCharacters
+
+ # Details of an element in the DOM tree with a LayoutObject.
+ type LayoutTreeNode extends object
+ properties
+ # The index of the related DOM node in the `domNodes` array returned by `getSnapshot`.
+ integer domNodeIndex
+ # The bounding box in document coordinates. Note that scroll offset of the document is ignored.
+ DOM.Rect boundingBox
+ # Contents of the LayoutText, if any.
+ optional string layoutText
+ # The post-layout inline text nodes, if any.
+ optional array of InlineTextBox inlineTextNodes
+ # Index into the `computedStyles` array returned by `getSnapshot`.
+ optional integer styleIndex
+ # Global paint order index, which is determined by the stacking order of the nodes. Nodes
+ # that are painted together will have the same index. Only provided if includePaintOrder in
+ # getSnapshot was true.
+ optional integer paintOrder
+ # Set to true to indicate the element begins a new stacking context.
+ optional boolean isStackingContext
+
+ # A subset of the full ComputedStyle as defined by the request whitelist.
+ type ComputedStyle extends object
+ properties
+ # Name/value pairs of computed style properties.
+ array of NameValue properties
+
+ # A name/value pair.
+ type NameValue extends object
+ properties
+ # Attribute/property name.
+ string name
+ # Attribute/property value.
+ string value
+
+ # Index of the string in the strings table.
+ type StringIndex extends integer
+
+ # Index of the string in the strings table.
+ type ArrayOfStrings extends array of StringIndex
+
+ # Data that is only present on rare nodes.
+ type RareStringData extends object
+ properties
+ array of integer index
+ array of StringIndex value
+
+ type RareBooleanData extends object
+ properties
+ array of integer index
+
+ type RareIntegerData extends object
+ properties
+ array of integer index
+ array of integer value
+
+ type Rectangle extends array of number
+
+ # Document snapshot.
+ type DocumentSnapshot extends object
+ properties
+ # Document URL that `Document` or `FrameOwner` node points to.
+ StringIndex documentURL
+ # Document title.
+ StringIndex title
+ # Base URL that `Document` or `FrameOwner` node uses for URL completion.
+ StringIndex baseURL
+ # Contains the document's content language.
+ StringIndex contentLanguage
+ # Contains the document's character set encoding.
+ StringIndex encodingName
+ # `DocumentType` node's publicId.
+ StringIndex publicId
+ # `DocumentType` node's systemId.
+ StringIndex systemId
+ # Frame ID for frame owner elements and also for the document node.
+ StringIndex frameId
+ # A table with dom nodes.
+ NodeTreeSnapshot nodes
+ # The nodes in the layout tree.
+ LayoutTreeSnapshot layout
+ # The post-layout inline text nodes.
+ TextBoxSnapshot textBoxes
+ # Horizontal scroll offset.
+ optional number scrollOffsetX
+ # Vertical scroll offset.
+ optional number scrollOffsetY
+ # Document content width.
+ optional number contentWidth
+ # Document content height.
+ optional number contentHeight
+
+ # Table containing nodes.
+ type NodeTreeSnapshot extends object
+ properties
+ # Parent node index.
+ optional array of integer parentIndex
+ # `Node`'s nodeType.
+ optional array of integer nodeType
+ # Type of the shadow root the `Node` is in. String values are equal to the `ShadowRootType` enum.
+ optional RareStringData shadowRootType
+ # `Node`'s nodeName.
+ optional array of StringIndex nodeName
+ # `Node`'s nodeValue.
+ optional array of StringIndex nodeValue
+ # `Node`'s id, corresponds to DOM.Node.backendNodeId.
+ optional array of DOM.BackendNodeId backendNodeId
+ # Attributes of an `Element` node. Flatten name, value pairs.
+ optional array of ArrayOfStrings attributes
+ # Only set for textarea elements, contains the text value.
+ optional RareStringData textValue
+ # Only set for input elements, contains the input's associated text value.
+ optional RareStringData inputValue
+ # Only set for radio and checkbox input elements, indicates if the element has been checked
+ optional RareBooleanData inputChecked
+ # Only set for option elements, indicates if the element has been selected
+ optional RareBooleanData optionSelected
+ # The index of the document in the list of the snapshot documents.
+ optional RareIntegerData contentDocumentIndex
+ # Type of a pseudo element node.
+ optional RareStringData pseudoType
+ # Pseudo element identifier for this node. Only present if there is a
+ # valid pseudoType.
+ optional RareStringData pseudoIdentifier
+ # Whether this DOM node responds to mouse clicks. This includes nodes that have had click
+ # event listeners attached via JavaScript as well as anchor tags that naturally navigate when
+ # clicked.
+ optional RareBooleanData isClickable
+ # The selected url for nodes with a srcset attribute.
+ optional RareStringData currentSourceURL
+ # The url of the script (if any) that generates this node.
+ optional RareStringData originURL
+
+ # Table of details of an element in the DOM tree with a LayoutObject.
+ type LayoutTreeSnapshot extends object
+ properties
+ # Index of the corresponding node in the `NodeTreeSnapshot` array returned by `captureSnapshot`.
+ array of integer nodeIndex
+ # Array of indexes specifying computed style strings, filtered according to the `computedStyles` parameter passed to `captureSnapshot`.
+ array of ArrayOfStrings styles
+ # The absolute position bounding box.
+ array of Rectangle bounds
+ # Contents of the LayoutText, if any.
+ array of StringIndex text
+ # Stacking context information.
+ RareBooleanData stackingContexts
+ # Global paint order index, which is determined by the stacking order of the nodes. Nodes
+ # that are painted together will have the same index. Only provided if includePaintOrder in
+ # captureSnapshot was true.
+ optional array of integer paintOrders
+ # The offset rect of nodes. Only available when includeDOMRects is set to true
+ optional array of Rectangle offsetRects
+ # The scroll rect of nodes. Only available when includeDOMRects is set to true
+ optional array of Rectangle scrollRects
+ # The client rect of nodes. Only available when includeDOMRects is set to true
+ optional array of Rectangle clientRects
+ # The list of background colors that are blended with colors of overlapping elements.
+ experimental optional array of StringIndex blendedBackgroundColors
+ # The list of computed text opacities.
+ experimental optional array of number textColorOpacities
+
+ # Table of details of the post layout rendered text positions. The exact layout should not be regarded as
+ # stable and may change between versions.
+ type TextBoxSnapshot extends object
+ properties
+ # Index of the layout tree node that owns this box collection.
+ array of integer layoutIndex
+ # The absolute position bounding box.
+ array of Rectangle bounds
+ # The starting index in characters, for this post layout textbox substring. Characters that
+ # would be represented as a surrogate pair in UTF-16 have length 2.
+ array of integer start
+ # The number of characters in this post layout textbox substring. Characters that would be
+ # represented as a surrogate pair in UTF-16 have length 2.
+ array of integer length
+
+ # Disables DOM snapshot agent for the given page.
+ command disable
+
+ # Enables DOM snapshot agent for the given page.
+ command enable
+
+ # Returns a document snapshot, including the full DOM tree of the root node (including iframes,
+ # template contents, and imported documents) in a flattened array, as well as layout and
+ # white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
+ # flattened.
+ deprecated command getSnapshot
+ parameters
+ # Whitelist of computed styles to return.
+ array of string computedStyleWhitelist
+ # Whether or not to retrieve details of DOM listeners (default false).
+ optional boolean includeEventListeners
+ # Whether to determine and include the paint order index of LayoutTreeNodes (default false).
+ optional boolean includePaintOrder
+ # Whether to include UA shadow tree in the snapshot (default false).
+ optional boolean includeUserAgentShadowTree
+ returns
+ # The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
+ array of DOMNode domNodes
+ # The nodes in the layout tree.
+ array of LayoutTreeNode layoutTreeNodes
+ # Whitelisted ComputedStyle properties for each node in the layout tree.
+ array of ComputedStyle computedStyles
+
+ # Returns a document snapshot, including the full DOM tree of the root node (including iframes,
+ # template contents, and imported documents) in a flattened array, as well as layout and
+ # white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
+ # flattened.
+ command captureSnapshot
+ parameters
+ # Whitelist of computed styles to return.
+ array of string computedStyles
+ # Whether to include layout object paint orders into the snapshot.
+ optional boolean includePaintOrder
+ # Whether to include DOM rectangles (offsetRects, clientRects, scrollRects) into the snapshot
+ optional boolean includeDOMRects
+ # Whether to include blended background colors in the snapshot (default: false).
+ # Blended background color is achieved by blending background colors of all elements
+ # that overlap with the current element.
+ experimental optional boolean includeBlendedBackgroundColors
+ # Whether to include text color opacity in the snapshot (default: false).
+ # An element might have the opacity property set that affects the text color of the element.
+ # The final text color opacity is computed based on the opacity of all overlapping elements.
+ experimental optional boolean includeTextColorOpacities
+ returns
+ # The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
+ array of DocumentSnapshot documents
+ # Shared string table that all string properties refer to with indexes.
+ array of string strings
diff --git a/pdl/domains/DOMStorage.pdl b/pdl/domains/DOMStorage.pdl
new file mode 100644
index 00000000..ce2bd957
--- /dev/null
+++ b/pdl/domains/DOMStorage.pdl
@@ -0,0 +1,72 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Query and modify DOM storage.
+experimental domain DOMStorage
+
+ type SerializedStorageKey extends string
+
+ # DOM Storage identifier.
+ type StorageId extends object
+ properties
+ # Security origin for the storage.
+ optional string securityOrigin
+ # Represents a key by which DOM Storage keys its CachedStorageAreas
+ optional SerializedStorageKey storageKey
+ # Whether the storage is local storage (not session storage).
+ boolean isLocalStorage
+
+ # DOM Storage item.
+ type Item extends array of string
+
+ command clear
+ parameters
+ StorageId storageId
+
+ # Disables storage tracking, prevents storage events from being sent to the client.
+ command disable
+
+ # Enables storage tracking, storage events will now be delivered to the client.
+ command enable
+
+ command getDOMStorageItems
+ parameters
+ StorageId storageId
+ returns
+ array of Item entries
+
+ command removeDOMStorageItem
+ parameters
+ StorageId storageId
+ string key
+
+ command setDOMStorageItem
+ parameters
+ StorageId storageId
+ string key
+ string value
+
+ event domStorageItemAdded
+ parameters
+ StorageId storageId
+ string key
+ string newValue
+
+ event domStorageItemRemoved
+ parameters
+ StorageId storageId
+ string key
+
+ event domStorageItemUpdated
+ parameters
+ StorageId storageId
+ string key
+ string oldValue
+ string newValue
+
+ event domStorageItemsCleared
+ parameters
+ StorageId storageId
diff --git a/pdl/domains/DeviceAccess.pdl b/pdl/domains/DeviceAccess.pdl
new file mode 100644
index 00000000..1e94537f
--- /dev/null
+++ b/pdl/domains/DeviceAccess.pdl
@@ -0,0 +1,43 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain DeviceAccess
+ # Device request id.
+ type RequestId extends string
+
+ # A device id.
+ type DeviceId extends string
+
+ # Device information displayed in a user prompt to select a device.
+ type PromptDevice extends object
+ properties
+ DeviceId id
+ # Display name as it appears in a device request user prompt.
+ string name
+
+ # Enable events in this domain.
+ command enable
+
+ # Disable events in this domain.
+ command disable
+
+ # Select a device in response to a DeviceAccess.deviceRequestPrompted event.
+ command selectPrompt
+ parameters
+ RequestId id
+ DeviceId deviceId
+
+ # Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
+ command cancelPrompt
+ parameters
+ RequestId id
+
+ # A device request opened a user prompt to select a device. Respond with the
+ # selectPrompt or cancelPrompt command.
+ event deviceRequestPrompted
+ parameters
+ RequestId id
+ array of PromptDevice devices
diff --git a/pdl/domains/DeviceOrientation.pdl b/pdl/domains/DeviceOrientation.pdl
new file mode 100644
index 00000000..37116d3d
--- /dev/null
+++ b/pdl/domains/DeviceOrientation.pdl
@@ -0,0 +1,20 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain DeviceOrientation
+
+ # Clears the overridden Device Orientation.
+ command clearDeviceOrientationOverride
+
+ # Overrides the Device Orientation.
+ command setDeviceOrientationOverride
+ parameters
+ # Mock alpha
+ number alpha
+ # Mock beta
+ number beta
+ # Mock gamma
+ number gamma
diff --git a/pdl/domains/Emulation.pdl b/pdl/domains/Emulation.pdl
new file mode 100644
index 00000000..861b76ed
--- /dev/null
+++ b/pdl/domains/Emulation.pdl
@@ -0,0 +1,522 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain emulates different environments for the page.
+domain Emulation
+ depends on DOM
+ depends on Page
+ depends on Runtime
+
+ experimental type SafeAreaInsets extends object
+ properties
+ # Overrides safe-area-inset-top.
+ optional integer top
+ # Overrides safe-area-max-inset-top.
+ optional integer topMax
+ # Overrides safe-area-inset-left.
+ optional integer left
+ # Overrides safe-area-max-inset-left.
+ optional integer leftMax
+ # Overrides safe-area-inset-bottom.
+ optional integer bottom
+ # Overrides safe-area-max-inset-bottom.
+ optional integer bottomMax
+ # Overrides safe-area-inset-right.
+ optional integer right
+ # Overrides safe-area-max-inset-right.
+ optional integer rightMax
+
+ # Screen orientation.
+ type ScreenOrientation extends object
+ properties
+ # Orientation type.
+ enum type
+ portraitPrimary
+ portraitSecondary
+ landscapePrimary
+ landscapeSecondary
+ # Orientation angle.
+ integer angle
+
+ type DisplayFeature extends object
+ properties
+ # Orientation of a display feature in relation to screen
+ enum orientation
+ vertical
+ horizontal
+ # The offset from the screen origin in either the x (for vertical
+ # orientation) or y (for horizontal orientation) direction.
+ integer offset
+ # A display feature may mask content such that it is not physically
+ # displayed - this length along with the offset describes this area.
+ # A display feature that only splits content will have a 0 mask_length.
+ integer maskLength
+
+ type DevicePosture extends object
+ properties
+ # Current posture of the device
+ enum type
+ continuous
+ folded
+
+ type MediaFeature extends object
+ properties
+ string name
+ string value
+
+ # 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.
+ experimental type VirtualTimePolicy extends string
+ enum
+ advance
+ pause
+ pauseIfNetworkFetchesPending
+
+ # Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
+ experimental type UserAgentBrandVersion extends object
+ properties
+ string brand
+ string version
+
+ # Used to specify User Agent Client 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.
+ experimental type UserAgentMetadata extends object
+ properties
+ # Brands appearing in Sec-CH-UA.
+ optional array of UserAgentBrandVersion brands
+ # Brands appearing in Sec-CH-UA-Full-Version-List.
+ optional array of UserAgentBrandVersion fullVersionList
+ deprecated optional string fullVersion
+ string platform
+ string platformVersion
+ string architecture
+ string model
+ boolean mobile
+ optional string bitness
+ optional boolean wow64
+ # Used to specify User Agent form-factor values.
+ # See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
+ optional array of string formFactors
+
+ # Used to specify sensor types to emulate.
+ # See https://w3c.github.io/sensors/#automation for more information.
+ experimental type SensorType extends string
+ enum
+ absolute-orientation
+ accelerometer
+ ambient-light
+ gravity
+ gyroscope
+ linear-acceleration
+ magnetometer
+ relative-orientation
+
+ experimental type SensorMetadata extends object
+ properties
+ optional boolean available
+ optional number minimumFrequency
+ optional number maximumFrequency
+
+ experimental type SensorReadingSingle extends object
+ properties
+ number value
+
+ experimental type SensorReadingXYZ extends object
+ properties
+ number x
+ number y
+ number z
+
+ experimental type SensorReadingQuaternion extends object
+ properties
+ number x
+ number y
+ number z
+ number w
+
+ experimental type SensorReading extends object
+ properties
+ optional SensorReadingSingle single
+ optional SensorReadingXYZ xyz
+ optional SensorReadingQuaternion quaternion
+
+ experimental type PressureSource extends string
+ enum
+ cpu
+
+ experimental type PressureState extends string
+ enum
+ nominal
+ fair
+ serious
+ critical
+
+ experimental type PressureMetadata extends object
+ properties
+ optional boolean available
+
+ # Tells whether emulation is supported.
+ deprecated command canEmulate
+ returns
+ # True if emulation is supported.
+ boolean result
+
+ # Clears the overridden device metrics.
+ command clearDeviceMetricsOverride
+
+ # Clears the overridden Geolocation Position and Error.
+ command clearGeolocationOverride
+
+ # Requests that page scale factor is reset to initial values.
+ experimental command resetPageScaleFactor
+
+ # Enables or disables simulating a focused and active page.
+ experimental command setFocusEmulationEnabled
+ parameters
+ # Whether to enable to disable focus emulation.
+ boolean enabled
+
+ # Automatically render all web contents using a dark theme.
+ experimental command setAutoDarkModeOverride
+ parameters
+ # Whether to enable or disable automatic dark mode.
+ # If not specified, any existing override will be cleared.
+ optional boolean enabled
+
+ # Enables CPU throttling to emulate slow CPUs.
+ command setCPUThrottlingRate
+ parameters
+ # Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
+ number rate
+
+ # Sets or clears an override of the default background color of the frame. This override is used
+ # if the content does not specify one.
+ command setDefaultBackgroundColorOverride
+ parameters
+ # RGBA of the default background color. If not specified, any existing override will be
+ # cleared.
+ optional DOM.RGBA color
+
+ # Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+ # respective variables to be undefined, even if previously overridden.
+ experimental command setSafeAreaInsetsOverride
+ parameters
+ SafeAreaInsets insets
+
+ # Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
+ # window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
+ # query results).
+ command setDeviceMetricsOverride
+ parameters
+ # Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
+ integer width
+ # Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
+ integer height
+ # Overriding device scale factor value. 0 disables the override.
+ number deviceScaleFactor
+ # Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
+ # autosizing and more.
+ boolean mobile
+ # Scale to apply to resulting view image.
+ experimental optional number scale
+ # Overriding screen width value in pixels (minimum 0, maximum 10000000).
+ experimental optional integer screenWidth
+ # Overriding screen height value in pixels (minimum 0, maximum 10000000).
+ experimental optional integer screenHeight
+ # Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
+ experimental optional integer positionX
+ # Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
+ experimental optional integer positionY
+ # Do not set visible view size, rely upon explicit setVisibleSize call.
+ experimental optional boolean dontSetVisibleSize
+ # Screen orientation override.
+ optional ScreenOrientation screenOrientation
+ # If set, the visible area of the page will be overridden to this viewport. This viewport
+ # change is not observed by the page, e.g. viewport-relative elements do not change positions.
+ experimental optional Page.Viewport viewport
+ # If set, the display feature of a multi-segment screen. If not set, multi-segment support
+ # is turned-off.
+ # Deprecated, use Emulation.setDisplayFeaturesOverride.
+ experimental deprecated optional DisplayFeature displayFeature
+ # If set, the posture of a foldable device. If not set the posture is set
+ # to continuous.
+ # Deprecated, use Emulation.setDevicePostureOverride.
+ experimental deprecated optional DevicePosture devicePosture
+
+ # Start reporting the given posture value to the Device Posture API.
+ # This override can also be set in setDeviceMetricsOverride().
+ experimental command setDevicePostureOverride
+ parameters
+ DevicePosture posture
+
+ # Clears a device posture override set with either setDeviceMetricsOverride()
+ # or setDevicePostureOverride() and starts using posture information from the
+ # platform again.
+ # Does nothing if no override is set.
+ experimental command clearDevicePostureOverride
+
+ # Start using the given display features to pupulate the Viewport Segments API.
+ # This override can also be set in setDeviceMetricsOverride().
+ experimental command setDisplayFeaturesOverride
+ parameters
+ array of DisplayFeature features
+
+ # Clears the display features override set with either setDeviceMetricsOverride()
+ # or setDisplayFeaturesOverride() and starts using display features from the
+ # platform again.
+ # Does nothing if no override is set.
+ experimental command clearDisplayFeaturesOverride
+
+ experimental command setScrollbarsHidden
+ parameters
+ # Whether scrollbars should be always hidden.
+ boolean hidden
+
+ experimental command setDocumentCookieDisabled
+ parameters
+ # Whether document.coookie API should be disabled.
+ boolean disabled
+
+ experimental command setEmitTouchEventsForMouse
+ parameters
+ # Whether touch emulation based on mouse input should be enabled.
+ boolean enabled
+ # Touch/gesture events configuration. Default: current platform.
+ optional enum configuration
+ mobile
+ desktop
+
+ # Emulates the given media type or media feature for CSS media queries.
+ command setEmulatedMedia
+ parameters
+ # Media type to emulate. Empty string disables the override.
+ optional string media
+ # Media features to emulate.
+ optional array of MediaFeature features
+
+ # Emulates the given vision deficiency.
+ command setEmulatedVisionDeficiency
+ parameters
+ # Vision deficiency to emulate. Order: best-effort emulations come first, followed by any
+ # physiologically accurate emulations for medically recognized color vision deficiencies.
+ enum type
+ none
+ blurredVision
+ reducedContrast
+ achromatopsia
+ deuteranopia
+ protanopia
+ tritanopia
+
+ # Emulates the given OS text scale.
+ command setEmulatedOSTextScale
+ parameters
+ optional number scale
+
+ # Overrides the Geolocation Position or Error. Omitting latitude, longitude or
+ # accuracy emulates position unavailable.
+ command setGeolocationOverride
+ parameters
+ # Mock latitude
+ optional number latitude
+ # Mock longitude
+ optional number longitude
+ # Mock accuracy
+ optional number accuracy
+ # Mock altitude
+ optional number altitude
+ # Mock altitudeAccuracy
+ optional number altitudeAccuracy
+ # Mock heading
+ optional number heading
+ # Mock speed
+ optional number speed
+
+ experimental command getOverriddenSensorInformation
+ parameters
+ SensorType type
+ returns
+ number requestedSamplingFrequency
+
+ # Overrides a platform sensor of a given type. If |enabled| is true, calls to
+ # Sensor.start() will use a virtual sensor as backend rather than fetching
+ # data from a real hardware sensor. Otherwise, existing virtual
+ # sensor-backend Sensor objects will fire an error event and new calls to
+ # Sensor.start() will attempt to use a real sensor instead.
+ experimental command setSensorOverrideEnabled
+ parameters
+ boolean enabled
+ SensorType type
+ optional SensorMetadata metadata
+
+ # Updates the sensor readings reported by a sensor type previously overridden
+ # by setSensorOverrideEnabled.
+ experimental command setSensorOverrideReadings
+ parameters
+ SensorType type
+ SensorReading reading
+
+ # Overrides a pressure source of a given type, as used by the Compute
+ # Pressure API, so that updates to PressureObserver.observe() are provided
+ # via setPressureStateOverride instead of being retrieved from
+ # platform-provided telemetry data.
+ experimental command setPressureSourceOverrideEnabled
+ parameters
+ boolean enabled
+ PressureSource source
+ optional PressureMetadata metadata
+
+ # TODO: OBSOLETE: To remove when setPressureDataOverride is merged.
+ # Provides a given pressure state that will be processed and eventually be
+ # delivered to PressureObserver users. |source| must have been previously
+ # overridden by setPressureSourceOverrideEnabled.
+ experimental command setPressureStateOverride
+ parameters
+ PressureSource source
+ PressureState state
+
+ # Provides a given pressure data set that will be processed and eventually be
+ # delivered to PressureObserver users. |source| must have been previously
+ # overridden by setPressureSourceOverrideEnabled.
+ experimental command setPressureDataOverride
+ parameters
+ PressureSource source
+ PressureState state
+ optional number ownContributionEstimate
+
+ # Overrides the Idle state.
+ command setIdleOverride
+ parameters
+ # Mock isUserActive
+ boolean isUserActive
+ # Mock isScreenUnlocked
+ boolean isScreenUnlocked
+
+ # Clears Idle state overrides.
+ command clearIdleOverride
+
+ # Overrides value returned by the javascript navigator object.
+ experimental deprecated command setNavigatorOverrides
+ parameters
+ # The platform navigator.platform should return.
+ string platform
+
+ # Sets a specified page scale factor.
+ experimental command setPageScaleFactor
+ parameters
+ # Page scale factor.
+ number pageScaleFactor
+
+ # Switches script execution in the page.
+ command setScriptExecutionDisabled
+ parameters
+ # Whether script execution should be disabled in the page.
+ boolean value
+
+ # Enables touch on platforms which do not support them.
+ command setTouchEmulationEnabled
+ parameters
+ # Whether the touch event emulation should be enabled.
+ boolean enabled
+ # Maximum touch points supported. Defaults to one.
+ optional integer maxTouchPoints
+
+ # Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets
+ # the current virtual time policy. Note this supersedes any previous time budget.
+ experimental command setVirtualTimePolicy
+ parameters
+ VirtualTimePolicy policy
+ # If set, after this many virtual milliseconds have elapsed virtual time will be paused and a
+ # virtualTimeBudgetExpired event is sent.
+ optional number budget
+ # If set this specifies the maximum number of tasks that can be run before virtual is forced
+ # forwards to prevent deadlock.
+ optional integer maxVirtualTimeTaskStarvationCount
+ # If set, base::Time::Now will be overridden to initially return this value.
+ optional Network.TimeSinceEpoch initialVirtualTime
+ returns
+ # Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
+ number virtualTimeTicksBase
+
+ # Overrides default host system locale with the specified one.
+ experimental command setLocaleOverride
+ parameters
+ # ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and
+ # restores default host system locale.
+ optional string locale
+
+ # Overrides default host system timezone with the specified one.
+ command setTimezoneOverride
+ parameters
+ # The timezone identifier. List of supported timezones:
+ # https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt
+ # If empty, disables the override and restores default host system timezone.
+ string timezoneId
+
+ # Resizes the frame/viewport of the page. Note that this does not affect the frame's container
+ # (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported
+ # on Android.
+ experimental deprecated command setVisibleSize
+ parameters
+ # Frame width (DIP).
+ integer width
+ # Frame height (DIP).
+ integer height
+
+ # Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
+ experimental event virtualTimeBudgetExpired
+
+ # Enum of image types that can be disabled.
+ experimental type DisabledImageType extends string
+ enum
+ avif
+ webp
+
+ experimental command setDisabledImageTypes
+ parameters
+ # Image types to disable.
+ array of DisabledImageType imageTypes
+
+
+ # Override the value of navigator.connection.saveData
+ experimental command setDataSaverOverride
+ parameters
+ # Override value. Omitting the parameter disables the override.
+ optional boolean dataSaverEnabled
+
+ experimental command setHardwareConcurrencyOverride
+ parameters
+ # Hardware concurrency to report
+ integer hardwareConcurrency
+
+ # Allows overriding user agent with the given string.
+ # `userAgentMetadata` must be set for Client Hint headers to be sent.
+ command setUserAgentOverride
+ parameters
+ # User agent to use.
+ string userAgent
+ # Browser language to emulate.
+ optional string acceptLanguage
+ # The platform navigator.platform should return.
+ optional string platform
+ # To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
+ experimental optional UserAgentMetadata userAgentMetadata
+
+ # Allows overriding the automation flag.
+ experimental command setAutomationOverride
+ parameters
+ # Whether the override should be enabled.
+ boolean enabled
+
+ # Allows overriding the difference between the small and large viewport sizes, which determine the
+ # value of the `svh` and `lvh` unit, respectively. Only supported for top-level frames.
+ experimental command setSmallViewportHeightDifferenceOverride
+ parameters
+ # This will cause an element of size 100svh to be `difference` pixels smaller than an element
+ # of size 100lvh.
+ integer difference
diff --git a/pdl/domains/EventBreakpoints.pdl b/pdl/domains/EventBreakpoints.pdl
new file mode 100644
index 00000000..c87e666b
--- /dev/null
+++ b/pdl/domains/EventBreakpoints.pdl
@@ -0,0 +1,24 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# EventBreakpoints permits setting JavaScript breakpoints on operations and events
+# occurring in native code invoked from JavaScript. Once breakpoint is hit, it is
+# reported through Debugger domain, similarly to regular breakpoints being hit.
+experimental domain EventBreakpoints
+ # Sets breakpoint on particular native event.
+ command setInstrumentationBreakpoint
+ parameters
+ # Instrumentation name to stop on.
+ string eventName
+
+ # Removes breakpoint on particular native event.
+ command removeInstrumentationBreakpoint
+ parameters
+ # Instrumentation name to stop on.
+ string eventName
+
+ # Removes all breakpoints
+ command disable
diff --git a/pdl/domains/Extensions.pdl b/pdl/domains/Extensions.pdl
new file mode 100644
index 00000000..8f983450
--- /dev/null
+++ b/pdl/domains/Extensions.pdl
@@ -0,0 +1,72 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Defines commands and events for browser extensions.
+experimental domain Extensions
+ # Storage areas.
+ type StorageArea extends string
+ enum
+ session
+ local
+ sync
+ managed
+ # Installs an unpacked extension from the filesystem similar to
+ # --load-extension CLI flags. Returns extension ID once the extension
+ # has been installed. Available if the client is connected using the
+ # --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
+ # flag is set.
+ command loadUnpacked
+ parameters
+ # Absolute file path.
+ string path
+ returns
+ # Extension id.
+ string id
+ # Uninstalls an unpacked extension (others not supported) from the profile.
+ # Available if the client is connected using the --remote-debugging-pipe flag
+ # and the --enable-unsafe-extension-debugging.
+ command uninstall
+ parameters
+ # Extension id.
+ string id
+ # Gets data from extension storage in the given `storageArea`. If `keys` is
+ # specified, these are used to filter the result.
+ command getStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to retrieve data from.
+ StorageArea storageArea
+ # Keys to retrieve.
+ optional array of string keys
+ returns
+ object data
+ # Removes `keys` from extension storage in the given `storageArea`.
+ command removeStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to remove data from.
+ StorageArea storageArea
+ # Keys to remove.
+ array of string keys
+ # Clears extension storage in the given `storageArea`.
+ command clearStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to remove data from.
+ StorageArea storageArea
+ # Sets `values` in extension storage in the given `storageArea`. The provided `values`
+ # will be merged with existing values in the storage area.
+ command setStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to set data in.
+ StorageArea storageArea
+ # Values to set.
+ object values
diff --git a/pdl/domains/FedCm.pdl b/pdl/domains/FedCm.pdl
new file mode 100644
index 00000000..3dd4e0d3
--- /dev/null
+++ b/pdl/domains/FedCm.pdl
@@ -0,0 +1,100 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows interacting with the FedCM dialog.
+experimental domain FedCm
+ # Whether this is a sign-up or sign-in action for this account, i.e.
+ # whether this account has ever been used to sign in to this RP before.
+ type LoginState extends string
+ enum
+ SignIn
+ SignUp
+
+ # The types of FedCM dialogs.
+ type DialogType extends string
+ enum
+ AccountChooser
+ AutoReauthn
+ ConfirmIdpLogin
+ Error
+
+ # The buttons on the FedCM dialog.
+ type DialogButton extends string
+ enum
+ ConfirmIdpLoginContinue
+ ErrorGotIt
+ ErrorMoreDetails
+
+ # The URLs that each account has
+ type AccountUrlType extends string
+ enum
+ TermsOfService
+ PrivacyPolicy
+
+ # Corresponds to IdentityRequestAccount
+ type Account extends object
+ properties
+ string accountId
+ string email
+ string name
+ string givenName
+ string pictureUrl
+ string idpConfigUrl
+ string idpLoginUrl
+ LoginState loginState
+ # These two are only set if the loginState is signUp
+ optional string termsOfServiceUrl
+ optional string privacyPolicyUrl
+
+ event dialogShown
+ parameters
+ string dialogId
+ DialogType dialogType
+ array of Account accounts
+ # These exist primarily so that the caller can verify the
+ # RP context was used appropriately.
+ string title
+ optional string subtitle
+
+ # Triggered when a dialog is closed, either by user action, JS abort,
+ # or a command below.
+ event dialogClosed
+ parameters
+ string dialogId
+
+ command enable
+ parameters
+ # Allows callers to disable the promise rejection delay that would
+ # normally happen, if this is unimportant to what's being tested.
+ # (step 4 of https://fedidcg.github.io/FedCM/#browser-api-rp-sign-in)
+ optional boolean disableRejectionDelay
+
+ command disable
+
+ command selectAccount
+ parameters
+ string dialogId
+ integer accountIndex
+
+ command clickDialogButton
+ parameters
+ string dialogId
+ DialogButton dialogButton
+
+ command openUrl
+ parameters
+ string dialogId
+ integer accountIndex
+ AccountUrlType accountUrlType
+
+ command dismissDialog
+ parameters
+ string dialogId
+ optional boolean triggerCooldown
+
+ # Resets the cooldown time, if any, to allow the next FedCM call to show
+ # a dialog even if one was recently dismissed by the user.
+ command resetCooldown
diff --git a/pdl/domains/Fetch.pdl b/pdl/domains/Fetch.pdl
new file mode 100644
index 00000000..69852c2d
--- /dev/null
+++ b/pdl/domains/Fetch.pdl
@@ -0,0 +1,251 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# A domain for letting clients substitute browser's network layer with client code.
+domain Fetch
+ depends on Network
+ depends on IO
+ depends on Page
+
+ # Unique request identifier.
+ # Note that this does not identify individual HTTP requests that are part of
+ # a network request.
+ type RequestId extends string
+
+ # 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).
+ type RequestStage extends string
+ enum
+ Request
+ Response
+
+ type RequestPattern extends object
+ properties
+ # Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
+ # backslash. Omitting is equivalent to `"*"`.
+ optional string urlPattern
+ # If set, only requests for matching resource types will be intercepted.
+ optional Network.ResourceType resourceType
+ # Stage at which to begin intercepting requests. Default is Request.
+ optional RequestStage requestStage
+
+ # Response HTTP header entry
+ type HeaderEntry extends object
+ properties
+ string name
+ string value
+
+ # Authorization challenge for HTTP status code 401 or 407.
+ type AuthChallenge extends object
+ properties
+ # Source of the authentication challenge.
+ optional enum source
+ Server
+ Proxy
+ # Origin of the challenger.
+ string origin
+ # The authentication scheme used, such as basic or digest
+ string scheme
+ # The realm of the challenge. May be empty.
+ string realm
+
+ # Response to an AuthChallenge.
+ type AuthChallengeResponse extends object
+ properties
+ # The decision on what to do in response to the authorization challenge. Default means
+ # deferring to the default behavior of the net stack, which will likely either the Cancel
+ # authentication or display a popup dialog box.
+ enum response
+ Default
+ CancelAuth
+ ProvideCredentials
+ # The username to provide, possibly empty. Should only be set if response is
+ # ProvideCredentials.
+ optional string username
+ # The password to provide, possibly empty. Should only be set if response is
+ # ProvideCredentials.
+ optional string password
+
+ # Disables the fetch domain.
+ command disable
+
+ # Enables issuing of requestPaused events. A request will be paused until client
+ # calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
+ command enable
+ parameters
+ # If specified, only requests matching any of these patterns will produce
+ # fetchRequested event and will be paused until clients response. If not set,
+ # all requests will be affected.
+ optional array of RequestPattern patterns
+ # If true, authRequired events will be issued and requests will be paused
+ # expecting a call to continueWithAuth.
+ optional boolean handleAuthRequests
+
+ # Causes the request to fail with specified reason.
+ command failRequest
+ parameters
+ # An id the client received in requestPaused event.
+ RequestId requestId
+ # Causes the request to fail with the given reason.
+ Network.ErrorReason errorReason
+
+ # Provides response to the request.
+ command fulfillRequest
+ parameters
+ # An id the client received in requestPaused event.
+ RequestId requestId
+ # An HTTP response code.
+ integer responseCode
+ # Response headers.
+ optional array of HeaderEntry responseHeaders
+ # Alternative way of specifying response headers as a \0-separated
+ # series of name: value pairs. Prefer the above method unless you
+ # need to represent some non-UTF8 values that can't be transmitted
+ # over the protocol as text.
+ optional binary binaryResponseHeaders
+ # A response body. If absent, original response body will be used if
+ # the request is intercepted at the response stage and empty body
+ # will be used if the request is intercepted at the request stage.
+ optional binary body
+ # A textual representation of responseCode.
+ # If absent, a standard phrase matching responseCode is used.
+ optional string responsePhrase
+
+ # Continues the request, optionally modifying some of its parameters.
+ command continueRequest
+ parameters
+ # An id the client received in requestPaused event.
+ RequestId requestId
+ # If set, the request url will be modified in a way that's not observable by page.
+ optional string url
+ # If set, the request method is overridden.
+ optional string method
+ # If set, overrides the post data in the request.
+ optional binary postData
+ # If set, overrides the request headers. Note that the overrides do not
+ # extend to subsequent redirect hops, if a redirect happens. Another override
+ # may be applied to a different request produced by a redirect.
+ optional array of HeaderEntry headers
+ # If set, overrides response interception behavior for this request.
+ experimental optional boolean interceptResponse
+
+ # Continues a request supplying authChallengeResponse following authRequired event.
+ command continueWithAuth
+ parameters
+ # An id the client received in authRequired event.
+ RequestId requestId
+ # Response to with an authChallenge.
+ AuthChallengeResponse authChallengeResponse
+
+ # Continues loading of the paused response, optionally modifying the
+ # response headers. If either responseCode or headers are modified, all of them
+ # must be present.
+ experimental command continueResponse
+ parameters
+ # An id the client received in requestPaused event.
+ RequestId requestId
+ # An HTTP response code. If absent, original response code will be used.
+ optional integer responseCode
+ # A textual representation of responseCode.
+ # If absent, a standard phrase matching responseCode is used.
+ optional string responsePhrase
+ # Response headers. If absent, original response headers will be used.
+ optional array of HeaderEntry responseHeaders
+ # Alternative way of specifying response headers as a \0-separated
+ # series of name: value pairs. Prefer the above method unless you
+ # need to represent some non-UTF8 values that can't be transmitted
+ # over the protocol as text.
+ optional binary binaryResponseHeaders
+
+ # Causes the body of the response to be received from the server and
+ # returned as a single string. May only be issued for a request that
+ # is paused in the Response stage and is mutually exclusive with
+ # takeResponseBodyForInterceptionAsStream. Calling other methods that
+ # affect the request or disabling fetch domain before body is received
+ # results in an undefined behavior.
+ # Note that the response body is not available for redirects. Requests
+ # paused in the _redirect received_ state may be differentiated by
+ # `responseCode` and presence of `location` response header, see
+ # comments to `requestPaused` for details.
+ command getResponseBody
+ parameters
+ # Identifier for the intercepted request to get body for.
+ RequestId requestId
+ returns
+ # Response body.
+ string body
+ # True, if content was sent as base64.
+ boolean base64Encoded
+
+ # Returns a handle to the stream representing the response body.
+ # The request must be paused in the HeadersReceived stage.
+ # Note that after this command the request can't be continued
+ # as is -- client either needs to cancel it or to provide the
+ # response body.
+ # The stream only supports sequential read, IO.read will fail if the position
+ # is specified.
+ # This method is mutually exclusive with getResponseBody.
+ # Calling other methods that affect the request or disabling fetch
+ # domain before body is received results in an undefined behavior.
+ command takeResponseBodyAsStream
+ parameters
+ RequestId requestId
+ returns
+ IO.StreamHandle stream
+
+ # 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.
+ # Redirect responses and subsequent requests are reported similarly to regular
+ # responses and requests. Redirect responses may be distinguished by the value
+ # of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
+ # presence of the `location` header. Requests resulting from a redirect will
+ # have `redirectedRequestId` field set.
+ event requestPaused
+ parameters
+ # Each request the page makes will have a unique id.
+ RequestId requestId
+ # The details of the request.
+ Network.Request request
+ # The id of the frame that initiated the request.
+ Page.FrameId frameId
+ # How the requested resource will be used.
+ Network.ResourceType resourceType
+ # Response error if intercepted at response stage.
+ optional Network.ErrorReason responseErrorReason
+ # Response code if intercepted at response stage.
+ optional integer responseStatusCode
+ # Response status text if intercepted at response stage.
+ optional string responseStatusText
+ # Response headers if intercepted at the response stage.
+ optional array of HeaderEntry responseHeaders
+ # If the intercepted request had a corresponding Network.requestWillBeSent event fired for it,
+ # then this networkId will be the same as the requestId present in the requestWillBeSent event.
+ optional Network.RequestId networkId
+ # If the request is due to a redirect response from the server, the id of the request that
+ # has caused the redirect.
+ experimental optional RequestId redirectedRequestId
+
+ # Issued when the domain is enabled with handleAuthRequests set to true.
+ # The request is paused until client responds with continueWithAuth.
+ event authRequired
+ parameters
+ # Each request the page makes will have a unique id.
+ RequestId requestId
+ # The details of the request.
+ Network.Request request
+ # The id of the frame that initiated the request.
+ Page.FrameId frameId
+ # How the requested resource will be used.
+ Network.ResourceType resourceType
+ # Details of the Authorization Challenge encountered.
+ # If this is set, client should respond with continueRequest that
+ # contains AuthChallengeResponse.
+ AuthChallenge authChallenge
diff --git a/pdl/domains/FileSystem.pdl b/pdl/domains/FileSystem.pdl
new file mode 100644
index 00000000..4f495c00
--- /dev/null
+++ b/pdl/domains/FileSystem.pdl
@@ -0,0 +1,41 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain FileSystem
+ depends on Network
+ depends on Storage
+
+ type File extends object
+ properties
+ string name
+ # Timestamp
+ Network.TimeSinceEpoch lastModified
+ # Size in bytes
+ number size
+ string type
+
+ type Directory extends object
+ properties
+ string name
+ array of string nestedDirectories
+ # Files that are directly nested under this directory.
+ array of File nestedFiles
+
+ type BucketFileSystemLocator extends object
+ properties
+ # Storage key
+ Storage.SerializedStorageKey storageKey
+ # Bucket name. Not passing a `bucketName` will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
+ optional string bucketName
+ # Path to the directory using each path component as an array item.
+ array of string pathComponents
+
+ command getDirectory
+ parameters
+ BucketFileSystemLocator bucketFileSystemLocator
+ returns
+ # Returns the directory object at the path.
+ Directory directory
diff --git a/pdl/domains/HeadlessExperimental.pdl b/pdl/domains/HeadlessExperimental.pdl
new file mode 100644
index 00000000..b67f57ac
--- /dev/null
+++ b/pdl/domains/HeadlessExperimental.pdl
@@ -0,0 +1,56 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain provides experimental commands only supported in headless mode.
+experimental domain HeadlessExperimental
+ depends on Page
+ depends on Runtime
+
+ # Encoding options for a screenshot.
+ type ScreenshotParams extends object
+ properties
+ # Image compression format (defaults to png).
+ optional enum format
+ jpeg
+ png
+ webp
+ # Compression quality from range [0..100] (jpeg and webp only).
+ optional integer quality
+ # Optimize image encoding for speed, not for resulting size (defaults to false)
+ optional boolean optimizeForSpeed
+
+ # Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
+ # screenshot from the resulting frame. Requires that the target was created with enabled
+ # BeginFrameControl. Designed for use with --run-all-compositor-stages-before-draw, see also
+ # https://goo.gle/chrome-headless-rendering for more background.
+ command beginFrame
+ parameters
+ # Timestamp of this BeginFrame in Renderer TimeTicks (milliseconds of uptime). If not set,
+ # the current time will be used.
+ optional number frameTimeTicks
+ # The interval between BeginFrames that is reported to the compositor, in milliseconds.
+ # Defaults to a 60 frames/second interval, i.e. about 16.666 milliseconds.
+ optional number interval
+ # Whether updates should not be committed and drawn onto the display. False by default. If
+ # true, only side effects of the BeginFrame will be run, such as layout and animations, but
+ # any visual updates may not be visible on the display or in screenshots.
+ optional boolean noDisplayUpdates
+ # If set, a screenshot of the frame will be captured and returned in the response. Otherwise,
+ # no screenshot will be captured. Note that capturing a screenshot can fail, for example,
+ # during renderer initialization. In such a case, no screenshot data will be returned.
+ optional ScreenshotParams screenshot
+ returns
+ # Whether the BeginFrame resulted in damage and, thus, a new frame was committed to the
+ # display. Reported for diagnostic uses, may be removed in the future.
+ boolean hasDamage
+ # Base64-encoded image data of the screenshot, if one was requested and successfully taken.
+ optional binary screenshotData
+
+ # Disables headless events for the target.
+ deprecated command disable
+
+ # Enables headless events for the target.
+ deprecated command enable
diff --git a/pdl/domains/IO.pdl b/pdl/domains/IO.pdl
new file mode 100644
index 00000000..2f5bf657
--- /dev/null
+++ b/pdl/domains/IO.pdl
@@ -0,0 +1,45 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Input/Output operations for streams produced by DevTools.
+domain IO
+
+ # This is either obtained from another method or specified as `blob:<uuid>` where
+ # `<uuid>` is an UUID of a Blob.
+ type StreamHandle extends string
+
+ # Close the stream, discard any temporary backing storage.
+ command close
+ parameters
+ # Handle of the stream to close.
+ StreamHandle handle
+
+ # Read a chunk of the stream
+ command read
+ parameters
+ # Handle of the stream to read.
+ StreamHandle handle
+ # Seek to the specified offset before reading (if not specified, proceed with offset
+ # following the last read). Some types of streams may only support sequential reads.
+ optional integer offset
+ # Maximum number of bytes to read (left upon the agent discretion if not specified).
+ optional integer size
+ returns
+ # Set if the data is base64-encoded
+ optional boolean base64Encoded
+ # Data that were read.
+ string data
+ # Set if the end-of-file condition occurred while reading.
+ boolean eof
+
+ # Return UUID of Blob object specified by a remote object id.
+ command resolveBlob
+ parameters
+ # Object id of a Blob object wrapper.
+ Runtime.RemoteObjectId objectId
+ returns
+ # UUID of the specified Blob.
+ string uuid
diff --git a/pdl/domains/IndexedDB.pdl b/pdl/domains/IndexedDB.pdl
new file mode 100644
index 00000000..9a03d95f
--- /dev/null
+++ b/pdl/domains/IndexedDB.pdl
@@ -0,0 +1,226 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain IndexedDB
+ depends on Runtime
+ depends on Storage
+
+ # Database with an array of object stores.
+ type DatabaseWithObjectStores extends object
+ properties
+ # Database name.
+ string name
+ # Database version (type is not 'integer', as the standard
+ # requires the version number to be 'unsigned long long')
+ number version
+ # Object stores in this database.
+ array of ObjectStore objectStores
+
+ # Object store.
+ type ObjectStore extends object
+ properties
+ # Object store name.
+ string name
+ # Object store key path.
+ KeyPath keyPath
+ # If true, object store has auto increment flag set.
+ boolean autoIncrement
+ # Indexes in this object store.
+ array of ObjectStoreIndex indexes
+
+ # Object store index.
+ type ObjectStoreIndex extends object
+ properties
+ # Index name.
+ string name
+ # Index key path.
+ KeyPath keyPath
+ # If true, index is unique.
+ boolean unique
+ # If true, index allows multiple entries for a key.
+ boolean multiEntry
+
+ # Key.
+ type Key extends object
+ properties
+ # Key type.
+ enum type
+ number
+ string
+ date
+ array
+ # Number value.
+ optional number number
+ # String value.
+ optional string string
+ # Date value.
+ optional number date
+ # Array value.
+ optional array of Key array
+
+ # Key range.
+ type KeyRange extends object
+ properties
+ # Lower bound.
+ optional Key lower
+ # Upper bound.
+ optional Key upper
+ # If true lower bound is open.
+ boolean lowerOpen
+ # If true upper bound is open.
+ boolean upperOpen
+
+ # Data entry.
+ type DataEntry extends object
+ properties
+ # Key object.
+ Runtime.RemoteObject key
+ # Primary key object.
+ Runtime.RemoteObject primaryKey
+ # Value object.
+ Runtime.RemoteObject value
+
+ # Key path.
+ type KeyPath extends object
+ properties
+ # Key path type.
+ enum type
+ null
+ string
+ array
+ # String value.
+ optional string string
+ # Array value.
+ optional array of string array
+
+ # Clears all entries from an object store.
+ command clearObjectStore
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ # Database name.
+ string databaseName
+ # Object store name.
+ string objectStoreName
+
+ # Deletes a database.
+ command deleteDatabase
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ # Database name.
+ string databaseName
+
+ # Delete a range of entries from an object store
+ command deleteObjectStoreEntries
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ string databaseName
+ string objectStoreName
+ # Range of entry keys to delete
+ KeyRange keyRange
+
+ # Disables events from backend.
+ command disable
+
+ # Enables events from backend.
+ command enable
+
+ # Requests data from object store or index.
+ command requestData
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ # Database name.
+ string databaseName
+ # Object store name.
+ string objectStoreName
+ # Index name, empty string for object store data requests.
+ string indexName
+ # Number of records to skip.
+ integer skipCount
+ # Number of records to fetch.
+ integer pageSize
+ # Key range.
+ optional KeyRange keyRange
+ returns
+ # Array of object store data entries.
+ array of DataEntry objectStoreDataEntries
+ # If true, there are more entries to fetch in the given range.
+ boolean hasMore
+
+ # Gets metadata of an object store.
+ command getMetadata
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ # Database name.
+ string databaseName
+ # Object store name.
+ string objectStoreName
+ returns
+ # the entries count
+ number entriesCount
+ # the current value of key generator, to become the next inserted
+ # key into the object store. Valid if objectStore.autoIncrement
+ # is true.
+ number keyGeneratorValue
+
+ # Requests database with given name in given frame.
+ command requestDatabase
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ # Database name.
+ string databaseName
+ returns
+ # Database with an array of object stores.
+ DatabaseWithObjectStores databaseWithObjectStores
+
+ # Requests database names for given security origin.
+ command requestDatabaseNames
+ parameters
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
+ returns
+ # Database names for origin.
+ array of string databaseNames
diff --git a/pdl/domains/Input.pdl b/pdl/domains/Input.pdl
new file mode 100644
index 00000000..815bf7c4
--- /dev/null
+++ b/pdl/domains/Input.pdl
@@ -0,0 +1,336 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+domain Input
+
+ type TouchPoint extends object
+ properties
+ # X coordinate of the event relative to the main frame's viewport in CSS pixels.
+ number x
+ # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
+ # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
+ number y
+ # X radius of the touch area (default: 1.0).
+ optional number radiusX
+ # Y radius of the touch area (default: 1.0).
+ optional number radiusY
+ # Rotation angle (default: 0.0).
+ optional number rotationAngle
+ # Force (default: 1.0).
+ optional number force
+ # The normalized tangential pressure, which has a range of [-1,1] (default: 0).
+ experimental optional number tangentialPressure
+ # The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
+ optional number tiltX
+ # The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
+ optional number tiltY
+ # The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
+ experimental optional integer twist
+ # Identifier used to track touch sources between events, must be unique within an event.
+ optional number id
+
+ experimental type GestureSourceType extends string
+ enum
+ default
+ touch
+ mouse
+
+ type MouseButton extends string
+ enum
+ none
+ left
+ middle
+ right
+ back
+ forward
+
+ # UTC time in seconds, counted from January 1, 1970.
+ type TimeSinceEpoch extends number
+
+ experimental type DragDataItem extends object
+ properties
+ # Mime type of the dragged data.
+ string mimeType
+ # Depending of the value of `mimeType`, it contains the dragged link,
+ # text, HTML markup or any other data.
+ string data
+
+ # Title associated with a link. Only valid when `mimeType` == "text/uri-list".
+ optional string title
+
+ # Stores the base URL for the contained markup. Only valid when `mimeType`
+ # == "text/html".
+ optional string baseURL
+
+
+ experimental type DragData extends object
+ properties
+ array of DragDataItem items
+ # List of filenames that should be included when dropping
+ optional array of string files
+ # Bit field representing allowed drag operations. Copy = 1, Link = 2, Move = 16
+ integer dragOperationsMask
+
+ # Dispatches a drag event into the page.
+ experimental command dispatchDragEvent
+ parameters
+ # Type of the drag event.
+ enum type
+ dragEnter
+ dragOver
+ drop
+ dragCancel
+ # X coordinate of the event relative to the main frame's viewport in CSS pixels.
+ number x
+ # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
+ # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
+ number y
+ DragData data
+ # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
+ # (default: 0).
+ optional integer modifiers
+
+ # Dispatches a key event to the page.
+ command dispatchKeyEvent
+ parameters
+ # Type of the key event.
+ enum type
+ keyDown
+ keyUp
+ rawKeyDown
+ char
+ # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
+ # (default: 0).
+ optional integer modifiers
+ # Time at which the event occurred.
+ optional TimeSinceEpoch timestamp
+ # Text as generated by processing a virtual key code with a keyboard layout. Not needed for
+ # for `keyUp` and `rawKeyDown` events (default: "")
+ optional string text
+ # Text that would have been generated by the keyboard if no modifiers were pressed (except for
+ # shift). Useful for shortcut (accelerator) key handling (default: "").
+ optional string unmodifiedText
+ # Unique key identifier (e.g., 'U+0041') (default: "").
+ optional string keyIdentifier
+ # Unique DOM defined string value for each physical key (e.g., 'KeyA') (default: "").
+ optional string code
+ # Unique DOM defined string value describing the meaning of the key in the context of active
+ # modifiers, keyboard layout, etc (e.g., 'AltGr') (default: "").
+ optional string key
+ # Windows virtual key code (default: 0).
+ optional integer windowsVirtualKeyCode
+ # Native virtual key code (default: 0).
+ optional integer nativeVirtualKeyCode
+ # Whether the event was generated from auto repeat (default: false).
+ optional boolean autoRepeat
+ # Whether the event was generated from the keypad (default: false).
+ optional boolean isKeypad
+ # Whether the event was a system key event (default: false).
+ optional boolean isSystemKey
+ # Whether the event was from the left or right side of the keyboard. 1=Left, 2=Right (default:
+ # 0).
+ optional integer location
+ # Editing commands to send with the key event (e.g., 'selectAll') (default: []).
+ # These are related to but not equal the command names used in `document.execCommand` and NSStandardKeyBindingResponding.
+ # See https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/editing/commands/editor_command_names.h for valid command names.
+ experimental optional array of string commands
+
+ # This method emulates inserting text that doesn't come from a key press,
+ # for example an emoji keyboard or an IME.
+ experimental command insertText
+ parameters
+ # The text to insert.
+ string text
+
+ # This method sets the current candidate text for IME.
+ # Use imeCommitComposition to commit the final text.
+ # Use imeSetComposition with empty string as text to cancel composition.
+ experimental command imeSetComposition
+ parameters
+ # The text to insert
+ string text
+ # selection start
+ integer selectionStart
+ # selection end
+ integer selectionEnd
+ # replacement start
+ optional integer replacementStart
+ # replacement end
+ optional integer replacementEnd
+
+ # Dispatches a mouse event to the page.
+ command dispatchMouseEvent
+ parameters
+ # Type of the mouse event.
+ enum type
+ mousePressed
+ mouseReleased
+ mouseMoved
+ mouseWheel
+ # X coordinate of the event relative to the main frame's viewport in CSS pixels.
+ number x
+ # Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
+ # the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
+ number y
+ # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
+ # (default: 0).
+ optional integer modifiers
+ # Time at which the event occurred.
+ optional TimeSinceEpoch timestamp
+ # Mouse button (default: "none").
+ optional MouseButton button
+ # A number indicating which buttons are pressed on the mouse when a mouse event is triggered.
+ # Left=1, Right=2, Middle=4, Back=8, Forward=16, None=0.
+ optional integer buttons
+ # Number of times the mouse button was clicked (default: 0).
+ optional integer clickCount
+ # The normalized pressure, which has a range of [0,1] (default: 0).
+ experimental optional number force
+ # The normalized tangential pressure, which has a range of [-1,1] (default: 0).
+ experimental optional number tangentialPressure
+ # The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0).
+ optional number tiltX
+ # The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
+ optional number tiltY
+ # The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
+ experimental optional integer twist
+ # X delta in CSS pixels for mouse wheel event (default: 0).
+ optional number deltaX
+ # Y delta in CSS pixels for mouse wheel event (default: 0).
+ optional number deltaY
+ # Pointer type (default: "mouse").
+ optional enum pointerType
+ mouse
+ pen
+
+ # Dispatches a touch event to the page.
+ command dispatchTouchEvent
+ parameters
+ # Type of the touch event. TouchEnd and TouchCancel must not contain any touch points, while
+ # TouchStart and TouchMove must contains at least one.
+ enum type
+ touchStart
+ touchEnd
+ touchMove
+ touchCancel
+ # Active touch points on the touch device. One event per any changed point (compared to
+ # previous touch event in a sequence) is generated, emulating pressing/moving/releasing points
+ # one by one.
+ array of TouchPoint touchPoints
+ # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
+ # (default: 0).
+ optional integer modifiers
+ # Time at which the event occurred.
+ optional TimeSinceEpoch timestamp
+
+ # Cancels any active dragging in the page.
+ command cancelDragging
+
+ # Emulates touch event from the mouse event parameters.
+ experimental command emulateTouchFromMouseEvent
+ parameters
+ # Type of the mouse event.
+ enum type
+ mousePressed
+ mouseReleased
+ mouseMoved
+ mouseWheel
+ # X coordinate of the mouse pointer in DIP.
+ integer x
+ # Y coordinate of the mouse pointer in DIP.
+ integer y
+ # Mouse button. Only "none", "left", "right" are supported.
+ MouseButton button
+ # Time at which the event occurred (default: current time).
+ optional TimeSinceEpoch timestamp
+ # X delta in DIP for mouse wheel event (default: 0).
+ optional number deltaX
+ # Y delta in DIP for mouse wheel event (default: 0).
+ optional number deltaY
+ # Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
+ # (default: 0).
+ optional integer modifiers
+ # Number of times the mouse button was clicked (default: 0).
+ optional integer clickCount
+
+ # Ignores input events (useful while auditing page).
+ command setIgnoreInputEvents
+ parameters
+ # Ignores input events processing when set to true.
+ boolean ignore
+
+ # Prevents default drag and drop behavior and instead emits `Input.dragIntercepted` events.
+ # Drag and drop behavior can be directly controlled via `Input.dispatchDragEvent`.
+ experimental command setInterceptDrags
+ parameters
+ boolean enabled
+
+ # Synthesizes a pinch gesture over a time period by issuing appropriate touch events.
+ experimental command synthesizePinchGesture
+ parameters
+ # X coordinate of the start of the gesture in CSS pixels.
+ number x
+ # Y coordinate of the start of the gesture in CSS pixels.
+ number y
+ # Relative scale factor after zooming (>1.0 zooms in, <1.0 zooms out).
+ number scaleFactor
+ # Relative pointer speed in pixels per second (default: 800).
+ optional integer relativeSpeed
+ # Which type of input events to be generated (default: 'default', which queries the platform
+ # for the preferred input type).
+ optional GestureSourceType gestureSourceType
+
+ # Synthesizes a scroll gesture over a time period by issuing appropriate touch events.
+ experimental command synthesizeScrollGesture
+ parameters
+ # X coordinate of the start of the gesture in CSS pixels.
+ number x
+ # Y coordinate of the start of the gesture in CSS pixels.
+ number y
+ # The distance to scroll along the X axis (positive to scroll left).
+ optional number xDistance
+ # The distance to scroll along the Y axis (positive to scroll up).
+ optional number yDistance
+ # The number of additional pixels to scroll back along the X axis, in addition to the given
+ # distance.
+ optional number xOverscroll
+ # The number of additional pixels to scroll back along the Y axis, in addition to the given
+ # distance.
+ optional number yOverscroll
+ # Prevent fling (default: true).
+ optional boolean preventFling
+ # Swipe speed in pixels per second (default: 800).
+ optional integer speed
+ # Which type of input events to be generated (default: 'default', which queries the platform
+ # for the preferred input type).
+ optional GestureSourceType gestureSourceType
+ # The number of times to repeat the gesture (default: 0).
+ optional integer repeatCount
+ # The number of milliseconds delay between each repeat. (default: 250).
+ optional integer repeatDelayMs
+ # The name of the interaction markers to generate, if not empty (default: "").
+ optional string interactionMarkerName
+
+ # Synthesizes a tap gesture over a time period by issuing appropriate touch events.
+ experimental command synthesizeTapGesture
+ parameters
+ # X coordinate of the start of the gesture in CSS pixels.
+ number x
+ # Y coordinate of the start of the gesture in CSS pixels.
+ number y
+ # Duration between touchdown and touchup events in ms (default: 50).
+ optional integer duration
+ # Number of times to perform the tap (e.g. 2 for double tap, default: 1).
+ optional integer tapCount
+ # Which type of input events to be generated (default: 'default', which queries the platform
+ # for the preferred input type).
+ optional GestureSourceType gestureSourceType
+
+ # Emitted only when `Input.setInterceptDrags` is enabled. Use this data with `Input.dispatchDragEvent` to
+ # restore normal drag and drop behavior.
+ experimental event dragIntercepted
+ parameters
+ DragData data
diff --git a/pdl/domains/Inspector.pdl b/pdl/domains/Inspector.pdl
new file mode 100644
index 00000000..501fb5bd
--- /dev/null
+++ b/pdl/domains/Inspector.pdl
@@ -0,0 +1,25 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Inspector
+
+ # Disables inspector domain notifications.
+ command disable
+
+ # Enables inspector domain notifications.
+ command enable
+
+ # Fired when remote debugging connection is about to be terminated. Contains detach reason.
+ event detached
+ parameters
+ # The reason why connection has been terminated.
+ string reason
+
+ # Fired when debugging target has crashed
+ event targetCrashed
+
+ # Fired when debugging target has reloaded after crash
+ event targetReloadedAfterCrash
diff --git a/pdl/domains/LayerTree.pdl b/pdl/domains/LayerTree.pdl
new file mode 100644
index 00000000..f4609b80
--- /dev/null
+++ b/pdl/domains/LayerTree.pdl
@@ -0,0 +1,178 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain LayerTree
+ depends on DOM
+
+ # Unique Layer identifier.
+ type LayerId extends string
+
+ # Unique snapshot identifier.
+ type SnapshotId extends string
+
+ # Rectangle where scrolling happens on the main thread.
+ type ScrollRect extends object
+ properties
+ # Rectangle itself.
+ DOM.Rect rect
+ # Reason for rectangle to force scrolling on the main thread
+ enum type
+ RepaintsOnScroll
+ TouchEventHandler
+ WheelEventHandler
+
+ # Sticky position constraints.
+ type StickyPositionConstraint extends object
+ properties
+ # Layout rectangle of the sticky element before being shifted
+ DOM.Rect stickyBoxRect
+ # Layout rectangle of the containing block of the sticky element
+ DOM.Rect containingBlockRect
+ # The nearest sticky layer that shifts the sticky box
+ optional LayerId nearestLayerShiftingStickyBox
+ # The nearest sticky layer that shifts the containing block
+ optional LayerId nearestLayerShiftingContainingBlock
+
+ # Serialized fragment of layer picture along with its offset within the layer.
+ type PictureTile extends object
+ properties
+ # Offset from owning layer left boundary
+ number x
+ # Offset from owning layer top boundary
+ number y
+ # Base64-encoded snapshot data.
+ binary picture
+
+ # Information about a compositing layer.
+ type Layer extends object
+ properties
+ # The unique id for this layer.
+ LayerId layerId
+ # The id of parent (not present for root).
+ optional LayerId parentLayerId
+ # The backend id for the node associated with this layer.
+ optional DOM.BackendNodeId backendNodeId
+ # Offset from parent layer, X coordinate.
+ number offsetX
+ # Offset from parent layer, Y coordinate.
+ number offsetY
+ # Layer width.
+ number width
+ # Layer height.
+ number height
+ # Transformation matrix for layer, default is identity matrix
+ optional array of number transform
+ # Transform anchor point X, absent if no transform specified
+ optional number anchorX
+ # Transform anchor point Y, absent if no transform specified
+ optional number anchorY
+ # Transform anchor point Z, absent if no transform specified
+ optional number anchorZ
+ # Indicates how many time this layer has painted.
+ integer paintCount
+ # Indicates whether this layer hosts any content, rather than being used for
+ # transform/scrolling purposes only.
+ boolean drawsContent
+ # Set if layer is not visible.
+ optional boolean invisible
+ # Rectangles scrolling on main thread only.
+ optional array of ScrollRect scrollRects
+ # Sticky position constraint information
+ optional StickyPositionConstraint stickyPositionConstraint
+
+ # Array of timings, one per paint step.
+ type PaintProfile extends array of number
+
+ # Provides the reasons why the given layer was composited.
+ command compositingReasons
+ parameters
+ # The id of the layer for which we want to get the reasons it was composited.
+ LayerId layerId
+ returns
+ # A list of strings specifying reasons for the given layer to become composited.
+ array of string compositingReasons
+ # A list of strings specifying reason IDs for the given layer to become composited.
+ array of string compositingReasonIds
+
+ # Disables compositing tree inspection.
+ command disable
+
+ # Enables compositing tree inspection.
+ command enable
+
+ # Returns the snapshot identifier.
+ command loadSnapshot
+ parameters
+ # An array of tiles composing the snapshot.
+ array of PictureTile tiles
+ returns
+ # The id of the snapshot.
+ SnapshotId snapshotId
+
+ # Returns the layer snapshot identifier.
+ command makeSnapshot
+ parameters
+ # The id of the layer.
+ LayerId layerId
+ returns
+ # The id of the layer snapshot.
+ SnapshotId snapshotId
+
+ command profileSnapshot
+ parameters
+ # The id of the layer snapshot.
+ SnapshotId snapshotId
+ # The maximum number of times to replay the snapshot (1, if not specified).
+ optional integer minRepeatCount
+ # The minimum duration (in seconds) to replay the snapshot.
+ optional number minDuration
+ # The clip rectangle to apply when replaying the snapshot.
+ optional DOM.Rect clipRect
+ returns
+ # The array of paint profiles, one per run.
+ array of PaintProfile timings
+
+ # Releases layer snapshot captured by the back-end.
+ command releaseSnapshot
+ parameters
+ # The id of the layer snapshot.
+ SnapshotId snapshotId
+
+ # Replays the layer snapshot and returns the resulting bitmap.
+ command replaySnapshot
+ parameters
+ # The id of the layer snapshot.
+ SnapshotId snapshotId
+ # The first step to replay from (replay from the very start if not specified).
+ optional integer fromStep
+ # The last step to replay to (replay till the end if not specified).
+ optional integer toStep
+ # The scale to apply while replaying (defaults to 1).
+ optional number scale
+ returns
+ # A data: URL for resulting image.
+ string dataURL
+
+ # Replays the layer snapshot and returns canvas log.
+ command snapshotCommandLog
+ parameters
+ # The id of the layer snapshot.
+ SnapshotId snapshotId
+ returns
+ # The array of canvas function calls.
+ array of object commandLog
+
+ event layerPainted
+ parameters
+ # The id of the painted layer.
+ LayerId layerId
+ # Clip rectangle.
+ DOM.Rect clip
+
+ event layerTreeDidChange
+ parameters
+ # Layer tree, absent if not in the compositing mode.
+ optional array of Layer layers
diff --git a/pdl/domains/Log.pdl b/pdl/domains/Log.pdl
new file mode 100644
index 00000000..55cb7d21
--- /dev/null
+++ b/pdl/domains/Log.pdl
@@ -0,0 +1,93 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Provides access to log entries.
+domain Log
+ depends on Runtime
+ depends on Network
+
+ # Log entry.
+ type LogEntry extends object
+ properties
+ # Log entry source.
+ enum source
+ xml
+ javascript
+ network
+ storage
+ appcache
+ rendering
+ security
+ deprecation
+ worker
+ violation
+ intervention
+ recommendation
+ other
+ # Log entry severity.
+ enum level
+ verbose
+ info
+ warning
+ error
+ # Logged text.
+ string text
+ optional enum category
+ cors
+ # Timestamp when this entry was added.
+ Runtime.Timestamp timestamp
+ # URL of the resource if known.
+ optional string url
+ # Line number in the resource.
+ optional integer lineNumber
+ # JavaScript stack trace.
+ optional Runtime.StackTrace stackTrace
+ # Identifier of the network request associated with this entry.
+ optional Network.RequestId networkRequestId
+ # Identifier of the worker associated with this entry.
+ optional string workerId
+ # Call arguments.
+ optional array of Runtime.RemoteObject args
+
+ # Violation configuration setting.
+ type ViolationSetting extends object
+ properties
+ # Violation type.
+ enum name
+ longTask
+ longLayout
+ blockedEvent
+ blockedParser
+ discouragedAPIUse
+ handler
+ recurringHandler
+ # Time threshold to trigger upon.
+ number threshold
+
+ # Clears the log.
+ command clear
+
+ # Disables log domain, prevents further log entries from being reported to the client.
+ command disable
+
+ # Enables log domain, sends the entries collected so far to the client by means of the
+ # `entryAdded` notification.
+ command enable
+
+ # start violation reporting.
+ command startViolationsReport
+ parameters
+ # Configuration for violations.
+ array of ViolationSetting config
+
+ # Stop violation reporting.
+ command stopViolationsReport
+
+ # Issued when new message was logged.
+ event entryAdded
+ parameters
+ # The entry.
+ LogEntry entry
diff --git a/pdl/domains/Media.pdl b/pdl/domains/Media.pdl
new file mode 100644
index 00000000..844e2a94
--- /dev/null
+++ b/pdl/domains/Media.pdl
@@ -0,0 +1,106 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows detailed inspection of media elements.
+experimental domain Media
+
+ # Players will get an ID that is unique within the agent context.
+ type PlayerId extends string
+
+ type Timestamp extends number
+
+ # Have one type per entry in MediaLogRecord::Type
+ # Corresponds to kMessage
+ type PlayerMessage extends object
+ properties
+ # Keep in sync with MediaLogMessageLevel
+ # We are currently keeping the message level 'error' separate from the
+ # PlayerError type because right now they represent different things,
+ # this one being a DVLOG(ERROR) style log message that gets printed
+ # based on what log level is selected in the UI, and the other is a
+ # representation of a media::PipelineStatus object. Soon however we're
+ # going to be moving away from using PipelineStatus for errors and
+ # introducing a new error type which should hopefully let us integrate
+ # the error log level into the PlayerError type.
+ enum level
+ error
+ warning
+ info
+ debug
+ string message
+
+ # Corresponds to kMediaPropertyChange
+ type PlayerProperty extends object
+ properties
+ string name
+ string value
+
+ # Corresponds to kMediaEventTriggered
+ type PlayerEvent extends object
+ properties
+ Timestamp timestamp
+ string value
+
+ # Represents logged source line numbers reported in an error.
+ # NOTE: file and line are from chromium c++ implementation code, not js.
+ type PlayerErrorSourceLocation extends object
+ properties
+ string file
+ integer line
+
+ # Corresponds to kMediaError
+ type PlayerError extends object
+ properties
+ string errorType
+ # Code is the numeric enum entry for a specific set of error codes, such
+ # as PipelineStatusCodes in media/base/pipeline_status.h
+ integer code
+ # A trace of where this error was caused / where it passed through.
+ array of PlayerErrorSourceLocation stack
+ # Errors potentially have a root cause error, ie, a DecoderError might be
+ # caused by an WindowsError
+ array of PlayerError cause
+ # Extra data attached to an error, such as an HRESULT, Video Codec, etc.
+ object data
+
+ # This can be called multiple times, and can be used to set / override /
+ # remove player properties. A null propValue indicates removal.
+ event playerPropertiesChanged
+ parameters
+ PlayerId playerId
+ array of PlayerProperty properties
+
+ # 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.
+ event playerEventsAdded
+ parameters
+ PlayerId playerId
+ array of PlayerEvent events
+
+ # Send a list of any messages that need to be delivered.
+ event playerMessagesLogged
+ parameters
+ PlayerId playerId
+ array of PlayerMessage messages
+
+ # Send a list of any errors that need to be delivered.
+ event playerErrorsRaised
+ parameters
+ PlayerId playerId
+ array of PlayerError errors
+
+ # 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.
+ event playersCreated
+ parameters
+ array of PlayerId players
+
+ # Enables the Media domain
+ command enable
+
+ # Disables the Media domain.
+ command disable
diff --git a/pdl/domains/Memory.pdl b/pdl/domains/Memory.pdl
new file mode 100644
index 00000000..b86b06c6
--- /dev/null
+++ b/pdl/domains/Memory.pdl
@@ -0,0 +1,112 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Memory
+
+ # Memory pressure level.
+ type PressureLevel extends string
+ enum
+ moderate
+ critical
+
+ # Retruns current DOM object counters.
+ command getDOMCounters
+ returns
+ integer documents
+ integer nodes
+ integer jsEventListeners
+
+ # Retruns DOM object counters after preparing renderer for leak detection.
+ command getDOMCountersForLeakDetection
+ returns
+ # DOM object counters.
+ array of DOMCounter counters
+
+ # Prepares for leak detection by terminating workers, stopping spellcheckers,
+ # dropping non-essential internal caches, running garbage collections, etc.
+ command prepareForLeakDetection
+
+ # Simulate OomIntervention by purging V8 memory.
+ command forciblyPurgeJavaScriptMemory
+
+ # Enable/disable suppressing memory pressure notifications in all processes.
+ command setPressureNotificationsSuppressed
+ parameters
+ # If true, memory pressure notifications will be suppressed.
+ boolean suppressed
+
+ # Simulate a memory pressure notification in all processes.
+ command simulatePressureNotification
+ parameters
+ # Memory pressure level of the notification.
+ PressureLevel level
+
+ # Start collecting native memory profile.
+ command startSampling
+ parameters
+ # Average number of bytes between samples.
+ optional integer samplingInterval
+ # Do not randomize intervals between samples.
+ optional boolean suppressRandomness
+
+ # Stop collecting native memory profile.
+ command stopSampling
+
+ # Retrieve native memory allocations profile
+ # collected since renderer process startup.
+ command getAllTimeSamplingProfile
+ returns
+ SamplingProfile profile
+
+ # Retrieve native memory allocations profile
+ # collected since browser process startup.
+ command getBrowserSamplingProfile
+ returns
+ SamplingProfile profile
+
+ # Retrieve native memory allocations profile collected since last
+ # `startSampling` call.
+ command getSamplingProfile
+ returns
+ SamplingProfile profile
+
+ # Heap profile sample.
+ type SamplingProfileNode extends object
+ properties
+ # Size of the sampled allocation.
+ number size
+ # Total bytes attributed to this sample.
+ number total
+ # Execution stack at the point of allocation.
+ array of string stack
+
+ # Array of heap profile samples.
+ type SamplingProfile extends object
+ properties
+ array of SamplingProfileNode samples
+ array of Module modules
+
+ # Executable module information
+ type Module extends object
+ properties
+ # Name of the module.
+ string name
+ # UUID of the module.
+ string uuid
+ # Base address where the module is loaded into memory. Encoded as a decimal
+ # or hexadecimal (0x prefixed) string.
+ string baseAddress
+ # Size of the module in bytes.
+ number size
+
+ # DOM object counter data.
+ type DOMCounter extends object
+ properties
+ # Object name. Note: object names should be presumed volatile and clients should not expect
+ # the returned names to be consistent across runs.
+ string name
+ # Object count.
+ integer count
diff --git a/pdl/domains/Network.pdl b/pdl/domains/Network.pdl
new file mode 100644
index 00000000..fca59cc7
--- /dev/null
+++ b/pdl/domains/Network.pdl
@@ -0,0 +1,2039 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# 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.
+domain Network
+ depends on Debugger
+ depends on Runtime
+ depends on Security
+
+ # Resource type as it was perceived by the rendering engine.
+ type ResourceType extends string
+ enum
+ Document
+ Stylesheet
+ Image
+ Media
+ Font
+ Script
+ TextTrack
+ XHR
+ Fetch
+ Prefetch
+ EventSource
+ WebSocket
+ Manifest
+ SignedExchange
+ Ping
+ CSPViolationReport
+ Preflight
+ FedCM
+ Other
+
+ # Unique loader identifier.
+ type LoaderId extends string
+
+ # Unique network request identifier.
+ # Note that this does not identify individual HTTP requests that are part of
+ # a network request.
+ type RequestId extends string
+
+ # Unique intercepted request identifier.
+ type InterceptionId extends string
+
+ # Network level fetch failure reason.
+ type ErrorReason extends string
+ enum
+ Failed
+ Aborted
+ TimedOut
+ AccessDenied
+ ConnectionClosed
+ ConnectionReset
+ ConnectionRefused
+ ConnectionAborted
+ ConnectionFailed
+ NameNotResolved
+ InternetDisconnected
+ AddressUnreachable
+ BlockedByClient
+ BlockedByResponse
+
+ # UTC time in seconds, counted from January 1, 1970.
+ type TimeSinceEpoch extends number
+
+ # Monotonically increasing time in seconds since an arbitrary point in the past.
+ type MonotonicTime extends number
+
+ # Request / response headers as keys / values of JSON object.
+ type Headers extends object
+
+ # The underlying connection technology that the browser is supposedly using.
+ type ConnectionType extends string
+ enum
+ none
+ cellular2g
+ cellular3g
+ cellular4g
+ bluetooth
+ ethernet
+ wifi
+ wimax
+ other
+
+ # Represents the cookie's 'SameSite' status:
+ # https://tools.ietf.org/html/draft-west-first-party-cookies
+ type CookieSameSite extends string
+ enum
+ Strict
+ Lax
+ None
+
+ # Represents the cookie's 'Priority' status:
+ # https://tools.ietf.org/html/draft-west-cookie-priority-00
+ experimental type CookiePriority extends string
+ enum
+ Low
+ Medium
+ High
+
+ # Represents the source scheme of the origin that originally set the cookie.
+ # A value of "Unset" allows protocol clients to emulate legacy cookie scope for the scheme.
+ # This is a temporary ability and it will be removed in the future.
+ experimental type CookieSourceScheme extends string
+ enum
+ Unset
+ NonSecure
+ Secure
+
+ # Timing information for the request.
+ type ResourceTiming extends object
+ properties
+ # Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
+ # milliseconds relatively to this requestTime.
+ number requestTime
+ # Started resolving proxy.
+ number proxyStart
+ # Finished resolving proxy.
+ number proxyEnd
+ # Started DNS address resolve.
+ number dnsStart
+ # Finished DNS address resolve.
+ number dnsEnd
+ # Started connecting to the remote host.
+ number connectStart
+ # Connected to the remote host.
+ number connectEnd
+ # Started SSL handshake.
+ number sslStart
+ # Finished SSL handshake.
+ number sslEnd
+ # Started running ServiceWorker.
+ experimental number workerStart
+ # Finished Starting ServiceWorker.
+ experimental number workerReady
+ # Started fetch event.
+ experimental number workerFetchStart
+ # Settled fetch event respondWith promise.
+ experimental number workerRespondWithSettled
+ # Started ServiceWorker static routing source evaluation.
+ experimental optional number workerRouterEvaluationStart
+ # Started cache lookup when the source was evaluated to `cache`.
+ experimental optional number workerCacheLookupStart
+ # Started sending request.
+ number sendStart
+ # Finished sending request.
+ number sendEnd
+ # Time the server started pushing request.
+ experimental number pushStart
+ # Time the server finished pushing request.
+ experimental number pushEnd
+ # Started receiving response headers.
+ experimental number receiveHeadersStart
+ # Finished receiving response headers.
+ number receiveHeadersEnd
+
+ # Loading priority of a resource request.
+ type ResourcePriority extends string
+ enum
+ VeryLow
+ Low
+ Medium
+ High
+ VeryHigh
+
+ # Post data entry for HTTP request
+ type PostDataEntry extends object
+ properties
+ optional binary bytes
+
+ # HTTP request data.
+ type Request extends object
+ properties
+ # Request URL (without fragment).
+ string url
+ # Fragment of the requested URL starting with hash, if present.
+ optional string urlFragment
+ # HTTP request method.
+ string method
+ # HTTP request headers.
+ Headers headers
+ # HTTP POST request data.
+ # Use postDataEntries instead.
+ deprecated optional string postData
+ # True when the request has POST data. Note that postData might still be omitted when this flag is true when the data is too long.
+ optional boolean hasPostData
+ # Request body elements (post data broken into individual entries).
+ experimental optional array of PostDataEntry postDataEntries
+ # The mixed content type of the request.
+ optional Security.MixedContentType mixedContentType
+ # Priority of the resource request at the time request is sent.
+ ResourcePriority initialPriority
+ # The referrer policy of the request, as defined in https://www.w3.org/TR/referrer-policy/
+ enum referrerPolicy
+ unsafe-url
+ no-referrer-when-downgrade
+ no-referrer
+ origin
+ origin-when-cross-origin
+ same-origin
+ strict-origin
+ strict-origin-when-cross-origin
+ # Whether is loaded via link preload.
+ optional boolean isLinkPreload
+ # Set for requests when the TrustToken API is used. Contains the parameters
+ # passed by the developer (e.g. via "fetch") as understood by the backend.
+ experimental optional TrustTokenParams trustTokenParams
+ # True if this resource request is considered to be the 'same site' as the
+ # request corresponding to the main frame.
+ experimental optional boolean isSameSite
+
+ # Details of a signed certificate timestamp (SCT).
+ type SignedCertificateTimestamp extends object
+ properties
+ # Validation status.
+ string status
+ # Origin.
+ string origin
+ # Log name / description.
+ string logDescription
+ # Log ID.
+ string logId
+ # Issuance date. Unlike TimeSinceEpoch, this contains the number of
+ # milliseconds since January 1, 1970, UTC, not the number of seconds.
+ number timestamp
+ # Hash algorithm.
+ string hashAlgorithm
+ # Signature algorithm.
+ string signatureAlgorithm
+ # Signature data.
+ string signatureData
+
+ # Security details about a request.
+ type SecurityDetails extends object
+ properties
+ # Protocol name (e.g. "TLS 1.2" or "QUIC").
+ string protocol
+ # Key Exchange used by the connection, or the empty string if not applicable.
+ string keyExchange
+ # (EC)DH group used by the connection, if applicable.
+ optional string keyExchangeGroup
+ # Cipher name.
+ string cipher
+ # TLS MAC. Note that AEAD ciphers do not have separate MACs.
+ optional string mac
+ # Certificate ID value.
+ Security.CertificateId certificateId
+ # Certificate subject name.
+ string subjectName
+ # Subject Alternative Name (SAN) DNS names and IP addresses.
+ array of string sanList
+ # Name of the issuing CA.
+ string issuer
+ # Certificate valid from date.
+ TimeSinceEpoch validFrom
+ # Certificate valid to (expiration) date
+ TimeSinceEpoch validTo
+ # List of signed certificate timestamps (SCTs).
+ array of SignedCertificateTimestamp signedCertificateTimestampList
+ # Whether the request complied with Certificate Transparency policy
+ CertificateTransparencyCompliance certificateTransparencyCompliance
+ # The signature algorithm used by the server in the TLS server signature,
+ # represented as a TLS SignatureScheme code point. Omitted if not
+ # applicable or not known.
+ optional integer serverSignatureAlgorithm
+ # Whether the connection used Encrypted ClientHello
+ boolean encryptedClientHello
+
+ # Whether the request complied with Certificate Transparency policy.
+ type CertificateTransparencyCompliance extends string
+ enum
+ unknown
+ not-compliant
+ compliant
+
+ # The reason why request was blocked.
+ type BlockedReason extends string
+ enum
+ other
+ csp
+ mixed-content
+ origin
+ inspector
+ integrity
+ subresource-filter
+ content-type
+ coep-frame-resource-needs-coep-header
+ coop-sandboxed-iframe-cannot-navigate-to-coop-page
+ corp-not-same-origin
+ corp-not-same-origin-after-defaulted-to-same-origin-by-coep
+ corp-not-same-origin-after-defaulted-to-same-origin-by-dip
+ corp-not-same-origin-after-defaulted-to-same-origin-by-coep-and-dip
+ corp-not-same-site
+ sri-message-signature-mismatch
+
+ # The reason why request was blocked.
+ type CorsError extends string
+ enum
+ DisallowedByMode
+ InvalidResponse
+ WildcardOriginNotAllowed
+ MissingAllowOriginHeader
+ MultipleAllowOriginValues
+ InvalidAllowOriginValue
+ AllowOriginMismatch
+ InvalidAllowCredentials
+ CorsDisabledScheme
+ PreflightInvalidStatus
+ PreflightDisallowedRedirect
+ PreflightWildcardOriginNotAllowed
+ PreflightMissingAllowOriginHeader
+ PreflightMultipleAllowOriginValues
+ PreflightInvalidAllowOriginValue
+ PreflightAllowOriginMismatch
+ PreflightInvalidAllowCredentials
+ # TODO(https://crbug.com/1263483): Remove this once frontend code does
+ # not reference it anymore.
+ PreflightMissingAllowExternal
+ # TODO(https://crbug.com/1263483): Remove this once frontend code does
+ # not reference it anymore.
+ PreflightInvalidAllowExternal
+ PreflightMissingAllowPrivateNetwork
+ PreflightInvalidAllowPrivateNetwork
+ InvalidAllowMethodsPreflightResponse
+ InvalidAllowHeadersPreflightResponse
+ MethodDisallowedByPreflightResponse
+ HeaderDisallowedByPreflightResponse
+ RedirectContainsCredentials
+ # Request was a private network request initiated by a non-secure context.
+ InsecurePrivateNetwork
+ # Request carried a target IP address space property that did not match
+ # the target resource's address space.
+ InvalidPrivateNetworkAccess
+ # Request was a private network request yet did not carry a target IP
+ # address space.
+ UnexpectedPrivateNetworkAccess
+ NoCorsRedirectModeNotFollow
+ # Request was a private network request and needed user permission yet did
+ # not carry `Private-Network-Access-Id` in the preflight response.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PreflightMissingPrivateNetworkAccessId
+ # Request was a private network request and needed user permission yet did
+ # not carry `Private-Network-Access-Name` in the preflight response.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PreflightMissingPrivateNetworkAccessName
+ # Request was a private network request and needed user permission yet not
+ # able to request for permission.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PrivateNetworkAccessPermissionUnavailable
+ # Request was a private network request and is denied by user permission.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PrivateNetworkAccessPermissionDenied
+ # Request was a local network request and is denied by user permission.
+ # https://wicg.github.io/local-network-access/
+ LocalNetworkAccessPermissionDenied
+
+ type CorsErrorStatus extends object
+ properties
+ CorsError corsError
+ string failedParameter
+
+ # Source of serviceworker response.
+ type ServiceWorkerResponseSource extends string
+ enum
+ cache-storage
+ http-cache
+ fallback-code
+ network
+
+ # 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.
+ experimental type TrustTokenParams extends object
+ properties
+ TrustTokenOperationType operation
+
+ # Only set for "token-redemption" operation and determine whether
+ # to request a fresh SRR or use a still valid cached SRR.
+ enum refreshPolicy
+ UseCached
+ Refresh
+
+ # Origins of issuers from whom to request tokens or redemption
+ # records.
+ optional array of string issuers
+
+ experimental type TrustTokenOperationType extends string
+ enum
+ # Type "token-request" in the Trust Token API.
+ Issuance
+ # Type "token-redemption" in the Trust Token API.
+ Redemption
+ # Type "send-redemption-record" in the Trust Token API.
+ Signing
+
+ # The reason why Chrome uses a specific transport protocol for HTTP semantics.
+ experimental type AlternateProtocolUsage extends string
+ enum
+ # Alternate Protocol was used without racing a normal connection.
+ alternativeJobWonWithoutRace
+ # Alternate Protocol was used by winning a race with a normal connection.
+ alternativeJobWonRace
+ # Alternate Protocol was not used by losing a race with a normal connection.
+ mainJobWonRace
+ # Alternate Protocol was not used because no Alternate-Protocol information
+ # was available when the request was issued, but an Alternate-Protocol header
+ # was present in the response.
+ mappingMissing
+ # Alternate Protocol was not used because it was marked broken.
+ broken
+ # HTTPS DNS protocol upgrade job was used without racing with a normal
+ # connection and an Alternate Protocol job.
+ dnsAlpnH3JobWonWithoutRace
+ # HTTPS DNS protocol upgrade job won a race with a normal connection and
+ # an Alternate Protocol job.
+ dnsAlpnH3JobWonRace
+ # This value is used when the reason is unknown.
+ unspecifiedReason
+
+ # Source of service worker router.
+ type ServiceWorkerRouterSource extends string
+ enum
+ network
+ cache
+ fetch-event
+ race-network-and-fetch-handler
+ race-network-and-cache
+
+ experimental type ServiceWorkerRouterInfo extends object
+ properties
+ # ID of the rule matched. If there is a matched rule, this field will
+ # be set, otherwiser no value will be set.
+ optional integer ruleIdMatched
+ # The router source of the matched rule. If there is a matched rule, this
+ # field will be set, otherwise no value will be set.
+ optional ServiceWorkerRouterSource matchedSourceType
+ # The actual router source used.
+ optional ServiceWorkerRouterSource actualSourceType
+
+ # HTTP response data.
+ type Response extends object
+ properties
+ # Response URL. This URL can be different from CachedResource.url in case of redirect.
+ string url
+ # HTTP response status code.
+ integer status
+ # HTTP response status text.
+ string statusText
+ # HTTP response headers.
+ Headers headers
+ # HTTP response headers text. This has been replaced by the headers in Network.responseReceivedExtraInfo.
+ deprecated optional string headersText
+ # Resource mimeType as determined by the browser.
+ string mimeType
+ # Resource charset as determined by the browser (if applicable).
+ string charset
+ # Refined HTTP request headers that were actually transmitted over the network.
+ optional Headers requestHeaders
+ # HTTP request headers text. This has been replaced by the headers in Network.requestWillBeSentExtraInfo.
+ deprecated optional string requestHeadersText
+ # Specifies whether physical connection was actually reused for this request.
+ boolean connectionReused
+ # Physical connection id that was actually used for this request.
+ number connectionId
+ # Remote IP address.
+ optional string remoteIPAddress
+ # Remote port.
+ optional integer remotePort
+ # Specifies that the request was served from the disk cache.
+ optional boolean fromDiskCache
+ # Specifies that the request was served from the ServiceWorker.
+ optional boolean fromServiceWorker
+ # Specifies that the request was served from the prefetch cache.
+ optional boolean fromPrefetchCache
+ # Specifies that the request was served from the prefetch cache.
+ optional boolean fromEarlyHints
+ # Information about how ServiceWorker Static Router API was used. If this
+ # field is set with `matchedSourceType` field, a matching rule is found.
+ # If this field is set without `matchedSource`, no matching rule is found.
+ # Otherwise, the API is not used.
+ experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
+ # Total number of bytes received for this request so far.
+ number encodedDataLength
+ # Timing information for the given request.
+ optional ResourceTiming timing
+ # Response source of response from ServiceWorker.
+ optional ServiceWorkerResponseSource serviceWorkerResponseSource
+ # The time at which the returned response was generated.
+ optional TimeSinceEpoch responseTime
+ # Cache Storage Cache Name.
+ optional string cacheStorageCacheName
+ # Protocol used to fetch this request.
+ optional string protocol
+ # The reason why Chrome uses a specific transport protocol for HTTP semantics.
+ experimental optional AlternateProtocolUsage alternateProtocolUsage
+ # Security state of the request resource.
+ Security.SecurityState securityState
+ # Security details for the request.
+ optional SecurityDetails securityDetails
+ # Indicates whether the request was sent through IP Protection proxies. If
+ # set to true, the request used the IP Protection privacy feature.
+ experimental optional boolean isIpProtectionUsed
+
+ # WebSocket request data.
+ type WebSocketRequest extends object
+ properties
+ # HTTP request headers.
+ Headers headers
+
+ # WebSocket response data.
+ type WebSocketResponse extends object
+ properties
+ # HTTP response status code.
+ integer status
+ # HTTP response status text.
+ string statusText
+ # HTTP response headers.
+ Headers headers
+ # HTTP response headers text.
+ optional string headersText
+ # HTTP request headers.
+ optional Headers requestHeaders
+ # HTTP request headers text.
+ optional string requestHeadersText
+
+ # WebSocket message data. This represents an entire WebSocket message, not just a fragmented frame as the name suggests.
+ type WebSocketFrame extends object
+ properties
+ # WebSocket message opcode.
+ number opcode
+ # WebSocket message mask.
+ boolean mask
+ # WebSocket message payload data.
+ # If the opcode is 1, this is a text message and payloadData is a UTF-8 string.
+ # If the opcode isn't 1, then payloadData is a base64 encoded string representing binary data.
+ string payloadData
+
+ # Information about the cached resource.
+ type CachedResource extends object
+ properties
+ # Resource URL. This is the url of the original network request.
+ string url
+ # Type of this resource.
+ ResourceType type
+ # Cached response data.
+ optional Response response
+ # Cached response body size.
+ number bodySize
+
+ # Information about the request initiator.
+ type Initiator extends object
+ properties
+ # Type of this initiator.
+ enum type
+ parser
+ script
+ preload
+ SignedExchange
+ preflight
+ other
+ # Initiator JavaScript stack trace, set for Script only.
+ # Requires the Debugger domain to be enabled.
+ optional Runtime.StackTrace stack
+ # Initiator URL, set for Parser type or for Script type (when script is importing module) or for SignedExchange type.
+ optional string url
+ # Initiator line number, set for Parser type or for Script type (when script is importing
+ # module) (0-based).
+ optional number lineNumber
+ # Initiator column number, set for Parser type or for Script type (when script is importing
+ # module) (0-based).
+ optional number columnNumber
+ # Set if another request triggered this request (e.g. preflight).
+ optional RequestId requestId
+
+ # cookiePartitionKey object
+ # The representation of the components of the key that are created by the cookiePartitionKey class contained in net/cookies/cookie_partition_key.h.
+ experimental type CookiePartitionKey extends object
+ properties
+ # The site of the top-level URL the browser was visiting at the start
+ # of the request to the endpoint that set the cookie.
+ string topLevelSite
+ # Indicates if the cookie has any ancestors that are cross-site to the topLevelSite.
+ boolean hasCrossSiteAncestor
+
+ # Cookie object
+ type Cookie extends object
+ properties
+ # Cookie name.
+ string name
+ # Cookie value.
+ string value
+ # Cookie domain.
+ string domain
+ # Cookie path.
+ string path
+ # Cookie expiration date as the number of seconds since the UNIX epoch.
+ number expires
+ # Cookie size.
+ integer size
+ # True if cookie is http-only.
+ boolean httpOnly
+ # True if cookie is secure.
+ boolean secure
+ # True in case of session cookie.
+ boolean session
+ # Cookie SameSite type.
+ optional CookieSameSite sameSite
+ # Cookie Priority
+ experimental CookiePriority priority
+ # True if cookie is SameParty.
+ experimental deprecated boolean sameParty
+ # Cookie source scheme type.
+ experimental CookieSourceScheme sourceScheme
+ # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
+ # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
+ # This is a temporary ability and it will be removed in the future.
+ experimental integer sourcePort
+ # Cookie partition key.
+ experimental optional CookiePartitionKey partitionKey
+ # True if cookie partition key is opaque.
+ experimental optional boolean partitionKeyOpaque
+
+ # Types of reasons why a cookie may not be stored from a response.
+ experimental type SetCookieBlockedReason extends string
+ enum
+ # The cookie had the "Secure" attribute but was not received over a secure connection.
+ SecureOnly
+ # The cookie had the "SameSite=Strict" attribute but came from a cross-origin response.
+ # This includes navigation requests initiated by other origins.
+ SameSiteStrict
+ # The cookie had the "SameSite=Lax" attribute but came from a cross-origin response.
+ SameSiteLax
+ # The cookie didn't specify a "SameSite" attribute and was defaulted to "SameSite=Lax" and
+ # broke the same rules specified in the SameSiteLax value.
+ SameSiteUnspecifiedTreatedAsLax
+ # The cookie had the "SameSite=None" attribute but did not specify the "Secure" attribute,
+ # which is required in order to use "SameSite=None".
+ SameSiteNoneInsecure
+ # The cookie was not stored due to user preferences.
+ UserPreferences
+ # The cookie was blocked due to third-party cookie phaseout.
+ ThirdPartyPhaseout
+ # The cookie was blocked by third-party cookie blocking between sites in
+ # the same First-Party Set.
+ ThirdPartyBlockedInFirstPartySet
+ # The syntax of the Set-Cookie header of the response was invalid.
+ SyntaxError
+ # The scheme of the connection is not allowed to store cookies.
+ SchemeNotSupported
+ # The cookie was not sent over a secure connection and would have overwritten a cookie with
+ # the Secure attribute.
+ OverwriteSecure
+ # The cookie's domain attribute was invalid with regards to the current host url.
+ InvalidDomain
+ # The cookie used the "__Secure-" or "__Host-" prefix in its name and broke the additional
+ # rules applied to cookies with these prefixes as defined in
+ # https://tools.ietf.org/html/draft-west-cookie-prefixes-05
+ InvalidPrefix
+ # An unknown error was encountered when trying to store this cookie.
+ UnknownError
+ # The cookie had the "SameSite=Strict" attribute but came from a response
+ # with the same registrable domain but a different scheme.
+ # This includes navigation requests initiated by other origins.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteStrict
+ # The cookie had the "SameSite=Lax" attribute but came from a response
+ # with the same registrable domain but a different scheme.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteLax
+ # The cookie didn't specify a "SameSite" attribute and was defaulted to
+ # "SameSite=Lax" and broke the same rules specified in the SchemefulSameSiteLax
+ # value.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteUnspecifiedTreatedAsLax
+ # The cookie had the "SameParty" attribute but came from a cross-party response.
+ SamePartyFromCrossPartyContext
+ # The cookie had the "SameParty" attribute but did not specify the "Secure" attribute
+ # (which is required in order to use "SameParty"); or specified the "SameSite=Strict"
+ # attribute (which is forbidden when using "SameParty").
+ SamePartyConflictsWithOtherAttributes
+ # The cookie's name/value pair size exceeded the size limit defined in
+ # RFC6265bis.
+ NameValuePairExceedsMaxSize
+ # The cookie contained a forbidden ASCII control character, or the tab
+ # character if it appears in the middle of the cookie name, value, an
+ # attribute name, or an attribute value.
+ DisallowedCharacter
+ # Cookie contains no content or only whitespace.
+ NoCookieContent
+
+ # Types of reasons why a cookie may not be sent with a request.
+ experimental type CookieBlockedReason extends string
+ enum
+ # The cookie had the "Secure" attribute and the connection was not secure.
+ SecureOnly
+ # The cookie's path was not within the request url's path.
+ NotOnPath
+ # The cookie's domain is not configured to match the request url's domain, even though they
+ # share a common TLD+1 (TLD+1 of foo.bar.example.com is example.com).
+ DomainMismatch
+ # The cookie had the "SameSite=Strict" attribute and the request was made on on a different
+ # site. This includes navigation requests initiated by other sites.
+ SameSiteStrict
+ # The cookie had the "SameSite=Lax" attribute and the request was made on a different site.
+ # This does not include navigation requests initiated by other sites.
+ SameSiteLax
+ # The cookie didn't specify a SameSite attribute when it was stored and was defaulted to
+ # "SameSite=Lax" and broke the same rules specified in the SameSiteLax value. The cookie had
+ # to have been set with "SameSite=None" to enable third-party usage.
+ SameSiteUnspecifiedTreatedAsLax
+ # The cookie had the "SameSite=None" attribute and the connection was not secure. Cookies
+ # without SameSite restrictions must be sent over a secure connection.
+ SameSiteNoneInsecure
+ # The cookie was not sent due to user preferences.
+ UserPreferences
+ # The cookie was blocked due to third-party cookie phaseout.
+ ThirdPartyPhaseout
+ # The cookie was blocked by third-party cookie blocking between sites in
+ # the same First-Party Set.
+ ThirdPartyBlockedInFirstPartySet
+ # An unknown error was encountered when trying to send this cookie.
+ UnknownError
+ # The cookie had the "SameSite=Strict" attribute but came from a response
+ # with the same registrable domain but a different scheme.
+ # This includes navigation requests initiated by other origins.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteStrict
+ # The cookie had the "SameSite=Lax" attribute but came from a response
+ # with the same registrable domain but a different scheme.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteLax
+ # The cookie didn't specify a "SameSite" attribute and was defaulted to
+ # "SameSite=Lax" and broke the same rules specified in the SchemefulSameSiteLax
+ # value.
+ # This is the "Schemeful Same-Site" version of the blocked reason.
+ SchemefulSameSiteUnspecifiedTreatedAsLax
+ # The cookie had the "SameParty" attribute and the request was made from a cross-party context.
+ SamePartyFromCrossPartyContext
+ # The cookie's name/value pair size exceeded the size limit defined in
+ # RFC6265bis.
+ NameValuePairExceedsMaxSize
+ # The cookie's source port value does not match the request origin's port.
+ PortMismatch
+ # The cookie's source scheme value does not match the request origin's scheme.
+ SchemeMismatch
+ # Unpartitioned cookie access from an anonymous context was blocked.
+ AnonymousContext
+
+ # Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
+ experimental type CookieExemptionReason extends string
+ enum
+ # The default value. Cookie with this reason could either be blocked or included.
+ None
+ # The cookie should have been blocked by 3PCD but is exempted by explicit user setting.
+ UserSetting
+ # The cookie should have been blocked by 3PCD but is exempted by metadata mitigation.
+ TPCDMetadata
+ # The cookie should have been blocked by 3PCD but is exempted by Deprecation Trial mitigation.
+ TPCDDeprecationTrial
+ # The cookie should have been blocked by 3PCD but is exempted by Top-level Deprecation Trial mitigation.
+ TopLevelTPCDDeprecationTrial
+ # The cookie should have been blocked by 3PCD but is exempted by heuristics mitigation.
+ TPCDHeuristics
+ # The cookie should have been blocked by 3PCD but is exempted by Enterprise Policy.
+ EnterprisePolicy
+ # The cookie should have been blocked by 3PCD but is exempted by Storage Access API.
+ StorageAccess
+ # The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
+ TopLevelStorageAccess
+ # The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
+ Scheme
+ # The cookie was included due to the 'allow-same-site-none-cookies' value being set in the sandboxing policy.
+ SameSiteNoneCookiesInSandbox
+
+ # A cookie which was not stored from a response with the corresponding reason.
+ experimental type BlockedSetCookieWithReason extends object
+ properties
+ # The reason(s) this cookie was blocked.
+ array of SetCookieBlockedReason blockedReasons
+ # The string representing this individual cookie as it would appear in the header.
+ # This is not the entire "cookie" or "set-cookie" header which could have multiple cookies.
+ string cookieLine
+ # The cookie object which represents the cookie which was not stored. It is optional because
+ # sometimes complete cookie information is not available, such as in the case of parsing
+ # errors.
+ optional Cookie cookie
+
+ # A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
+ # corresponding reason. A cookie could only have at most one exemption reason.
+ experimental type ExemptedSetCookieWithReason extends object
+ properties
+ # The reason the cookie was exempted.
+ CookieExemptionReason exemptionReason
+ # The string representing this individual cookie as it would appear in the header.
+ string cookieLine
+ # The cookie object representing the cookie.
+ Cookie cookie
+
+ # A cookie associated with the request which may or may not be sent with it.
+ # Includes the cookies itself and reasons for blocking or exemption.
+ experimental type AssociatedCookie extends object
+ properties
+ # The cookie object representing the cookie which was not sent.
+ Cookie cookie
+ # The reason(s) the cookie was blocked. If empty means the cookie is included.
+ array of CookieBlockedReason blockedReasons
+ # The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
+ # only have at most one exemption reason.
+ optional CookieExemptionReason exemptionReason
+
+ # Cookie parameter object
+ type CookieParam extends object
+ properties
+ # Cookie name.
+ string name
+ # Cookie value.
+ string value
+ # The request-URI to associate with the setting of the cookie. This value can affect the
+ # default domain, path, source port, and source scheme values of the created cookie.
+ optional string url
+ # Cookie domain.
+ optional string domain
+ # Cookie path.
+ optional string path
+ # True if cookie is secure.
+ optional boolean secure
+ # True if cookie is http-only.
+ optional boolean httpOnly
+ # Cookie SameSite type.
+ optional CookieSameSite sameSite
+ # Cookie expiration date, session cookie if not set
+ optional TimeSinceEpoch expires
+ # Cookie Priority.
+ experimental optional CookiePriority priority
+ # True if cookie is SameParty.
+ experimental optional boolean sameParty
+ # Cookie source scheme type.
+ experimental optional CookieSourceScheme sourceScheme
+ # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
+ # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
+ # This is a temporary ability and it will be removed in the future.
+ experimental optional integer sourcePort
+ # Cookie partition key. If not set, the cookie will be set as not partitioned.
+ experimental optional CookiePartitionKey partitionKey
+
+ # Authorization challenge for HTTP status code 401 or 407.
+ experimental type AuthChallenge extends object
+ properties
+ # Source of the authentication challenge.
+ optional enum source
+ Server
+ Proxy
+ # Origin of the challenger.
+ string origin
+ # The authentication scheme used, such as basic or digest
+ string scheme
+ # The realm of the challenge. May be empty.
+ string realm
+
+ # Response to an AuthChallenge.
+ experimental type AuthChallengeResponse extends object
+ properties
+ # The decision on what to do in response to the authorization challenge. Default means
+ # deferring to the default behavior of the net stack, which will likely either the Cancel
+ # authentication or display a popup dialog box.
+ enum response
+ Default
+ CancelAuth
+ ProvideCredentials
+ # The username to provide, possibly empty. Should only be set if response is
+ # ProvideCredentials.
+ optional string username
+ # The password to provide, possibly empty. Should only be set if response is
+ # ProvideCredentials.
+ optional string password
+
+ # Stages of the interception to begin intercepting. Request will intercept before the request is
+ # sent. Response will intercept after the response is received.
+ experimental type InterceptionStage extends string
+ enum
+ Request
+ HeadersReceived
+
+ # Request pattern for interception.
+ experimental type RequestPattern extends object
+ properties
+ # Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
+ # backslash. Omitting is equivalent to `"*"`.
+ optional string urlPattern
+ # If set, only requests for matching resource types will be intercepted.
+ optional ResourceType resourceType
+ # Stage at which to begin intercepting requests. Default is Request.
+ optional InterceptionStage interceptionStage
+
+ # Information about a signed exchange signature.
+ # https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#rfc.section.3.1
+ experimental type SignedExchangeSignature extends object
+ properties
+ # Signed exchange signature label.
+ string label
+ # The hex string of signed exchange signature.
+ string signature
+ # Signed exchange signature integrity.
+ string integrity
+ # Signed exchange signature cert Url.
+ optional string certUrl
+ # The hex string of signed exchange signature cert sha256.
+ optional string certSha256
+ # Signed exchange signature validity Url.
+ string validityUrl
+ # Signed exchange signature date.
+ integer date
+ # Signed exchange signature expires.
+ integer expires
+ # The encoded certificates.
+ optional array of string certificates
+
+ # Information about a signed exchange header.
+ # https://wicg.github.io/webpackage/draft-yasskin-httpbis-origin-signed-exchanges-impl.html#cbor-representation
+ experimental type SignedExchangeHeader extends object
+ properties
+ # Signed exchange request URL.
+ string requestUrl
+ # Signed exchange response code.
+ integer responseCode
+ # Signed exchange response headers.
+ Headers responseHeaders
+ # Signed exchange response signature.
+ array of SignedExchangeSignature signatures
+ # Signed exchange header integrity hash in the form of `sha256-<base64-hash-value>`.
+ string headerIntegrity
+
+ # Field type for a signed exchange related error.
+ experimental type SignedExchangeErrorField extends string
+ enum
+ signatureSig
+ signatureIntegrity
+ signatureCertUrl
+ signatureCertSha256
+ signatureValidityUrl
+ signatureTimestamps
+
+ # Information about a signed exchange response.
+ experimental type SignedExchangeError extends object
+ properties
+ # Error message.
+ string message
+ # The index of the signature which caused the error.
+ optional integer signatureIndex
+ # The field which caused the error.
+ optional SignedExchangeErrorField errorField
+
+ # Information about a signed exchange response.
+ experimental type SignedExchangeInfo extends object
+ properties
+ # The outer response of signed HTTP exchange which was received from network.
+ Response outerResponse
+ # Whether network response for the signed exchange was accompanied by
+ # extra headers.
+ boolean hasExtraInfo
+ # Information about the signed exchange header.
+ optional SignedExchangeHeader header
+ # Security details for the signed exchange header.
+ optional SecurityDetails securityDetails
+ # Errors occurred while handling the signed exchange.
+ optional array of SignedExchangeError errors
+
+ # List of content encodings supported by the backend.
+ experimental type ContentEncoding extends string
+ enum
+ deflate
+ gzip
+ br
+ zstd
+
+ # Sets a list of content encodings that will be accepted. Empty list means no encoding is accepted.
+ experimental command setAcceptedEncodings
+ parameters
+ # List of accepted content encodings.
+ array of ContentEncoding encodings
+
+ # Clears accepted encodings set by setAcceptedEncodings
+ experimental command clearAcceptedEncodingsOverride
+
+ # Tells whether clearing browser cache is supported.
+ deprecated command canClearBrowserCache
+ returns
+ # True if browser cache can be cleared.
+ boolean result
+
+ # Tells whether clearing browser cookies is supported.
+ deprecated command canClearBrowserCookies
+ returns
+ # True if browser cookies can be cleared.
+ boolean result
+
+ # Tells whether emulation of network conditions is supported.
+ deprecated command canEmulateNetworkConditions
+ returns
+ # True if emulation of network conditions is supported.
+ boolean result
+
+ # Clears browser cache.
+ command clearBrowserCache
+
+ # Clears browser cookies.
+ command clearBrowserCookies
+
+ # Response to Network.requestIntercepted which either modifies the request to continue with any
+ # modifications, or blocks it, or completes it with the provided response bytes. If a network
+ # fetch occurs as a result which encounters a redirect an additional Network.requestIntercepted
+ # event will be sent with the same InterceptionId.
+ # Deprecated, use Fetch.continueRequest, Fetch.fulfillRequest and Fetch.failRequest instead.
+ experimental deprecated command continueInterceptedRequest
+ parameters
+ InterceptionId interceptionId
+ # If set this causes the request to fail with the given reason. Passing `Aborted` for requests
+ # marked with `isNavigationRequest` also cancels the navigation. Must not be set in response
+ # to an authChallenge.
+ optional ErrorReason errorReason
+ # If set the requests completes using with the provided base64 encoded raw response, including
+ # HTTP status line and headers etc... Must not be set in response to an authChallenge.
+ optional binary rawResponse
+ # If set the request url will be modified in a way that's not observable by page. Must not be
+ # set in response to an authChallenge.
+ optional string url
+ # If set this allows the request method to be overridden. Must not be set in response to an
+ # authChallenge.
+ optional string method
+ # If set this allows postData to be set. Must not be set in response to an authChallenge.
+ optional string postData
+ # If set this allows the request headers to be changed. Must not be set in response to an
+ # authChallenge.
+ optional Headers headers
+ # Response to a requestIntercepted with an authChallenge. Must not be set otherwise.
+ optional AuthChallengeResponse authChallengeResponse
+
+ # Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
+ command deleteCookies
+ parameters
+ # Name of the cookies to remove.
+ string name
+ # If specified, deletes all the cookies with the given name where domain and path match
+ # provided URL.
+ optional string url
+ # If specified, deletes only cookies with the exact domain.
+ optional string domain
+ # If specified, deletes only cookies with the exact path.
+ optional string path
+ # If specified, deletes only cookies with the the given name and partitionKey where
+ # all partition key attributes match the cookie partition key attribute.
+ experimental optional CookiePartitionKey partitionKey
+
+ # Disables network tracking, prevents network events from being sent to the client.
+ command disable
+
+ # Activates emulation of network conditions.
+ command emulateNetworkConditions
+ parameters
+ # True to emulate internet disconnection.
+ boolean offline
+ # Minimum latency from request sent to response headers received (ms).
+ number latency
+ # Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
+ number downloadThroughput
+ # Maximal aggregated upload throughput (bytes/sec). -1 disables upload throttling.
+ number uploadThroughput
+ # Connection type if known.
+ optional ConnectionType connectionType
+ # WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
+ experimental optional number packetLoss
+ # WebRTC packet queue length (packet). 0 removes any queue length limitations.
+ experimental optional integer packetQueueLength
+ # WebRTC packetReordering feature.
+ experimental optional boolean packetReordering
+
+ # Enables network tracking, network events will now be delivered to the client.
+ command enable
+ parameters
+ # Buffer size in bytes to use when preserving network payloads (XHRs, etc).
+ experimental optional integer maxTotalBufferSize
+ # Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
+ experimental optional integer maxResourceBufferSize
+ # Longest post body size (in bytes) that would be included in requestWillBeSent notification
+ optional integer maxPostDataSize
+ # Whether DirectSocket chunk send/receive events should be reported.
+ experimental optional boolean reportDirectSocketTraffic
+
+ # Returns all browser cookies. Depending on the backend support, will return detailed cookie
+ # information in the `cookies` field.
+ # Deprecated. Use Storage.getCookies instead.
+ deprecated command getAllCookies
+ returns
+ # Array of cookie objects.
+ array of Cookie cookies
+
+ # Returns the DER-encoded certificate.
+ experimental command getCertificate
+ parameters
+ # Origin to get certificate for.
+ string origin
+ returns
+ array of string tableNames
+
+ # Returns all browser cookies for the current URL. Depending on the backend support, will return
+ # detailed cookie information in the `cookies` field.
+ command getCookies
+ parameters
+ # The list of URLs for which applicable cookies will be fetched.
+ # If not specified, it's assumed to be set to the list containing
+ # the URLs of the page and all of its subframes.
+ optional array of string urls
+ returns
+ # Array of cookie objects.
+ array of Cookie cookies
+
+ # Returns content served for the given request.
+ command getResponseBody
+ parameters
+ # Identifier of the network request to get content for.
+ RequestId requestId
+ returns
+ # Response body.
+ string body
+ # True, if content was sent as base64.
+ boolean base64Encoded
+
+ # Returns post data sent with the request. Returns an error when no data was sent with the request.
+ command getRequestPostData
+ parameters
+ # Identifier of the network request to get content for.
+ RequestId requestId
+ returns
+ # Request body string, omitting files from multipart requests
+ string postData
+
+ # Returns content served for the given currently intercepted request.
+ experimental command getResponseBodyForInterception
+ parameters
+ # Identifier for the intercepted request to get body for.
+ InterceptionId interceptionId
+ returns
+ # Response body.
+ string body
+ # True, if content was sent as base64.
+ boolean base64Encoded
+
+ # Returns a handle to the stream representing the response body. Note that after this command,
+ # the intercepted request can't be continued as is -- you either need to cancel it or to provide
+ # the response body. The stream only supports sequential read, IO.read will fail if the position
+ # is specified.
+ experimental command takeResponseBodyForInterceptionAsStream
+ parameters
+ InterceptionId interceptionId
+ returns
+ IO.StreamHandle stream
+
+ # This method sends a new XMLHttpRequest which is identical to the original one. The following
+ # parameters should be identical: method, url, async, request body, extra headers, withCredentials
+ # attribute, user, password.
+ experimental command replayXHR
+ parameters
+ # Identifier of XHR to replay.
+ RequestId requestId
+
+ # Searches for given string in response content.
+ experimental command searchInResponseBody
+ parameters
+ # Identifier of the network response to search.
+ RequestId requestId
+ # 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 Debugger.SearchMatch result
+
+ # Blocks URLs from loading.
+ experimental command setBlockedURLs
+ parameters
+ # URL patterns to block. Wildcards ('*') are allowed.
+ array of string urls
+
+ # Toggles ignoring of service worker for each request.
+ command setBypassServiceWorker
+ parameters
+ # Bypass service worker and load from network.
+ boolean bypass
+
+ # Toggles ignoring cache for each request. If `true`, cache will not be used.
+ command setCacheDisabled
+ parameters
+ # Cache disabled state.
+ boolean cacheDisabled
+
+ # Sets a cookie with the given cookie data; may overwrite equivalent cookies if they exist.
+ command setCookie
+ parameters
+ # Cookie name.
+ string name
+ # Cookie value.
+ string value
+ # The request-URI to associate with the setting of the cookie. This value can affect the
+ # default domain, path, source port, and source scheme values of the created cookie.
+ optional string url
+ # Cookie domain.
+ optional string domain
+ # Cookie path.
+ optional string path
+ # True if cookie is secure.
+ optional boolean secure
+ # True if cookie is http-only.
+ optional boolean httpOnly
+ # Cookie SameSite type.
+ optional CookieSameSite sameSite
+ # Cookie expiration date, session cookie if not set
+ optional TimeSinceEpoch expires
+ # Cookie Priority type.
+ experimental optional CookiePriority priority
+ # True if cookie is SameParty.
+ experimental optional boolean sameParty
+ # Cookie source scheme type.
+ experimental optional CookieSourceScheme sourceScheme
+ # Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
+ # An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
+ # This is a temporary ability and it will be removed in the future.
+ experimental optional integer sourcePort
+ # Cookie partition key. If not set, the cookie will be set as not partitioned.
+ experimental optional CookiePartitionKey partitionKey
+ returns
+ # Always set to true. If an error occurs, the response indicates protocol error.
+ deprecated boolean success
+
+ # Sets given cookies.
+ command setCookies
+ parameters
+ # Cookies to be set.
+ array of CookieParam cookies
+
+ # Specifies whether to always send extra HTTP headers with the requests from this page.
+ command setExtraHTTPHeaders
+ parameters
+ # Map with extra HTTP headers.
+ Headers headers
+
+ # Specifies whether to attach a page script stack id in requests
+ experimental command setAttachDebugStack
+ parameters
+ # Whether to attach a page script stack for debugging purpose.
+ boolean enabled
+
+ # Sets the requests to intercept that match the provided patterns and optionally resource types.
+ # Deprecated, please use Fetch.enable instead.
+ experimental deprecated command setRequestInterception
+ parameters
+ # Requests matching any of these patterns will be forwarded and wait for the corresponding
+ # continueInterceptedRequest call.
+ array of RequestPattern patterns
+
+ # Allows overriding user agent with the given string.
+ command setUserAgentOverride
+ redirect Emulation
+ parameters
+ # User agent to use.
+ string userAgent
+ # Browser language to emulate.
+ optional string acceptLanguage
+ # The platform navigator.platform should return.
+ optional string platform
+ # To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
+ experimental optional Emulation.UserAgentMetadata userAgentMetadata
+
+
+ # Fired when data chunk was received over the network.
+ event dataReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # Data chunk length.
+ integer dataLength
+ # Actual bytes received (might be less than dataLength for compressed encodings).
+ integer encodedDataLength
+ # Data that was received.
+ experimental optional binary data
+
+ # Enables streaming of the response for the given requestId.
+ # If enabled, the dataReceived event contains the data that was received during streaming.
+ experimental command streamResourceContent
+ parameters
+ # Identifier of the request to stream.
+ RequestId requestId
+ returns
+ # Data that has been buffered until streaming is enabled.
+ binary bufferedData
+
+ # Fired when EventSource message is received.
+ event eventSourceMessageReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # Message type.
+ string eventName
+ # Message identifier.
+ string eventId
+ # Message content.
+ string data
+
+ # Fired when HTTP request has failed to load.
+ event loadingFailed
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # Resource type.
+ ResourceType type
+ # Error message. List of network errors: https://cs.chromium.org/chromium/src/net/base/net_error_list.h
+ string errorText
+ # True if loading was canceled.
+ optional boolean canceled
+ # The reason why loading was blocked, if any.
+ optional BlockedReason blockedReason
+ # The reason why loading was blocked by CORS, if any.
+ optional CorsErrorStatus corsErrorStatus
+
+ # Fired when HTTP request has finished loading.
+ event loadingFinished
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # Total number of bytes received for this request.
+ number encodedDataLength
+
+ # Details of an intercepted HTTP request, which must be either allowed, blocked, modified or
+ # mocked.
+ # Deprecated, use Fetch.requestPaused instead.
+ experimental deprecated event requestIntercepted
+ parameters
+ # Each request the page makes will have a unique id, however if any redirects are encountered
+ # while processing that fetch, they will be reported with the same id as the original fetch.
+ # Likewise if HTTP authentication is needed then the same fetch id will be used.
+ InterceptionId interceptionId
+ Request request
+ # The id of the frame that initiated the request.
+ Page.FrameId frameId
+ # How the requested resource will be used.
+ ResourceType resourceType
+ # Whether this is a navigation request, which can abort the navigation completely.
+ boolean isNavigationRequest
+ # Set if the request is a navigation that will result in a download.
+ # Only present after response is received from the server (i.e. HeadersReceived stage).
+ optional boolean isDownload
+ # Redirect location, only sent if a redirect was intercepted.
+ optional string redirectUrl
+ # Details of the Authorization Challenge encountered. If this is set then
+ # continueInterceptedRequest must contain an authChallengeResponse.
+ optional AuthChallenge authChallenge
+ # Response error if intercepted at response stage or if redirect occurred while intercepting
+ # request.
+ optional ErrorReason responseErrorReason
+ # Response code if intercepted at response stage or if redirect occurred while intercepting
+ # request or auth retry occurred.
+ optional integer responseStatusCode
+ # Response headers if intercepted at the response stage or if redirect occurred while
+ # intercepting request or auth retry occurred.
+ optional Headers responseHeaders
+ # If the intercepted request had a corresponding requestWillBeSent event fired for it, then
+ # this requestId will be the same as the requestId present in the requestWillBeSent event.
+ optional RequestId requestId
+
+ # Fired if request ended up loading from cache.
+ event requestServedFromCache
+ parameters
+ # Request identifier.
+ RequestId requestId
+
+ # Fired when page is about to send HTTP request.
+ event requestWillBeSent
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Loader identifier. Empty string if the request is fetched from worker.
+ LoaderId loaderId
+ # URL of the document this request is loaded for.
+ string documentURL
+ # Request data.
+ Request request
+ # Timestamp.
+ MonotonicTime timestamp
+ # Timestamp.
+ TimeSinceEpoch wallTime
+ # Request initiator.
+ Initiator initiator
+ # In the case that redirectResponse is populated, this flag indicates whether
+ # requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be or were emitted
+ # for the request which was just redirected.
+ experimental boolean redirectHasExtraInfo
+ # Redirect response data.
+ optional Response redirectResponse
+ # Type of this resource.
+ optional ResourceType type
+ # Frame identifier.
+ optional Page.FrameId frameId
+ # Whether the request is initiated by a user gesture. Defaults to false.
+ optional boolean hasUserGesture
+
+ # Fired when resource loading priority is changed
+ experimental event resourceChangedPriority
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # New priority
+ ResourcePriority newPriority
+ # Timestamp.
+ MonotonicTime timestamp
+
+ # Fired when a signed exchange was received over the network
+ experimental event signedExchangeReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Information about the signed exchange response.
+ SignedExchangeInfo info
+
+ # Fired when HTTP response is available.
+ event responseReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Loader identifier. Empty string if the request is fetched from worker.
+ LoaderId loaderId
+ # Timestamp.
+ MonotonicTime timestamp
+ # Resource type.
+ ResourceType type
+ # Response data.
+ Response response
+ # Indicates whether requestWillBeSentExtraInfo and responseReceivedExtraInfo events will be
+ # or were emitted for this request.
+ experimental boolean hasExtraInfo
+ # Frame identifier.
+ optional Page.FrameId frameId
+
+ # Fired when WebSocket is closed.
+ event webSocketClosed
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+
+ # Fired upon WebSocket creation.
+ event webSocketCreated
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # WebSocket request URL.
+ string url
+ # Request initiator.
+ optional Initiator initiator
+
+ # Fired when WebSocket message error occurs.
+ event webSocketFrameError
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # WebSocket error message.
+ string errorMessage
+
+ # Fired when WebSocket message is received.
+ event webSocketFrameReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # WebSocket response data.
+ WebSocketFrame response
+
+ # Fired when WebSocket message is sent.
+ event webSocketFrameSent
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # WebSocket response data.
+ WebSocketFrame response
+
+ # Fired when WebSocket handshake response becomes available.
+ event webSocketHandshakeResponseReceived
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # WebSocket response data.
+ WebSocketResponse response
+
+ # Fired when WebSocket is about to initiate handshake.
+ event webSocketWillSendHandshakeRequest
+ parameters
+ # Request identifier.
+ RequestId requestId
+ # Timestamp.
+ MonotonicTime timestamp
+ # UTC Timestamp.
+ TimeSinceEpoch wallTime
+ # WebSocket request data.
+ WebSocketRequest request
+
+ # Fired upon WebTransport creation.
+ event webTransportCreated
+ parameters
+ # WebTransport identifier.
+ RequestId transportId
+ # WebTransport request URL.
+ string url
+ # Timestamp.
+ MonotonicTime timestamp
+ # Request initiator.
+ optional Initiator initiator
+
+ # Fired when WebTransport handshake is finished.
+ event webTransportConnectionEstablished
+ parameters
+ # WebTransport identifier.
+ RequestId transportId
+ # Timestamp.
+ MonotonicTime timestamp
+
+ # Fired when WebTransport is disposed.
+ event webTransportClosed
+ parameters
+ # WebTransport identifier.
+ RequestId transportId
+ # Timestamp.
+ MonotonicTime timestamp
+
+ experimental type DirectSocketDnsQueryType extends string
+ enum
+ ipv4
+ ipv6
+
+ experimental type DirectTCPSocketOptions extends object
+ properties
+ # TCP_NODELAY option
+ boolean noDelay
+ # Expected to be unsigned integer.
+ optional number keepAliveDelay
+ # Expected to be unsigned integer.
+ optional number sendBufferSize
+ # Expected to be unsigned integer.
+ optional number receiveBufferSize
+ optional DirectSocketDnsQueryType dnsQueryType
+
+
+ # Fired upon direct_socket.TCPSocket creation.
+ experimental event directTCPSocketCreated
+ parameters
+ RequestId identifier
+ string remoteAddr
+ # Unsigned int 16.
+ integer remotePort
+ DirectTCPSocketOptions options
+ MonotonicTime timestamp
+ optional Initiator initiator
+
+ # Fired when direct_socket.TCPSocket connection is opened.
+ experimental event directTCPSocketOpened
+ parameters
+ RequestId identifier
+ string remoteAddr
+ # Expected to be unsigned integer.
+ integer remotePort
+ MonotonicTime timestamp
+ optional string localAddr
+ # Expected to be unsigned integer.
+ optional integer localPort
+
+ # Fired when direct_socket.TCPSocket is aborted.
+ experimental event directTCPSocketAborted
+ parameters
+ RequestId identifier
+ string errorMessage
+ MonotonicTime timestamp
+
+ # Fired when direct_socket.TCPSocket is closed.
+ experimental event directTCPSocketClosed
+ parameters
+ RequestId identifier
+ MonotonicTime timestamp
+
+ # Fired when data is sent to tcp direct socket stream.
+ experimental event directTCPSocketChunkSent
+ parameters
+ RequestId identifier
+ binary data
+ MonotonicTime timestamp
+
+ # Fired when data is received from tcp direct socket stream.
+ experimental event directTCPSocketChunkReceived
+ parameters
+ RequestId identifier
+ binary data
+ MonotonicTime timestamp
+
+ experimental type DirectUDPSocketOptions extends object
+ properties
+ optional string remoteAddr
+ # Unsigned int 16.
+ optional integer remotePort
+
+ optional string localAddr
+ # Unsigned int 16.
+ optional integer localPort
+
+ optional DirectSocketDnsQueryType dnsQueryType
+
+ # Expected to be unsigned integer.
+ optional number sendBufferSize
+ # Expected to be unsigned integer.
+ optional number receiveBufferSize
+
+
+ # Fired upon direct_socket.UDPSocket creation.
+ experimental event directUDPSocketCreated
+ parameters
+ RequestId identifier
+ DirectUDPSocketOptions options
+ MonotonicTime timestamp
+ optional Initiator initiator
+
+ # Fired when direct_socket.UDPSocket connection is opened.
+ experimental event directUDPSocketOpened
+ parameters
+ RequestId identifier
+ string localAddr
+ # Expected to be unsigned integer.
+ integer localPort
+ MonotonicTime timestamp
+ optional string remoteAddr
+ # Expected to be unsigned integer.
+ optional integer remotePort
+
+ # Fired when direct_socket.UDPSocket is aborted.
+ experimental event directUDPSocketAborted
+ parameters
+ RequestId identifier
+ string errorMessage
+ MonotonicTime timestamp
+
+ # Fired when direct_socket.UDPSocket is closed.
+ experimental event directUDPSocketClosed
+ parameters
+ RequestId identifier
+ MonotonicTime timestamp
+
+ experimental type DirectUDPMessage extends object
+ properties
+ binary data
+ # Null for connected mode.
+ optional string remoteAddr
+ # Null for connected mode.
+ # Expected to be unsigned integer.
+ optional integer remotePort
+
+ # Fired when message is sent to udp direct socket stream.
+ experimental event directUDPSocketChunkSent
+ parameters
+ RequestId identifier
+ DirectUDPMessage message
+ MonotonicTime timestamp
+
+ # Fired when message is received from udp direct socket stream.
+ experimental event directUDPSocketChunkReceived
+ parameters
+ RequestId identifier
+ DirectUDPMessage message
+ MonotonicTime timestamp
+
+ experimental type PrivateNetworkRequestPolicy extends string
+ enum
+ Allow
+ BlockFromInsecureToMorePrivate
+ WarnFromInsecureToMorePrivate
+ PreflightBlock
+ PreflightWarn
+ PermissionBlock
+ PermissionWarn
+
+ experimental type IPAddressSpace extends string
+ enum
+ Loopback
+ Local
+ Public
+ Unknown
+
+ experimental type ConnectTiming extends object
+ properties
+ # Timing's requestTime is a baseline in seconds, while the other numbers are ticks in
+ # milliseconds relatively to this requestTime. Matches ResourceTiming's requestTime for
+ # the same request (but not for redirected requests).
+ number requestTime
+
+ experimental type ClientSecurityState extends object
+ properties
+ boolean initiatorIsSecureContext
+ IPAddressSpace initiatorIPAddressSpace
+ PrivateNetworkRequestPolicy privateNetworkRequestPolicy
+
+ # 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.
+ experimental event requestWillBeSentExtraInfo
+ parameters
+ # Request identifier. Used to match this information to an existing requestWillBeSent event.
+ RequestId requestId
+ # A list of cookies potentially associated to the requested URL. This includes both cookies sent with
+ # the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
+ array of AssociatedCookie associatedCookies
+ # Raw request headers as they will be sent over the wire.
+ Headers headers
+ # Connection timing information for the request.
+ experimental ConnectTiming connectTiming
+ # The client security state set for the request.
+ optional ClientSecurityState clientSecurityState
+ # Whether the site has partitioned cookies stored in a partition different than the current one.
+ optional boolean siteHasCookieInOtherPartition
+
+ # 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.
+ experimental event responseReceivedExtraInfo
+ parameters
+ # Request identifier. Used to match this information to another responseReceived event.
+ RequestId requestId
+ # A list of cookies which were not stored from the response along with the corresponding
+ # reasons for blocking. The cookies here may not be valid due to syntax errors, which
+ # are represented by the invalid cookie line string instead of a proper cookie.
+ array of BlockedSetCookieWithReason blockedCookies
+ # Raw response headers as they were received over the wire.
+ # Duplicate headers in the response are represented as a single key with their values
+ # concatentated using `\n` as the separator.
+ # See also `headersText` that contains verbatim text for HTTP/1.*.
+ Headers headers
+ # The IP address space of the resource. The address space can only be determined once the transport
+ # established the connection, so we can't send it in `requestWillBeSentExtraInfo`.
+ IPAddressSpace resourceIPAddressSpace
+ # The status code of the response. This is useful in cases the request failed and no responseReceived
+ # event is triggered, which is the case for, e.g., CORS errors. This is also the correct status code
+ # for cached requests, where the status in responseReceived is a 200 and this will be 304.
+ integer statusCode
+ # Raw response header text as it was received over the wire. The raw text may not always be
+ # available, such as in the case of HTTP/2 or QUIC.
+ optional string headersText
+ # The cookie partition key that will be used to store partitioned cookies set in this response.
+ # Only sent when partitioned cookies are enabled.
+ experimental optional CookiePartitionKey cookiePartitionKey
+ # True if partitioned cookies are enabled, but the partition key is not serializable to string.
+ optional boolean cookiePartitionKeyOpaque
+ # A list of cookies which should have been blocked by 3PCD but are exempted and stored from
+ # the response with the corresponding reason.
+ optional array of ExemptedSetCookieWithReason exemptedCookies
+
+ # Fired when 103 Early Hints headers is received in addition to the common response.
+ # Not every responseReceived event will have an responseReceivedEarlyHints fired.
+ # Only one responseReceivedEarlyHints may be fired for eached responseReceived event.
+ experimental event responseReceivedEarlyHints
+ parameters
+ # Request identifier. Used to match this information to another responseReceived event.
+ RequestId requestId
+ # Raw response headers as they were received over the wire.
+ # Duplicate headers in the response are represented as a single key with their values
+ # concatentated using `\n` as the separator.
+ # See also `headersText` that contains verbatim text for HTTP/1.*.
+ Headers headers
+
+ # 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.
+ experimental event trustTokenOperationDone
+ parameters
+ # Detailed success or error status of the operation.
+ # 'AlreadyExists' also signifies a successful operation, as the result
+ # of the operation already exists und thus, the operation was abort
+ # preemptively (e.g. a cache hit).
+ enum status
+ Ok
+ InvalidArgument
+ MissingIssuerKeys
+ FailedPrecondition
+ ResourceExhausted
+ AlreadyExists
+ ResourceLimited
+ Unauthorized
+ BadResponse
+ InternalError
+ UnknownError
+ FulfilledLocally
+ SiteIssuerLimit
+ TrustTokenOperationType type
+ RequestId requestId
+ # Top level origin. The context in which the operation was attempted.
+ optional string topLevelOrigin
+ # Origin of the issuer in case of a "Issuance" or "Redemption" operation.
+ optional string issuerOrigin
+ # The number of obtained Trust Tokens on a successful "Issuance" operation.
+ optional integer issuedTokenCount
+
+ # Fired once security policy has been updated.
+ experimental event policyUpdated
+
+ # Fired once when parsing the .wbn file has succeeded.
+ # The event contains the information about the web bundle contents.
+ experimental event subresourceWebBundleMetadataReceived
+ parameters
+ # Request identifier. Used to match this information to another event.
+ RequestId requestId
+ # A list of URLs of resources in the subresource Web Bundle.
+ array of string urls
+
+ # Fired once when parsing the .wbn file has failed.
+ experimental event subresourceWebBundleMetadataError
+ parameters
+ # Request identifier. Used to match this information to another event.
+ RequestId requestId
+ # Error message
+ string errorMessage
+
+ # Fired when handling requests for resources within a .wbn file.
+ # Note: this will only be fired for resources that are requested by the webpage.
+ experimental event subresourceWebBundleInnerResponseParsed
+ parameters
+ # Request identifier of the subresource request
+ RequestId innerRequestId
+ # URL of the subresource resource.
+ string innerRequestURL
+ # Bundle request identifier. Used to match this information to another event.
+ # This made be absent in case when the instrumentation was enabled only
+ # after webbundle was parsed.
+ optional RequestId bundleRequestId
+
+ # Fired when request for resources within a .wbn file failed.
+ experimental event subresourceWebBundleInnerResponseError
+ parameters
+ # Request identifier of the subresource request
+ RequestId innerRequestId
+ # URL of the subresource resource.
+ string innerRequestURL
+ # Error message
+ string errorMessage
+ # Bundle request identifier. Used to match this information to another event.
+ # This made be absent in case when the instrumentation was enabled only
+ # after webbundle was parsed.
+ optional RequestId bundleRequestId
+
+ experimental type CrossOriginOpenerPolicyValue extends string
+ enum
+ SameOrigin
+ SameOriginAllowPopups
+ RestrictProperties
+ UnsafeNone
+ SameOriginPlusCoep
+ RestrictPropertiesPlusCoep
+ NoopenerAllowPopups
+
+ experimental type CrossOriginOpenerPolicyStatus extends object
+ properties
+ CrossOriginOpenerPolicyValue value
+ CrossOriginOpenerPolicyValue reportOnlyValue
+ optional string reportingEndpoint
+ optional string reportOnlyReportingEndpoint
+
+ experimental type CrossOriginEmbedderPolicyValue extends string
+ enum
+ None
+ Credentialless
+ RequireCorp
+
+ experimental type CrossOriginEmbedderPolicyStatus extends object
+ properties
+ CrossOriginEmbedderPolicyValue value
+ CrossOriginEmbedderPolicyValue reportOnlyValue
+ optional string reportingEndpoint
+ optional string reportOnlyReportingEndpoint
+
+ experimental type ContentSecurityPolicySource extends string
+ enum
+ HTTP
+ Meta
+
+ experimental type ContentSecurityPolicyStatus extends object
+ properties
+ string effectiveDirectives
+ boolean isEnforced
+ ContentSecurityPolicySource source
+
+ experimental type SecurityIsolationStatus extends object
+ properties
+ optional CrossOriginOpenerPolicyStatus coop
+ optional CrossOriginEmbedderPolicyStatus coep
+ optional array of ContentSecurityPolicyStatus csp
+
+ # Returns information about the COEP/COOP isolation status.
+ experimental command getSecurityIsolationStatus
+ parameters
+ # If no frameId is provided, the status of the target is provided.
+ optional Page.FrameId frameId
+ returns
+ SecurityIsolationStatus status
+
+ # Enables tracking for the Reporting API, events generated by the Reporting API will now be delivered to the client.
+ # Enabling triggers 'reportingApiReportAdded' for all existing reports.
+ experimental command enableReportingApi
+ parameters
+ # Whether to enable or disable events for the Reporting API
+ boolean enable
+
+ # The status of a Reporting API report.
+ experimental type ReportStatus extends string
+ enum
+ # Report has been queued and no attempt has been made to deliver it yet,
+ # or attempted previous upload failed (impermanently).
+ Queued
+ # There is an ongoing attempt to upload this report.
+ Pending
+ # Deletion of this report was requested while it was pending, so it will
+ # be removed after possibly outstanding upload attempts complete (successful
+ # or not).
+ MarkedForRemoval
+ # Successfully uploaded and MarkedForRemoval.
+ Success
+
+ experimental type ReportId extends string
+
+ # An object representing a report generated by the Reporting API.
+ experimental type ReportingApiReport extends object
+ properties
+ ReportId id
+ # The URL of the document that triggered the report.
+ string initiatorUrl
+ # The name of the endpoint group that should be used to deliver the report.
+ string destination
+ # The type of the report (specifies the set of data that is contained in the report body).
+ string type
+ # When the report was generated.
+ Network.TimeSinceEpoch timestamp
+ # How many uploads deep the related request was.
+ integer depth
+ # The number of delivery attempts made so far, not including an active attempt.
+ integer completedAttempts
+ object body
+ ReportStatus status
+
+ # Is sent whenever a new report is added.
+ # And after 'enableReportingApi' for all existing reports.
+ experimental event reportingApiReportAdded
+ parameters
+ ReportingApiReport report
+
+ experimental event reportingApiReportUpdated
+ parameters
+ ReportingApiReport report
+
+ experimental type ReportingApiEndpoint extends object
+ properties
+ # The URL of the endpoint to which reports may be delivered.
+ string url
+ # Name of the endpoint group.
+ string groupName
+
+ experimental event reportingApiEndpointsChangedForOrigin
+ parameters
+ # Origin of the document(s) which configured the endpoints.
+ string origin
+ array of ReportingApiEndpoint endpoints
+
+ # An object providing the result of a network resource load.
+ experimental type LoadNetworkResourcePageResult extends object
+ properties
+ boolean success
+ # Optional values used for error reporting.
+ optional number netError
+ optional string netErrorName
+ optional number httpStatusCode
+ # If successful, one of the following two fields holds the result.
+ optional IO.StreamHandle stream
+ # Response headers.
+ optional Network.Headers headers
+
+ # An options object that may be extended later to better support CORS,
+ # CORB and streaming.
+ experimental type LoadNetworkResourceOptions extends object
+ properties
+ boolean disableCache
+ boolean includeCredentials
+
+ # Fetches the resource and returns the content.
+ experimental command loadNetworkResource
+ parameters
+ # Frame id to get the resource for. Mandatory for frame targets, and
+ # should be omitted for worker targets.
+ optional Page.FrameId frameId
+ # URL of the resource to get content for.
+ string url
+ # Options for the request.
+ LoadNetworkResourceOptions options
+ returns
+ LoadNetworkResourcePageResult resource
+
+ # Sets Controls for third-party cookie access
+ # Page reload is required before the new cookie behavior will be observed
+ experimental command setCookieControls
+ parameters
+ # Whether 3pc restriction is enabled.
+ boolean enableThirdPartyCookieRestriction
+
+ # Whether 3pc grace period exception should be enabled; false by default.
+ boolean disableThirdPartyCookieMetadata
+
+ # Whether 3pc heuristics exceptions should be enabled; false by default.
+ boolean disableThirdPartyCookieHeuristics
diff --git a/pdl/domains/Overlay.pdl b/pdl/domains/Overlay.pdl
new file mode 100644
index 00000000..689e42d8
--- /dev/null
+++ b/pdl/domains/Overlay.pdl
@@ -0,0 +1,498 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain provides various functionality related to drawing atop the inspected page.
+experimental domain Overlay
+ depends on DOM
+ depends on Page
+ depends on Runtime
+
+ # Configuration data for drawing the source order of an elements children.
+ type SourceOrderConfig extends object
+ properties
+ # the color to outline the given element in.
+ DOM.RGBA parentOutlineColor
+ # the color to outline the child elements in.
+ DOM.RGBA childOutlineColor
+
+ # Configuration data for the highlighting of Grid elements.
+ type GridHighlightConfig extends object
+ properties
+ # Whether the extension lines from grid cells to the rulers should be shown (default: false).
+ optional boolean showGridExtensionLines
+ # Show Positive line number labels (default: false).
+ optional boolean showPositiveLineNumbers
+ # Show Negative line number labels (default: false).
+ optional boolean showNegativeLineNumbers
+ # Show area name labels (default: false).
+ optional boolean showAreaNames
+ # Show line name labels (default: false).
+ optional boolean showLineNames
+ # Show track size labels (default: false).
+ optional boolean showTrackSizes
+ # The grid container border highlight color (default: transparent).
+ optional DOM.RGBA gridBorderColor
+ # The cell border color (default: transparent). Deprecated, please use rowLineColor and columnLineColor instead.
+ deprecated optional DOM.RGBA cellBorderColor
+ # The row line color (default: transparent).
+ optional DOM.RGBA rowLineColor
+ # The column line color (default: transparent).
+ optional DOM.RGBA columnLineColor
+ # Whether the grid border is dashed (default: false).
+ optional boolean gridBorderDash
+ # Whether the cell border is dashed (default: false). Deprecated, please us rowLineDash and columnLineDash instead.
+ deprecated optional boolean cellBorderDash
+ # Whether row lines are dashed (default: false).
+ optional boolean rowLineDash
+ # Whether column lines are dashed (default: false).
+ optional boolean columnLineDash
+ # The row gap highlight fill color (default: transparent).
+ optional DOM.RGBA rowGapColor
+ # The row gap hatching fill color (default: transparent).
+ optional DOM.RGBA rowHatchColor
+ # The column gap highlight fill color (default: transparent).
+ optional DOM.RGBA columnGapColor
+ # The column gap hatching fill color (default: transparent).
+ optional DOM.RGBA columnHatchColor
+ # The named grid areas border color (Default: transparent).
+ optional DOM.RGBA areaBorderColor
+ # The grid container background color (Default: transparent).
+ optional DOM.RGBA gridBackgroundColor
+
+ # Configuration data for the highlighting of Flex container elements.
+ type FlexContainerHighlightConfig extends object
+ properties
+ # The style of the container border
+ optional LineStyle containerBorder
+ # The style of the separator between lines
+ optional LineStyle lineSeparator
+ # The style of the separator between items
+ optional LineStyle itemSeparator
+ # Style of content-distribution space on the main axis (justify-content).
+ optional BoxStyle mainDistributedSpace
+ # Style of content-distribution space on the cross axis (align-content).
+ optional BoxStyle crossDistributedSpace
+ # Style of empty space caused by row gaps (gap/row-gap).
+ optional BoxStyle rowGapSpace
+ # Style of empty space caused by columns gaps (gap/column-gap).
+ optional BoxStyle columnGapSpace
+ # Style of the self-alignment line (align-items).
+ optional LineStyle crossAlignment
+
+ # Configuration data for the highlighting of Flex item elements.
+ type FlexItemHighlightConfig extends object
+ properties
+ # Style of the box representing the item's base size
+ optional BoxStyle baseSizeBox
+ # Style of the border around the box representing the item's base size
+ optional LineStyle baseSizeBorder
+ # Style of the arrow representing if the item grew or shrank
+ optional LineStyle flexibilityArrow
+
+ # Style information for drawing a line.
+ type LineStyle extends object
+ properties
+ # The color of the line (default: transparent)
+ optional DOM.RGBA color
+ # The line pattern (default: solid)
+ optional enum pattern
+ dashed
+ dotted
+
+ # Style information for drawing a box.
+ type BoxStyle extends object
+ properties
+ # The background color for the box (default: transparent)
+ optional DOM.RGBA fillColor
+ # The hatching color for the box (default: transparent)
+ optional DOM.RGBA hatchColor
+
+ type ContrastAlgorithm extends string
+ enum
+ aa
+ aaa
+ apca
+
+ # Configuration data for the highlighting of page elements.
+ type HighlightConfig extends object
+ properties
+ # Whether the node info tooltip should be shown (default: false).
+ optional boolean showInfo
+ # Whether the node styles in the tooltip (default: false).
+ optional boolean showStyles
+ # Whether the rulers should be shown (default: false).
+ optional boolean showRulers
+ # Whether the a11y info should be shown (default: true).
+ optional boolean showAccessibilityInfo
+ # Whether the extension lines from node to the rulers should be shown (default: false).
+ optional boolean showExtensionLines
+ # The content box highlight fill color (default: transparent).
+ optional DOM.RGBA contentColor
+ # The padding highlight fill color (default: transparent).
+ optional DOM.RGBA paddingColor
+ # The border highlight fill color (default: transparent).
+ optional DOM.RGBA borderColor
+ # The margin highlight fill color (default: transparent).
+ optional DOM.RGBA marginColor
+ # The event target element highlight fill color (default: transparent).
+ optional DOM.RGBA eventTargetColor
+ # The shape outside fill color (default: transparent).
+ optional DOM.RGBA shapeColor
+ # The shape margin fill color (default: transparent).
+ optional DOM.RGBA shapeMarginColor
+ # The grid layout color (default: transparent).
+ optional DOM.RGBA cssGridColor
+ # The color format used to format color styles (default: hex).
+ optional ColorFormat colorFormat
+ # The grid layout highlight configuration (default: all transparent).
+ optional GridHighlightConfig gridHighlightConfig
+ # The flex container highlight configuration (default: all transparent).
+ optional FlexContainerHighlightConfig flexContainerHighlightConfig
+ # The flex item highlight configuration (default: all transparent).
+ optional FlexItemHighlightConfig flexItemHighlightConfig
+ # The contrast algorithm to use for the contrast ratio (default: aa).
+ optional ContrastAlgorithm contrastAlgorithm
+ # The container query container highlight configuration (default: all transparent).
+ optional ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
+
+ type ColorFormat extends string
+ enum
+ rgb
+ hsl
+ hwb
+ hex
+
+ # Configurations for Persistent Grid Highlight
+ type GridNodeHighlightConfig extends object
+ properties
+ # A descriptor for the highlight appearance.
+ GridHighlightConfig gridHighlightConfig
+ # Identifier of the node to highlight.
+ DOM.NodeId nodeId
+
+ type FlexNodeHighlightConfig extends object
+ properties
+ # A descriptor for the highlight appearance of flex containers.
+ FlexContainerHighlightConfig flexContainerHighlightConfig
+ # Identifier of the node to highlight.
+ DOM.NodeId nodeId
+
+ type ScrollSnapContainerHighlightConfig extends object
+ properties
+ # The style of the snapport border (default: transparent)
+ optional LineStyle snapportBorder
+ # The style of the snap area border (default: transparent)
+ optional LineStyle snapAreaBorder
+ # The margin highlight fill color (default: transparent).
+ optional DOM.RGBA scrollMarginColor
+ # The padding highlight fill color (default: transparent).
+ optional DOM.RGBA scrollPaddingColor
+
+ type ScrollSnapHighlightConfig extends object
+ properties
+ # A descriptor for the highlight appearance of scroll snap containers.
+ ScrollSnapContainerHighlightConfig scrollSnapContainerHighlightConfig
+ # Identifier of the node to highlight.
+ DOM.NodeId nodeId
+
+ # Configuration for dual screen hinge
+ type HingeConfig extends object
+ properties
+ # A rectangle represent hinge
+ DOM.Rect rect
+ # The content box highlight fill color (default: a dark color).
+ optional DOM.RGBA contentColor
+ # The content box highlight outline color (default: transparent).
+ optional DOM.RGBA outlineColor
+
+ # Configuration for Window Controls Overlay
+ type WindowControlsOverlayConfig extends object
+ properties
+ # Whether the title bar CSS should be shown when emulating the Window Controls Overlay.
+ boolean showCSS
+ # Selected platforms to show the overlay.
+ string selectedPlatform
+ # The theme color defined in app manifest.
+ string themeColor
+
+ type ContainerQueryHighlightConfig extends object
+ properties
+ # A descriptor for the highlight appearance of container query containers.
+ ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
+ # Identifier of the container node to highlight.
+ DOM.NodeId nodeId
+
+ type ContainerQueryContainerHighlightConfig extends object
+ properties
+ # The style of the container border.
+ optional LineStyle containerBorder
+ # The style of the descendants' borders.
+ optional LineStyle descendantBorder
+
+ type IsolatedElementHighlightConfig extends object
+ properties
+ # A descriptor for the highlight appearance of an element in isolation mode.
+ IsolationModeHighlightConfig isolationModeHighlightConfig
+ # Identifier of the isolated element to highlight.
+ DOM.NodeId nodeId
+
+ type IsolationModeHighlightConfig extends object
+ properties
+ # The fill color of the resizers (default: transparent).
+ optional DOM.RGBA resizerColor
+ # The fill color for resizer handles (default: transparent).
+ optional DOM.RGBA resizerHandleColor
+ # The fill color for the mask covering non-isolated elements (default: transparent).
+ optional DOM.RGBA maskColor
+
+ type InspectMode extends string
+ enum
+ searchForNode
+ searchForUAShadowDOM
+ captureAreaScreenshot
+ none
+
+ # Disables domain notifications.
+ command disable
+
+ # Enables domain notifications.
+ command enable
+
+ # For testing.
+ command getHighlightObjectForTest
+ parameters
+ # Id of the node to get highlight object for.
+ DOM.NodeId nodeId
+ # Whether to include distance info.
+ optional boolean includeDistance
+ # Whether to include style info.
+ optional boolean includeStyle
+ # The color format to get config with (default: hex).
+ optional ColorFormat colorFormat
+ # Whether to show accessibility info (default: true).
+ optional boolean showAccessibilityInfo
+ returns
+ # Highlight data for the node.
+ object highlight
+
+ # For Persistent Grid testing.
+ command getGridHighlightObjectsForTest
+ parameters
+ # Ids of the node to get highlight object for.
+ array of DOM.NodeId nodeIds
+ returns
+ # Grid Highlight data for the node ids provided.
+ object highlights
+
+ # For Source Order Viewer testing.
+ command getSourceOrderHighlightObjectForTest
+ parameters
+ # Id of the node to highlight.
+ DOM.NodeId nodeId
+ returns
+ # Source order highlight data for the node id provided.
+ object highlight
+
+ # Hides any highlight.
+ command hideHighlight
+
+ # Highlights owner element of the frame with given id.
+ # Deprecated: Doesn't work reliably and cannot be fixed due to process
+ # separation (the owner node might be in a different process). Determine
+ # the owner node in the client and use highlightNode.
+ deprecated command highlightFrame
+ parameters
+ # Identifier of the frame to highlight.
+ Page.FrameId frameId
+ # The content box highlight fill color (default: transparent).
+ optional DOM.RGBA contentColor
+ # The content box highlight outline color (default: transparent).
+ optional DOM.RGBA contentOutlineColor
+
+ # Highlights DOM node with given id or with the given JavaScript object wrapper. Either nodeId or
+ # objectId must be specified.
+ command highlightNode
+ parameters
+ # A descriptor for the highlight appearance.
+ HighlightConfig highlightConfig
+ # Identifier of the node to highlight.
+ optional DOM.NodeId nodeId
+ # Identifier of the backend node to highlight.
+ optional DOM.BackendNodeId backendNodeId
+ # JavaScript object id of the node to be highlighted.
+ optional Runtime.RemoteObjectId objectId
+ # Selectors to highlight relevant nodes.
+ optional string selector
+
+ # Highlights given quad. Coordinates are absolute with respect to the main frame viewport.
+ command highlightQuad
+ parameters
+ # Quad to highlight
+ DOM.Quad quad
+ # The highlight fill color (default: transparent).
+ optional DOM.RGBA color
+ # The highlight outline color (default: transparent).
+ optional DOM.RGBA outlineColor
+
+ # Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport.
+ # Issue: the method does not handle device pixel ratio (DPR) correctly.
+ # The coordinates currently have to be adjusted by the client
+ # if DPR is not 1 (see crbug.com/437807128).
+ command highlightRect
+ parameters
+ # X coordinate
+ integer x
+ # Y coordinate
+ integer y
+ # Rectangle width
+ integer width
+ # Rectangle height
+ integer height
+ # The highlight fill color (default: transparent).
+ optional DOM.RGBA color
+ # The highlight outline color (default: transparent).
+ optional DOM.RGBA outlineColor
+
+ # Highlights the source order of the children of the DOM node with given id or with the given
+ # JavaScript object wrapper. Either nodeId or objectId must be specified.
+ command highlightSourceOrder
+ parameters
+ # A descriptor for the appearance of the overlay drawing.
+ SourceOrderConfig sourceOrderConfig
+ # Identifier of the node to highlight.
+ optional DOM.NodeId nodeId
+ # Identifier of the backend node to highlight.
+ optional DOM.BackendNodeId backendNodeId
+ # JavaScript object id of the node to be highlighted.
+ optional Runtime.RemoteObjectId objectId
+
+ # Enters the 'inspect' mode. In this mode, elements that user is hovering over are highlighted.
+ # Backend then generates 'inspectNodeRequested' event upon element selection.
+ command setInspectMode
+ parameters
+ # Set an inspection mode.
+ InspectMode mode
+ # A descriptor for the highlight appearance of hovered-over nodes. May be omitted if `enabled
+ # == false`.
+ optional HighlightConfig highlightConfig
+
+ # Highlights owner element of all frames detected to be ads.
+ command setShowAdHighlights
+ parameters
+ # True for showing ad highlights
+ boolean show
+
+ command setPausedInDebuggerMessage
+ parameters
+ # The message to display, also triggers resume and step over controls.
+ optional string message
+
+ # Requests that backend shows debug borders on layers
+ command setShowDebugBorders
+ parameters
+ # True for showing debug borders
+ boolean show
+
+ # Requests that backend shows the FPS counter
+ command setShowFPSCounter
+ parameters
+ # True for showing the FPS counter
+ boolean show
+
+ # Highlight multiple elements with the CSS Grid overlay.
+ command setShowGridOverlays
+ parameters
+ # An array of node identifiers and descriptors for the highlight appearance.
+ array of GridNodeHighlightConfig gridNodeHighlightConfigs
+
+ command setShowFlexOverlays
+ parameters
+ # An array of node identifiers and descriptors for the highlight appearance.
+ array of FlexNodeHighlightConfig flexNodeHighlightConfigs
+
+ command setShowScrollSnapOverlays
+ parameters
+ # An array of node identifiers and descriptors for the highlight appearance.
+ array of ScrollSnapHighlightConfig scrollSnapHighlightConfigs
+
+ command setShowContainerQueryOverlays
+ parameters
+ # An array of node identifiers and descriptors for the highlight appearance.
+ array of ContainerQueryHighlightConfig containerQueryHighlightConfigs
+
+ # Requests that backend shows paint rectangles
+ command setShowPaintRects
+ parameters
+ # True for showing paint rectangles
+ boolean result
+
+ # Requests that backend shows layout shift regions
+ command setShowLayoutShiftRegions
+ parameters
+ # True for showing layout shift regions
+ boolean result
+
+ # Requests that backend shows scroll bottleneck rects
+ command setShowScrollBottleneckRects
+ parameters
+ # True for showing scroll bottleneck rects
+ boolean show
+
+ # Deprecated, no longer has any effect.
+ deprecated command setShowHitTestBorders
+ parameters
+ # True for showing hit-test borders
+ boolean show
+
+ # Deprecated, no longer has any effect.
+ deprecated command setShowWebVitals
+ parameters
+ boolean show
+
+ # Paints viewport size upon main frame resize.
+ command setShowViewportSizeOnResize
+ parameters
+ # Whether to paint size or not.
+ boolean show
+
+ # Add a dual screen device hinge
+ command setShowHinge
+ parameters
+ # hinge data, null means hideHinge
+ optional HingeConfig hingeConfig
+
+ # Show elements in isolation mode with overlays.
+ command setShowIsolatedElements
+ parameters
+ # An array of node identifiers and descriptors for the highlight appearance.
+ array of IsolatedElementHighlightConfig isolatedElementHighlightConfigs
+
+ # Show Window Controls Overlay for PWA
+ command setShowWindowControlsOverlay
+ parameters
+ # Window Controls Overlay data, null means hide Window Controls Overlay
+ optional WindowControlsOverlayConfig windowControlsOverlayConfig
+
+ # Fired when the node should be inspected. This happens after call to `setInspectMode` or when
+ # user manually inspects an element.
+ event inspectNodeRequested
+ parameters
+ # Id of the node to inspect.
+ DOM.BackendNodeId backendNodeId
+
+ # Fired when the node should be highlighted. This happens after call to `setInspectMode`.
+ event nodeHighlightRequested
+ parameters
+ DOM.NodeId nodeId
+
+ # Fired when user asks to capture screenshot of some area on the page.
+ event screenshotRequested
+ parameters
+ # Viewport to capture, in device independent pixels (dip).
+ Page.Viewport viewport
+
+ # Fired when user cancels the inspect mode.
+ event inspectModeCanceled
diff --git a/pdl/domains/PWA.pdl b/pdl/domains/PWA.pdl
new file mode 100644
index 00000000..1fd5973c
--- /dev/null
+++ b/pdl/domains/PWA.pdl
@@ -0,0 +1,142 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows interacting with the browser to control PWAs.
+experimental domain PWA
+
+ # The following types are the replica of
+ # https://crsrc.org/c/chrome/browser/web_applications/proto/web_app_os_integration_state.proto;drc=9910d3be894c8f142c977ba1023f30a656bc13fc;l=67
+ type FileHandlerAccept extends object
+ properties
+ # New name of the mimetype according to
+ # https://www.iana.org/assignments/media-types/media-types.xhtml
+ string mediaType
+ array of string fileExtensions
+
+ type FileHandler extends object
+ properties
+ string action
+ array of FileHandlerAccept accepts
+ string displayName
+
+ # Returns the following OS state for the given manifest id.
+ command getOsAppState
+ parameters
+ # The id from the webapp's manifest file, commonly it's the url of the
+ # site installing the webapp. See
+ # https://web.dev/learn/pwa/web-app-manifest.
+ string manifestId
+ returns
+ integer badgeCount
+ array of FileHandler fileHandlers
+
+ # Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
+ #
+ # IWA-specific install description:
+ # manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
+ #
+ # File installation mode:
+ # The installUrlOrBundleUrl can be either file:// or http(s):// pointing
+ # to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
+ # The .swbn file's signing key.
+ #
+ # Dev proxy installation mode:
+ # installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
+ # web_package::SignedWebBundleId must be of type dev proxy.
+ #
+ # The advantage of dev proxy mode is that all changes to IWA
+ # automatically will be reflected in the running app without
+ # reinstallation.
+ #
+ # To generate bundle id for proxy mode:
+ # 1. Generate 32 random bytes.
+ # 2. Add a specific suffix 0x00 at the end.
+ # 3. Encode the entire sequence using Base32 without padding.
+ #
+ # If Chrome is not in IWA dev
+ # mode, the installation will fail, regardless of the state of the allowlist.
+ command install
+ parameters
+ string manifestId
+ # The location of the app or bundle overriding the one derived from the
+ # manifestId.
+ optional string installUrlOrBundleUrl
+
+ # Uninstalls the given manifest_id and closes any opened app windows.
+ command uninstall
+ parameters
+ string manifestId
+
+ # Launches the installed web app, or an url in the same web app instead of the
+ # default start url if it is provided. Returns a page Target.TargetID which
+ # can be used to attach to via Target.attachToTarget or similar APIs.
+ command launch
+ parameters
+ string manifestId
+ optional string url
+ returns
+ # ID of the tab target created as a result.
+ Target.TargetID targetId
+
+ # Opens one or more local files from an installed web app identified by its
+ # manifestId. The web app needs to have file handlers registered to process
+ # the files. The API returns one or more page Target.TargetIDs which can be
+ # used to attach to via Target.attachToTarget or similar APIs.
+ # If some files in the parameters cannot be handled by the web app, they will
+ # be ignored. If none of the files can be handled, this API returns an error.
+ # If no files are provided as the parameter, this API also returns an error.
+ #
+ # According to the definition of the file handlers in the manifest file, one
+ # Target.TargetID may represent a page handling one or more files. The order
+ # of the returned Target.TargetIDs is not guaranteed.
+ #
+ # TODO(crbug.com/339454034): Check the existences of the input files.
+ command launchFilesInApp
+ parameters
+ string manifestId
+ array of string files
+ returns
+ # IDs of the tab targets created as the result.
+ array of Target.TargetID targetIds
+
+ # Opens the current page in its web app identified by the manifest id, needs
+ # to be called on a page target. This function returns immediately without
+ # waiting for the app to finish loading.
+ command openCurrentPageInApp
+ parameters
+ string manifestId
+
+ # If user prefers opening the app in browser or an app window.
+ type DisplayMode extends string
+ enum
+ standalone
+ browser
+
+ # Changes user settings of the web app identified by its manifestId. If the
+ # app was not installed, this command returns an error. Unset parameters will
+ # be ignored; unrecognized values will cause an error.
+ #
+ # Unlike the ones defined in the manifest files of the web apps, these
+ # settings are provided by the browser and controlled by the users, they
+ # impact the way the browser handling the web apps.
+ #
+ # See the comment of each parameter.
+ command changeAppUserSettings
+ parameters
+ string manifestId
+ # If user allows the links clicked on by the user in the app's scope, or
+ # extended scope if the manifest has scope extensions and the flags
+ # `DesktopPWAsLinkCapturingWithScopeExtensions` and
+ # `WebAppEnableScopeExtensions` are enabled.
+ #
+ # Note, the API does not support resetting the linkCapturing to the
+ # initial value, uninstalling and installing the web app again will reset
+ # it.
+ #
+ # TODO(crbug.com/339453269): Setting this value on ChromeOS is not
+ # supported yet.
+ optional boolean linkCapturing
+ optional DisplayMode displayMode
diff --git a/pdl/domains/Page.pdl b/pdl/domains/Page.pdl
new file mode 100644
index 00000000..036e058a
--- /dev/null
+++ b/pdl/domains/Page.pdl
@@ -0,0 +1,1767 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Actions and events related to the inspected page belong to the page domain.
+domain Page
+ depends on Debugger
+ depends on DOM
+ depends on IO
+ depends on Network
+ depends on Runtime
+
+ # Unique frame identifier.
+ type FrameId extends string
+
+ # Indicates whether a frame has been identified as an ad.
+ experimental type AdFrameType extends string
+ enum
+ none
+ # This frame is a subframe of an ad frame.
+ child
+ # This frame is the root of an ad frame.
+ root
+
+ experimental type AdFrameExplanation extends string
+ enum
+ ParentIsAd
+ CreatedByAdScript
+ MatchedBlockingRule
+
+ # Indicates whether a frame has been identified as an ad and why.
+ experimental type AdFrameStatus extends object
+ properties
+ AdFrameType adFrameType
+ optional array of AdFrameExplanation explanations
+
+ # Identifies the script which caused a script or frame to be labelled as an
+ # ad.
+ experimental type AdScriptId extends object
+ properties
+ # Script Id of the script which caused a script or frame to be labelled as
+ # an ad.
+ Runtime.ScriptId scriptId
+ # Id of scriptId's debugger.
+ Runtime.UniqueDebuggerId debuggerId
+
+ # Encapsulates the script ancestry and the root script filterlist rule that
+ # caused the frame to be labelled as an ad. Only created when `ancestryChain`
+ # is not empty.
+ experimental type AdScriptAncestry extends object
+ properties
+ # A chain of `AdScriptId`s representing the ancestry of an ad script that
+ # led to the creation of a frame. The chain is ordered from the script
+ # itself (lower level) up to its root ancestor that was flagged by
+ # filterlist.
+ array of AdScriptId ancestryChain
+ # The filterlist rule that caused the root (last) script in
+ # `ancestryChain` to be ad-tagged. Only populated if the rule is
+ # available.
+ optional string rootScriptFilterlistRule
+
+ # Indicates whether the frame is a secure context and why it is the case.
+ experimental type SecureContextType extends string
+ enum
+ # The origin is a secure context.
+ Secure
+ # The host is localhost and hence is considered secure.
+ SecureLocalhost
+ # The origin has an insecure scheme and is not localhost.
+ InsecureScheme
+ # One of the ancestor frames is not a secure context.
+ InsecureAncestor
+
+ # Indicates whether the frame is cross-origin isolated and why it is the case.
+ experimental type CrossOriginIsolatedContextType extends string
+ enum
+ # The origin is cross-origin isolated.
+ Isolated
+ # The origin is not cross-origin isolated.
+ NotIsolated
+ # The cross-origin isolation feature is disabled.
+ NotIsolatedFeatureDisabled
+
+ experimental type GatedAPIFeatures extends string
+ enum
+ SharedArrayBuffers
+ SharedArrayBuffersTransferAllowed
+ PerformanceMeasureMemory
+ PerformanceProfile
+
+ # All Permissions Policy features. This enum should match the one defined
+ # in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
+ # LINT.IfChange(PermissionsPolicyFeature)
+ experimental type PermissionsPolicyFeature extends string
+ enum
+ accelerometer
+ all-screens-capture
+ ambient-light-sensor
+ aria-notify
+ attribution-reporting
+ autoplay
+ bluetooth
+ browsing-topics
+ camera
+ captured-surface-control
+ ch-dpr
+ ch-device-memory
+ ch-downlink
+ ch-ect
+ ch-prefers-color-scheme
+ ch-prefers-reduced-motion
+ ch-prefers-reduced-transparency
+ ch-rtt
+ ch-save-data
+ ch-ua
+ ch-ua-arch
+ ch-ua-bitness
+ ch-ua-high-entropy-values
+ ch-ua-platform
+ ch-ua-model
+ ch-ua-mobile
+ ch-ua-form-factors
+ ch-ua-full-version
+ ch-ua-full-version-list
+ ch-ua-platform-version
+ ch-ua-wow64
+ ch-viewport-height
+ ch-viewport-width
+ ch-width
+ clipboard-read
+ clipboard-write
+ compute-pressure
+ controlled-frame
+ cross-origin-isolated
+ deferred-fetch
+ deferred-fetch-minimal
+ device-attributes
+ digital-credentials-create
+ digital-credentials-get
+ direct-sockets
+ direct-sockets-private
+ display-capture
+ document-domain
+ encrypted-media
+ execution-while-out-of-viewport
+ execution-while-not-rendered
+ fenced-unpartitioned-storage-read
+ focus-without-user-activation
+ fullscreen
+ frobulate
+ gamepad
+ geolocation
+ gyroscope
+ hid
+ identity-credentials-get
+ idle-detection
+ interest-cohort
+ join-ad-interest-group
+ keyboard-map
+ language-detector
+ language-model
+ local-fonts
+ local-network-access
+ magnetometer
+ media-playback-while-not-visible
+ microphone
+ midi
+ on-device-speech-recognition
+ otp-credentials
+ payment
+ picture-in-picture
+ popins
+ private-aggregation
+ private-state-token-issuance
+ private-state-token-redemption
+ publickey-credentials-create
+ publickey-credentials-get
+ record-ad-auction-events
+ rewriter
+ run-ad-auction
+ screen-wake-lock
+ serial
+ shared-autofill
+ shared-storage
+ shared-storage-select-url
+ smart-card
+ speaker-selection
+ storage-access
+ sub-apps
+ summarizer
+ sync-xhr
+ translator
+ unload
+ usb
+ usb-unrestricted
+ vertical-scroll
+ web-app-installation
+ web-printing
+ web-share
+ window-management
+ writer
+ xr-spatial-tracking
+ # LINT.ThenChange(//services/network/public/cpp/permissions_policy/permissions_policy_features.json5:PermissionsPolicy)
+
+ # Reason for a permissions policy feature to be disabled.
+ experimental type PermissionsPolicyBlockReason extends string
+ enum
+ # Declaration in HTTP header.
+ Header
+ # Declaration in iframe attribute.
+ IframeAttribute
+ # Inside fenced frame.
+ InFencedFrameTree
+ # Inside an Isolated Application.
+ InIsolatedApp
+
+ experimental type PermissionsPolicyBlockLocator extends object
+ properties
+ FrameId frameId
+ PermissionsPolicyBlockReason blockReason
+
+ experimental type PermissionsPolicyFeatureState extends object
+ properties
+ PermissionsPolicyFeature feature
+ boolean allowed
+ optional PermissionsPolicyBlockLocator locator
+
+ # Origin Trial(https://www.chromium.org/blink/origin-trials) support.
+ # Status for an Origin Trial token.
+ experimental type OriginTrialTokenStatus extends string
+ enum
+ Success
+ NotSupported
+ Insecure
+ Expired
+ WrongOrigin
+ InvalidSignature
+ Malformed
+ WrongVersion
+ FeatureDisabled
+ TokenDisabled
+ FeatureDisabledForUser
+ UnknownTrial
+
+ # Status for an Origin Trial.
+ experimental type OriginTrialStatus extends string
+ enum
+ Enabled
+ ValidTokenNotProvided
+ OSNotSupported
+ TrialNotAllowed
+
+ experimental type OriginTrialUsageRestriction extends string
+ enum
+ None
+ Subset
+
+ experimental type OriginTrialToken extends object
+ properties
+ string origin
+ boolean matchSubDomains
+ string trialName
+ Network.TimeSinceEpoch expiryTime
+ boolean isThirdParty
+ OriginTrialUsageRestriction usageRestriction
+
+ experimental type OriginTrialTokenWithStatus extends object
+ properties
+ string rawTokenText
+ # `parsedToken` is present only when the token is extractable and
+ # parsable.
+ optional OriginTrialToken parsedToken
+ OriginTrialTokenStatus status
+
+ experimental type OriginTrial extends object
+ properties
+ string trialName
+ OriginTrialStatus status
+ array of OriginTrialTokenWithStatus tokensWithStatus
+
+ # Additional information about the frame document's security origin.
+ experimental type SecurityOriginDetails extends object
+ properties
+ # Indicates whether the frame document's security origin is one
+ # of the local hostnames (e.g. "localhost") or IP addresses (IPv4
+ # 127.0.0.0/8 or IPv6 ::1).
+ boolean isLocalhost
+
+ # Information about the Frame on the page.
+ type Frame extends object
+ properties
+ # Frame unique identifier.
+ FrameId id
+ # Parent frame identifier.
+ optional FrameId parentId
+ # Identifier of the loader associated with this frame.
+ Network.LoaderId loaderId
+ # Frame's name as specified in the tag.
+ optional string name
+ # Frame document's URL without fragment.
+ string url
+ # Frame document's URL fragment including the '#'.
+ experimental optional string urlFragment
+ # Frame document's registered domain, taking the public suffixes list into account.
+ # Extracted from the Frame's url.
+ # Example URLs: http://www.google.com/file.html -> "google.com"
+ # http://a.b.co.uk/file.html -> "b.co.uk"
+ experimental string domainAndRegistry
+ # Frame document's security origin.
+ string securityOrigin
+ # Additional details about the frame document's security origin.
+ experimental optional SecurityOriginDetails securityOriginDetails
+ # Frame document's mimeType as determined by the browser.
+ string mimeType
+ # If the frame failed to load, this contains the URL that could not be loaded. Note that unlike url above, this URL may contain a fragment.
+ experimental optional string unreachableUrl
+ # Indicates whether this frame was tagged as an ad and why.
+ experimental optional AdFrameStatus adFrameStatus
+ # Indicates whether the main document is a secure context and explains why that is the case.
+ experimental SecureContextType secureContextType
+ # Indicates whether this is a cross origin isolated context.
+ experimental CrossOriginIsolatedContextType crossOriginIsolatedContextType
+ # Indicated which gated APIs / features are available.
+ experimental array of GatedAPIFeatures gatedAPIFeatures
+
+ # Information about the Resource on the page.
+ experimental type FrameResource extends object
+ properties
+ # Resource URL.
+ string url
+ # Type of this resource.
+ Network.ResourceType type
+ # Resource mimeType as determined by the browser.
+ string mimeType
+ # last-modified timestamp as reported by server.
+ optional Network.TimeSinceEpoch lastModified
+ # Resource content size.
+ optional number contentSize
+ # True if the resource failed to load.
+ optional boolean failed
+ # True if the resource was canceled during loading.
+ optional boolean canceled
+
+ # Information about the Frame hierarchy along with their cached resources.
+ experimental type FrameResourceTree extends object
+ properties
+ # Frame information for this tree item.
+ Frame frame
+ # Child frames.
+ optional array of FrameResourceTree childFrames
+ # Information about frame resources.
+ array of FrameResource resources
+
+ # Information about the Frame hierarchy.
+ type FrameTree extends object
+ properties
+ # Frame information for this tree item.
+ Frame frame
+ # Child frames.
+ optional array of FrameTree childFrames
+
+ # Unique script identifier.
+ type ScriptIdentifier extends string
+
+ # Transition type.
+ type TransitionType extends string
+ enum
+ link
+ typed
+ address_bar
+ auto_bookmark
+ auto_subframe
+ manual_subframe
+ generated
+ auto_toplevel
+ form_submit
+ reload
+ keyword
+ keyword_generated
+ other
+
+ # Navigation history entry.
+ type NavigationEntry extends object
+ properties
+ # Unique id of the navigation history entry.
+ integer id
+ # URL of the navigation history entry.
+ string url
+ # URL that the user typed in the url bar.
+ string userTypedURL
+ # Title of the navigation history entry.
+ string title
+ # Transition type.
+ TransitionType transitionType
+
+ # Screencast frame metadata.
+ experimental type ScreencastFrameMetadata extends object
+ properties
+ # Top offset in DIP.
+ number offsetTop
+ # Page scale factor.
+ number pageScaleFactor
+ # Device screen width in DIP.
+ number deviceWidth
+ # Device screen height in DIP.
+ number deviceHeight
+ # Position of horizontal scroll in CSS pixels.
+ number scrollOffsetX
+ # Position of vertical scroll in CSS pixels.
+ number scrollOffsetY
+ # Frame swap timestamp.
+ optional Network.TimeSinceEpoch timestamp
+
+ # Javascript dialog type.
+ type DialogType extends string
+ enum
+ alert
+ confirm
+ prompt
+ beforeunload
+
+ # Error while paring app manifest.
+ type AppManifestError extends object
+ properties
+ # Error message.
+ string message
+ # If critical, this is a non-recoverable parse error.
+ integer critical
+ # Error line.
+ integer line
+ # Error column.
+ integer column
+
+ # Parsed app manifest properties.
+ experimental type AppManifestParsedProperties extends object
+ properties
+ # Computed scope value
+ string scope
+
+ # Layout viewport position and dimensions.
+ type LayoutViewport extends object
+ properties
+ # Horizontal offset relative to the document (CSS pixels).
+ integer pageX
+ # Vertical offset relative to the document (CSS pixels).
+ integer pageY
+ # Width (CSS pixels), excludes scrollbar if present.
+ integer clientWidth
+ # Height (CSS pixels), excludes scrollbar if present.
+ integer clientHeight
+
+ # Visual viewport position, dimensions, and scale.
+ type VisualViewport extends object
+ properties
+ # Horizontal offset relative to the layout viewport (CSS pixels).
+ number offsetX
+ # Vertical offset relative to the layout viewport (CSS pixels).
+ number offsetY
+ # Horizontal offset relative to the document (CSS pixels).
+ number pageX
+ # Vertical offset relative to the document (CSS pixels).
+ number pageY
+ # Width (CSS pixels), excludes scrollbar if present.
+ number clientWidth
+ # Height (CSS pixels), excludes scrollbar if present.
+ number clientHeight
+ # Scale relative to the ideal viewport (size at width=device-width).
+ number scale
+ # Page zoom factor (CSS to device independent pixels ratio).
+ optional number zoom
+
+ # Viewport for capturing screenshot.
+ type Viewport extends object
+ properties
+ # X offset in device independent pixels (dip).
+ number x
+ # Y offset in device independent pixels (dip).
+ number y
+ # Rectangle width in device independent pixels (dip).
+ number width
+ # Rectangle height in device independent pixels (dip).
+ number height
+ # Page scale factor.
+ number scale
+
+ # Generic font families collection.
+ experimental type FontFamilies extends object
+ properties
+ # The standard font-family.
+ optional string standard
+ # The fixed font-family.
+ optional string fixed
+ # The serif font-family.
+ optional string serif
+ # The sansSerif font-family.
+ optional string sansSerif
+ # The cursive font-family.
+ optional string cursive
+ # The fantasy font-family.
+ optional string fantasy
+ # The math font-family.
+ optional string math
+
+ # Font families collection for a script.
+ experimental type ScriptFontFamilies extends object
+ properties
+ # Name of the script which these font families are defined for.
+ string script
+ # Generic font families collection for the script.
+ FontFamilies fontFamilies
+
+ # Default font sizes.
+ experimental type FontSizes extends object
+ properties
+ # Default standard font size.
+ optional integer standard
+ # Default fixed font size.
+ optional integer fixed
+
+ experimental type ClientNavigationReason extends string
+ enum
+ anchorClick
+ formSubmissionGet
+ formSubmissionPost
+ httpHeaderRefresh
+ initialFrameNavigation
+ metaTagRefresh
+ other
+ pageBlockInterstitial
+ reload
+ scriptInitiated
+
+ experimental type ClientNavigationDisposition extends string
+ enum
+ currentTab
+ newTab
+ newWindow
+ download
+
+ experimental type InstallabilityErrorArgument extends object
+ properties
+ # Argument name (e.g. name:'minimum-icon-size-in-pixels').
+ string name
+ # Argument value (e.g. value:'64').
+ string value
+
+ # The installability error
+ experimental type InstallabilityError extends object
+ properties
+ # The error id (e.g. 'manifest-missing-suitable-icon').
+ string errorId
+ # The list of error arguments (e.g. {name:'minimum-icon-size-in-pixels', value:'64'}).
+ array of InstallabilityErrorArgument errorArguments
+
+ # The referring-policy used for the navigation.
+ experimental type ReferrerPolicy extends string
+ enum
+ noReferrer
+ noReferrerWhenDowngrade
+ origin
+ originWhenCrossOrigin
+ sameOrigin
+ strictOrigin
+ strictOriginWhenCrossOrigin
+ unsafeUrl
+
+ # Per-script compilation cache parameters for `Page.produceCompilationCache`
+ experimental type CompilationCacheParams extends object
+ properties
+ # The URL of the script to produce a compilation cache entry for.
+ string url
+ # A hint to the backend whether eager compilation is recommended.
+ # (the actual compilation mode used is upon backend discretion).
+ optional boolean eager
+
+ # Deprecated, please use addScriptToEvaluateOnNewDocument instead.
+ experimental deprecated command addScriptToEvaluateOnLoad
+ parameters
+ string scriptSource
+ returns
+ # Identifier of the added script.
+ ScriptIdentifier identifier
+
+ # Evaluates given script in every frame upon creation (before loading frame's scripts).
+ command addScriptToEvaluateOnNewDocument
+ parameters
+ string source
+ # If specified, creates an isolated world with the given name and evaluates given script in it.
+ # This world name will be used as the ExecutionContextDescription::name when the corresponding
+ # event is emitted.
+ experimental optional string worldName
+ # Specifies whether command line API should be available to the script, defaults
+ # to false.
+ experimental optional boolean includeCommandLineAPI
+ # If true, runs the script immediately on existing execution contexts or worlds.
+ # Default: false.
+ experimental optional boolean runImmediately
+ returns
+ # Identifier of the added script.
+ ScriptIdentifier identifier
+
+ # Brings page to front (activates tab).
+ command bringToFront
+
+ # Capture page screenshot.
+ command captureScreenshot
+ parameters
+ # Image compression format (defaults to png).
+ optional enum format
+ jpeg
+ png
+ webp
+ # Compression quality from range [0..100] (jpeg only).
+ optional integer quality
+ # Capture the screenshot of a given region only.
+ optional Viewport clip
+ # Capture the screenshot from the surface, rather than the view. Defaults to true.
+ experimental optional boolean fromSurface
+ # Capture the screenshot beyond the viewport. Defaults to false.
+ experimental optional boolean captureBeyondViewport
+ # Optimize image encoding for speed, not for resulting size (defaults to false)
+ experimental optional boolean optimizeForSpeed
+ returns
+ # Base64-encoded image data.
+ binary data
+
+ # Returns a snapshot of the page as a string. For MHTML format, the serialization includes
+ # iframes, shadow DOM, external resources, and element-inline styles.
+ experimental command captureSnapshot
+ parameters
+ # Format (defaults to mhtml).
+ optional enum format
+ mhtml
+ returns
+ # Serialized page data.
+ string data
+
+ # Clears the overridden device metrics.
+ experimental deprecated command clearDeviceMetricsOverride
+ # Use 'Emulation.clearDeviceMetricsOverride' instead
+ redirect Emulation
+
+ # Clears the overridden Device Orientation.
+ experimental deprecated command clearDeviceOrientationOverride
+ # Use 'DeviceOrientation.clearDeviceOrientationOverride' instead
+ redirect DeviceOrientation
+
+ # Clears the overridden Geolocation Position and Error.
+ deprecated command clearGeolocationOverride
+ # Use 'Emulation.clearGeolocationOverride' instead
+ redirect Emulation
+
+ # Creates an isolated world for the given frame.
+ command createIsolatedWorld
+ parameters
+ # Id of the frame in which the isolated world should be created.
+ FrameId frameId
+ # An optional name which is reported in the Execution Context.
+ optional string worldName
+ # Whether or not universal access should be granted to the isolated world. This is a powerful
+ # option, use with caution.
+ optional boolean grantUniveralAccess
+ returns
+ # Execution context of the isolated world.
+ Runtime.ExecutionContextId executionContextId
+
+ # Deletes browser cookie with given name, domain and path.
+ experimental deprecated command deleteCookie
+ # Use 'Network.deleteCookie' instead
+ redirect Network
+ parameters
+ # Name of the cookie to remove.
+ string cookieName
+ # URL to match cooke domain and path.
+ string url
+
+ # Disables page domain notifications.
+ command disable
+
+ # Enables page domain notifications.
+ command enable
+ parameters
+ # If true, the `Page.fileChooserOpened` event will be emitted regardless of the state set by
+ # `Page.setInterceptFileChooserDialog` command (default: false).
+ experimental optional boolean enableFileChooserOpenedEvent
+
+ # The manifest of a webapp, see
+ # https://www.w3.org/TR/appmanifest/#dfn-manifest.
+ # Some fields do not appear in the standard since the API is designed to
+ # expose more browser internal states.
+
+ experimental type FileFilter extends object
+ properties
+ optional string name
+ optional array of string accepts
+
+ experimental type FileHandler extends object
+ properties
+ string action
+ string name
+ optional array of ImageResource icons
+ # Mimic a map, name is the key, accepts is the value.
+ optional array of FileFilter accepts
+ # Won't repeat the enums, using string for easy comparison. Same as the
+ # other enums below.
+ string launchType
+
+ # The image definition used in both icon and screenshot.
+ experimental type ImageResource extends object
+ properties
+ # The src field in the definition, but changing to url in favor of
+ # consistency.
+ string url
+ optional string sizes
+ optional string type
+
+ experimental type LaunchHandler extends object
+ properties
+ string clientMode
+
+ experimental type ProtocolHandler extends object
+ properties
+ string protocol
+ string url
+
+ experimental type RelatedApplication extends object
+ properties
+ optional string id
+ string url
+
+ experimental type ScopeExtension extends object
+ properties
+ # Instead of using tuple, this field always returns the serialized string
+ # for easy understanding and comparison.
+ string origin
+ boolean hasOriginWildcard
+
+ experimental type Screenshot extends object
+ properties
+ ImageResource image
+ string formFactor
+ optional string label
+
+ experimental type ShareTarget extends object
+ properties
+ string action
+ string method
+ string enctype
+ # Embed the ShareTargetParams
+ optional string title
+ optional string text
+ optional string url
+ optional array of FileFilter files
+
+ experimental type Shortcut extends object
+ properties
+ string name
+ string url
+
+ experimental type WebAppManifest extends object
+ properties
+ optional string backgroundColor
+ # The extra description provided by the manifest.
+ optional string description
+ optional string dir
+ optional string display
+ # The overrided display mode controlled by the user.
+ optional array of string displayOverrides
+ # The handlers to open files.
+ optional array of FileHandler fileHandlers
+ optional array of ImageResource icons
+ optional string id
+ optional string lang
+ # TODO(crbug.com/1231886): This field is non-standard and part of a Chrome
+ # experiment. See:
+ # https://github.com/WICG/web-app-launch/blob/main/launch_handler.md
+ optional LaunchHandler launchHandler
+ optional string name
+ optional string orientation
+ optional boolean preferRelatedApplications
+ # The handlers to open protocols.
+ optional array of ProtocolHandler protocolHandlers
+ optional array of RelatedApplication relatedApplications
+ optional string scope
+ # Non-standard, see
+ # https://github.com/WICG/manifest-incubations/blob/gh-pages/scope_extensions-explainer.md
+ optional array of ScopeExtension scopeExtensions
+ # The screenshots used by chromium.
+ optional array of Screenshot screenshots
+ optional ShareTarget shareTarget
+ optional string shortName
+ optional array of Shortcut shortcuts
+ optional string startUrl
+ optional string themeColor
+
+ # Gets the processed manifest for this current document.
+ # This API always waits for the manifest to be loaded.
+ # If manifestId is provided, and it does not match the manifest of the
+ # current document, this API errors out.
+ # If there is not a loaded page, this API errors out immediately.
+ command getAppManifest
+ parameters
+ optional string manifestId
+ returns
+ # Manifest location.
+ string url
+ array of AppManifestError errors
+ # Manifest content.
+ optional string data
+ # Parsed manifest properties. Deprecated, use manifest instead.
+ experimental deprecated optional AppManifestParsedProperties parsed
+ experimental WebAppManifest manifest
+
+ experimental command getInstallabilityErrors
+ returns
+ array of InstallabilityError installabilityErrors
+
+ # Deprecated because it's not guaranteed that the returned icon is in fact the one used for PWA installation.
+ experimental deprecated command getManifestIcons
+ returns
+ optional binary primaryIcon
+
+ # Returns the unique (PWA) app id.
+ # Only returns values if the feature flag 'WebAppEnableManifestId' is enabled
+ experimental command getAppId
+ returns
+ # App id, either from manifest's id attribute or computed from start_url
+ optional string appId
+ # Recommendation for manifest's id attribute to match current id computed from start_url
+ optional string recommendedId
+
+ experimental command getAdScriptAncestry
+ parameters
+ FrameId frameId
+ returns
+ # The ancestry chain of ad script identifiers leading to this frame's
+ # creation, along with the root script's filterlist rule. The ancestry
+ # chain is ordered from the most immediate script (in the frame creation
+ # stack) to more distant ancestors (that created the immediately preceding
+ # script). Only sent if frame is labelled as an ad and ids are available.
+ optional AdScriptAncestry adScriptAncestry
+
+ # Returns present frame tree structure.
+ command getFrameTree
+ returns
+ # Present frame tree structure.
+ FrameTree frameTree
+
+ # Returns metrics relating to the layouting of the page, such as viewport bounds/scale.
+ command getLayoutMetrics
+ returns
+ # Deprecated metrics relating to the layout viewport. Is in device pixels. Use `cssLayoutViewport` instead.
+ deprecated LayoutViewport layoutViewport
+ # Deprecated metrics relating to the visual viewport. Is in device pixels. Use `cssVisualViewport` instead.
+ deprecated VisualViewport visualViewport
+ # Deprecated size of scrollable area. Is in DP. Use `cssContentSize` instead.
+ deprecated DOM.Rect contentSize
+ # Metrics relating to the layout viewport in CSS pixels.
+ LayoutViewport cssLayoutViewport
+ # Metrics relating to the visual viewport in CSS pixels.
+ VisualViewport cssVisualViewport
+ # Size of scrollable area in CSS pixels.
+ DOM.Rect cssContentSize
+
+ # Returns navigation history for the current page.
+ command getNavigationHistory
+ returns
+ # Index of the current navigation history entry.
+ integer currentIndex
+ # Array of navigation history entries.
+ array of NavigationEntry entries
+
+ # Resets navigation history for the current page.
+ command resetNavigationHistory
+
+ # Returns content of the given resource.
+ experimental command getResourceContent
+ parameters
+ # Frame id to get resource for.
+ FrameId frameId
+ # URL of the resource to get content for.
+ string url
+ returns
+ # Resource content.
+ string content
+ # True, if content was served as base64.
+ boolean base64Encoded
+
+ # Returns present frame / resource tree structure.
+ experimental command getResourceTree
+ returns
+ # Present frame / resource tree structure.
+ FrameResourceTree frameTree
+
+ # Accepts or dismisses a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload).
+ command handleJavaScriptDialog
+ parameters
+ # Whether to accept or dismiss the dialog.
+ boolean accept
+ # The text to enter into the dialog prompt before accepting. Used only if this is a prompt
+ # dialog.
+ optional string promptText
+
+ # Navigates current page to the given URL.
+ command navigate
+ parameters
+ # URL to navigate the page to.
+ string url
+ # Referrer URL.
+ optional string referrer
+ # Intended transition type.
+ optional TransitionType transitionType
+ # Frame id to navigate, if not specified navigates the top frame.
+ optional FrameId frameId
+ # Referrer-policy used for the navigation.
+ experimental optional ReferrerPolicy referrerPolicy
+ returns
+ # Frame id that has navigated (or failed to navigate)
+ FrameId frameId
+ # Loader identifier. This is omitted in case of same-document navigation,
+ # as the previously committed loaderId would not change.
+ optional Network.LoaderId loaderId
+ # User friendly error message, present if and only if navigation has failed.
+ optional string errorText
+ # Whether the navigation resulted in a download.
+ experimental optional boolean isDownload
+
+ # Navigates current page to the given history entry.
+ command navigateToHistoryEntry
+ parameters
+ # Unique id of the entry to navigate to.
+ integer entryId
+
+ # Print page as PDF.
+ command printToPDF
+ parameters
+ # Paper orientation. Defaults to false.
+ optional boolean landscape
+ # Display header and footer. Defaults to false.
+ optional boolean displayHeaderFooter
+ # Print background graphics. Defaults to false.
+ optional boolean printBackground
+ # Scale of the webpage rendering. Defaults to 1.
+ optional number scale
+ # Paper width in inches. Defaults to 8.5 inches.
+ optional number paperWidth
+ # Paper height in inches. Defaults to 11 inches.
+ optional number paperHeight
+ # Top margin in inches. Defaults to 1cm (~0.4 inches).
+ optional number marginTop
+ # Bottom margin in inches. Defaults to 1cm (~0.4 inches).
+ optional number marginBottom
+ # Left margin in inches. Defaults to 1cm (~0.4 inches).
+ optional number marginLeft
+ # Right margin in inches. Defaults to 1cm (~0.4 inches).
+ optional number marginRight
+ # Paper ranges to print, one based, e.g., '1-5, 8, 11-13'. Pages are
+ # printed in the document order, not in the order specified, and no
+ # more than once.
+ # Defaults to empty string, which implies the entire document is printed.
+ # The page numbers are quietly capped to actual page count of the
+ # document, and ranges beyond the end of the document are ignored.
+ # If this results in no pages to print, an error is reported.
+ # It is an error to specify a range with start greater than end.
+ optional string pageRanges
+ # HTML template for the print header. Should be valid HTML markup with following
+ # classes used to inject printing values into them:
+ # - `date`: formatted print date
+ # - `title`: document title
+ # - `url`: document location
+ # - `pageNumber`: current page number
+ # - `totalPages`: total pages in the document
+ #
+ # For example, `<span class=title></span>` would generate span containing the title.
+ optional string headerTemplate
+ # HTML template for the print footer. Should use the same format as the `headerTemplate`.
+ optional string footerTemplate
+ # Whether or not to prefer page size as defined by css. Defaults to false,
+ # in which case the content will be scaled to fit the paper size.
+ optional boolean preferCSSPageSize
+ # return as stream
+ experimental optional enum transferMode
+ ReturnAsBase64
+ ReturnAsStream
+ # Whether or not to generate tagged (accessible) PDF. Defaults to embedder choice.
+ experimental optional boolean generateTaggedPDF
+ # Whether or not to embed the document outline into the PDF.
+ experimental optional boolean generateDocumentOutline
+ returns
+ # Base64-encoded pdf data. Empty if |returnAsStream| is specified.
+ binary data
+ # A handle of the stream that holds resulting PDF data.
+ experimental optional IO.StreamHandle stream
+
+ # Reloads given page optionally ignoring the cache.
+ command reload
+ parameters
+ # If true, browser cache is ignored (as if the user pressed Shift+refresh).
+ optional boolean ignoreCache
+ # If set, the script will be injected into all frames of the inspected page after reload.
+ # Argument will be ignored if reloading dataURL origin.
+ optional string scriptToEvaluateOnLoad
+ # If set, an error will be thrown if the target page's main frame's
+ # loader id does not match the provided id. This prevents accidentally
+ # reloading an unintended target in case there's a racing navigation.
+ experimental optional Network.LoaderId loaderId
+
+ # Deprecated, please use removeScriptToEvaluateOnNewDocument instead.
+ experimental deprecated command removeScriptToEvaluateOnLoad
+ parameters
+ ScriptIdentifier identifier
+
+ # Removes given script from the list.
+ command removeScriptToEvaluateOnNewDocument
+ parameters
+ ScriptIdentifier identifier
+
+ # Acknowledges that a screencast frame has been received by the frontend.
+ experimental command screencastFrameAck
+ parameters
+ # Frame number.
+ integer sessionId
+
+ # Searches for given string in resource content.
+ experimental command searchInResource
+ parameters
+ # Frame id for resource to search in.
+ FrameId frameId
+ # URL of the resource to search in.
+ string url
+ # 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 Debugger.SearchMatch result
+
+ # Enable Chrome's experimental ad filter on all sites.
+ experimental command setAdBlockingEnabled
+ parameters
+ # Whether to block ads.
+ boolean enabled
+
+ # Enable page Content Security Policy by-passing.
+ command setBypassCSP
+ parameters
+ # Whether to bypass page CSP.
+ boolean enabled
+
+ # Get Permissions Policy state on given frame.
+ experimental command getPermissionsPolicyState
+ parameters
+ FrameId frameId
+ returns
+ array of PermissionsPolicyFeatureState states
+
+ # Get Origin Trials on given frame.
+ experimental command getOriginTrials
+ parameters
+ FrameId frameId
+ returns
+ array of OriginTrial originTrials
+
+ # Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
+ # window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
+ # query results).
+ experimental deprecated command setDeviceMetricsOverride
+ # Use 'Emulation.setDeviceMetricsOverride' instead
+ redirect Emulation
+ parameters
+ # Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
+ integer width
+ # Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
+ integer height
+ # Overriding device scale factor value. 0 disables the override.
+ number deviceScaleFactor
+ # Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
+ # autosizing and more.
+ boolean mobile
+ # Scale to apply to resulting view image.
+ optional number scale
+ # Overriding screen width value in pixels (minimum 0, maximum 10000000).
+ optional integer screenWidth
+ # Overriding screen height value in pixels (minimum 0, maximum 10000000).
+ optional integer screenHeight
+ # Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
+ optional integer positionX
+ # Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
+ optional integer positionY
+ # Do not set visible view size, rely upon explicit setVisibleSize call.
+ optional boolean dontSetVisibleSize
+ # Screen orientation override.
+ optional Emulation.ScreenOrientation screenOrientation
+ # The viewport dimensions and scale. If not set, the override is cleared.
+ optional Viewport viewport
+
+ # Overrides the Device Orientation.
+ experimental deprecated command setDeviceOrientationOverride
+ # Use 'DeviceOrientation.setDeviceOrientationOverride' instead
+ redirect DeviceOrientation
+ parameters
+ # Mock alpha
+ number alpha
+ # Mock beta
+ number beta
+ # Mock gamma
+ number gamma
+
+ # Set generic font families.
+ experimental command setFontFamilies
+ parameters
+ # Specifies font families to set. If a font family is not specified, it won't be changed.
+ FontFamilies fontFamilies
+ # Specifies font families to set for individual scripts.
+ optional array of ScriptFontFamilies forScripts
+
+ # Set default font sizes.
+ experimental command setFontSizes
+ parameters
+ # Specifies font sizes to set. If a font size is not specified, it won't be changed.
+ FontSizes fontSizes
+
+ # Sets given markup as the document's HTML.
+ command setDocumentContent
+ parameters
+ # Frame id to set HTML for.
+ FrameId frameId
+ # HTML content to set.
+ string html
+
+ # Set the behavior when downloading a file.
+ experimental deprecated command setDownloadBehavior
+ parameters
+ # Whether to allow all or deny all download requests, or use default Chrome behavior if
+ # available (otherwise deny).
+ enum behavior
+ deny
+ allow
+ default
+ # The default path to save downloaded files to. This is required if behavior is set to 'allow'
+ optional string downloadPath
+
+ # Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
+ # unavailable.
+ deprecated command setGeolocationOverride
+ # Use 'Emulation.setGeolocationOverride' instead
+ redirect Emulation
+ parameters
+ # Mock latitude
+ optional number latitude
+ # Mock longitude
+ optional number longitude
+ # Mock accuracy
+ optional number accuracy
+
+ # Controls whether page will emit lifecycle events.
+ command setLifecycleEventsEnabled
+ parameters
+ # If true, starts emitting lifecycle events.
+ boolean enabled
+
+ # Toggles mouse event-based touch event emulation.
+ experimental deprecated command setTouchEmulationEnabled
+ # Use 'Emulation.setTouchEmulationEnabled' instead
+ redirect Emulation
+ parameters
+ # Whether the touch event emulation should be enabled.
+ boolean enabled
+ # Touch/gesture events configuration. Default: current platform.
+ optional enum configuration
+ mobile
+ desktop
+
+ # Starts sending each frame using the `screencastFrame` event.
+ experimental command startScreencast
+ parameters
+ # Image compression format.
+ optional enum format
+ jpeg
+ png
+ # Compression quality from range [0..100].
+ optional integer quality
+ # Maximum screenshot width.
+ optional integer maxWidth
+ # Maximum screenshot height.
+ optional integer maxHeight
+ # Send every n-th frame.
+ optional integer everyNthFrame
+
+ # Force the page stop all navigations and pending resource fetches.
+ command stopLoading
+
+ # Crashes renderer on the IO thread, generates minidumps.
+ experimental command crash
+
+ # Tries to close page, running its beforeunload hooks, if any.
+ command close
+
+ # Tries to update the web lifecycle state of the page.
+ # It will transition the page to the given state according to:
+ # https://github.com/WICG/web-lifecycle/
+ experimental command setWebLifecycleState
+ parameters
+ # Target lifecycle state
+ enum state
+ frozen
+ active
+
+ # Stops sending each frame in the `screencastFrame`.
+ experimental command stopScreencast
+
+ # Requests backend to produce compilation cache for the specified scripts.
+ # `scripts` are appended to the list of scripts for which the cache
+ # would be produced. The list may be reset during page navigation.
+ # When script with a matching URL is encountered, the cache is optionally
+ # produced upon backend discretion, based on internal heuristics.
+ # See also: `Page.compilationCacheProduced`.
+ experimental command produceCompilationCache
+ parameters
+ array of CompilationCacheParams scripts
+
+ # Seeds compilation cache for given url. Compilation cache does not survive
+ # cross-process navigation.
+ experimental command addCompilationCache
+ parameters
+ string url
+ # Base64-encoded data
+ binary data
+
+ # Clears seeded compilation cache.
+ experimental command clearCompilationCache
+
+ # Sets the Secure Payment Confirmation transaction mode.
+ # https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
+ experimental command setSPCTransactionMode
+ parameters
+ enum mode
+ none
+ autoAccept
+ autoChooseToAuthAnotherWay
+ autoReject
+ autoOptOut
+
+ # Extensions for Custom Handlers API:
+ # https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
+ experimental command setRPHRegistrationMode
+ parameters
+ enum mode
+ none
+ autoAccept
+ autoReject
+
+ # Generates a report for testing.
+ experimental command generateTestReport
+ parameters
+ # Message to be displayed in the report.
+ string message
+ # Specifies the endpoint group to deliver the report to.
+ optional string group
+
+ # Pauses page execution. Can be resumed using generic Runtime.runIfWaitingForDebugger.
+ experimental command waitForDebugger
+
+ # Intercept file chooser requests and transfer control to protocol clients.
+ # When file chooser interception is enabled, native file chooser dialog is not shown.
+ # Instead, a protocol event `Page.fileChooserOpened` is emitted.
+ command setInterceptFileChooserDialog
+ parameters
+ boolean enabled
+ # If true, cancels the dialog by emitting relevant events (if any)
+ # in addition to not showing it if the interception is enabled
+ # (default: false).
+ experimental optional boolean cancel
+
+ event domContentEventFired
+ parameters
+ Network.MonotonicTime timestamp
+
+ # Emitted only when `page.interceptFileChooser` is enabled.
+ event fileChooserOpened
+ parameters
+ # Id of the frame containing input node.
+ experimental FrameId frameId
+ # Input mode.
+ enum mode
+ selectSingle
+ selectMultiple
+ # Input node id. Only present for file choosers opened via an `<input type="file">` element.
+ experimental optional DOM.BackendNodeId backendNodeId
+
+ # Fired when frame has been attached to its parent.
+ event frameAttached
+ parameters
+ # Id of the frame that has been attached.
+ FrameId frameId
+ # Parent frame identifier.
+ FrameId parentFrameId
+ # JavaScript stack trace of when frame was attached, only set if frame initiated from script.
+ optional Runtime.StackTrace stack
+
+ # Fired when frame no longer has a scheduled navigation.
+ deprecated event frameClearedScheduledNavigation
+ parameters
+ # Id of the frame that has cleared its scheduled navigation.
+ FrameId frameId
+
+ # Fired when frame has been detached from its parent.
+ event frameDetached
+ parameters
+ # Id of the frame that has been detached.
+ FrameId frameId
+ experimental enum reason
+ # The frame is removed from the DOM.
+ remove
+ # The frame is being swapped out in favor of an out-of-process iframe.
+ # A new frame target will be created (see Target.attachedToTarget).
+ swap
+
+ # Fired before frame subtree is detached. Emitted before any frame of the
+ # subtree is actually detached.
+ experimental event frameSubtreeWillBeDetached
+ parameters
+ # Id of the frame that is the root of the subtree that will be detached.
+ FrameId frameId
+
+ # The type of a frameNavigated event.
+ experimental type NavigationType extends string
+ enum
+ Navigation
+ BackForwardCacheRestore
+
+ # Fired once navigation of the frame has completed. Frame is now associated with the new loader.
+ event frameNavigated
+ parameters
+ # Frame object.
+ Frame frame
+ experimental NavigationType type
+
+ # Fired when opening document to write to.
+ experimental event documentOpened
+ parameters
+ # Frame object.
+ Frame frame
+
+ experimental event frameResized
+
+ # Fired when a navigation starts. This event is fired for both
+ # renderer-initiated and browser-initiated navigations. For renderer-initiated
+ # navigations, the event is fired after `frameRequestedNavigation`.
+ # Navigation may still be cancelled after the event is issued. Multiple events
+ # can be fired for a single navigation, for example, when a same-document
+ # navigation becomes a cross-document navigation (such as in the case of a
+ # frameset).
+ experimental event frameStartedNavigating
+ parameters
+ # ID of the frame that is being navigated.
+ FrameId frameId
+ # The URL the navigation started with. The final URL can be different.
+ string url
+ # Loader identifier. Even though it is present in case of same-document
+ # navigation, the previously committed loaderId would not change unless
+ # the navigation changes from a same-document to a cross-document
+ # navigation.
+ Network.LoaderId loaderId
+ enum navigationType
+ reload
+ reloadBypassingCache
+ restore
+ restoreWithPost
+ historySameDocument
+ historyDifferentDocument
+ sameDocument
+ differentDocument
+
+ # Fired when a renderer-initiated navigation is requested.
+ # Navigation may still be cancelled after the event is issued.
+ experimental event frameRequestedNavigation
+ parameters
+ # Id of the frame that is being navigated.
+ FrameId frameId
+ # The reason for the navigation.
+ ClientNavigationReason reason
+ # The destination URL for the requested navigation.
+ string url
+ # The disposition for the navigation.
+ ClientNavigationDisposition disposition
+
+ # Fired when frame schedules a potential navigation.
+ deprecated event frameScheduledNavigation
+ parameters
+ # Id of the frame that has scheduled a navigation.
+ FrameId frameId
+ # Delay (in seconds) until the navigation is scheduled to begin. The navigation is not
+ # guaranteed to start.
+ number delay
+ # The reason for the navigation.
+ ClientNavigationReason reason
+ # The destination URL for the scheduled navigation.
+ string url
+
+ # Fired when frame has started loading.
+ experimental event frameStartedLoading
+ parameters
+ # Id of the frame that has started loading.
+ FrameId frameId
+
+ # Fired when frame has stopped loading.
+ experimental event frameStoppedLoading
+ parameters
+ # Id of the frame that has stopped loading.
+ FrameId frameId
+
+ # Fired when page is about to start a download.
+ # Deprecated. Use Browser.downloadWillBegin instead.
+ experimental deprecated event downloadWillBegin
+ parameters
+ # Id of the frame that caused download to begin.
+ FrameId frameId
+ # Global unique identifier of the download.
+ string guid
+ # URL of the resource being downloaded.
+ string url
+ # Suggested file name of the resource (the actual name of the file saved on disk may differ).
+ string suggestedFilename
+
+ # Fired when download makes progress. Last call has |done| == true.
+ # Deprecated. Use Browser.downloadProgress instead.
+ experimental deprecated event downloadProgress
+ parameters
+ # Global unique identifier of the download.
+ string guid
+ # Total expected bytes to download.
+ number totalBytes
+ # Total bytes received.
+ number receivedBytes
+ # Download status.
+ enum state
+ inProgress
+ completed
+ canceled
+
+ # Fired when interstitial page was hidden
+ event interstitialHidden
+
+ # Fired when interstitial page was shown
+ event interstitialShown
+
+ # Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) has been
+ # closed.
+ event javascriptDialogClosed
+ parameters
+ # Frame id.
+ experimental FrameId frameId
+ # Whether dialog was confirmed.
+ boolean result
+ # User input in case of prompt.
+ string userInput
+
+ # Fired when a JavaScript initiated dialog (alert, confirm, prompt, or onbeforeunload) is about to
+ # open.
+ event javascriptDialogOpening
+ parameters
+ # Frame url.
+ string url
+ # Frame id.
+ experimental FrameId frameId
+ # Message that will be displayed by the dialog.
+ string message
+ # Dialog type.
+ DialogType type
+ # True iff browser is capable showing or acting on the given dialog. When browser has no
+ # dialog handler for given target, calling alert while Page domain is engaged will stall
+ # the page execution. Execution can be resumed via calling Page.handleJavaScriptDialog.
+ boolean hasBrowserHandler
+ # Default dialog prompt.
+ optional string defaultPrompt
+
+ # Fired for lifecycle events (navigation, load, paint, etc) in the current
+ # target (including local frames).
+ event lifecycleEvent
+ parameters
+ # Id of the frame.
+ FrameId frameId
+ # Loader identifier. Empty string if the request is fetched from worker.
+ Network.LoaderId loaderId
+ string name
+ Network.MonotonicTime timestamp
+
+ # List of not restored reasons for back-forward cache.
+ experimental type BackForwardCacheNotRestoredReason extends string
+ enum
+ NotPrimaryMainFrame
+ BackForwardCacheDisabled
+ RelatedActiveContentsExist
+ HTTPStatusNotOK
+ SchemeNotHTTPOrHTTPS
+ Loading
+ WasGrantedMediaAccess
+ DisableForRenderFrameHostCalled
+ DomainNotAllowed
+ HTTPMethodNotGET
+ SubframeIsNavigating
+ Timeout
+ CacheLimit
+ JavaScriptExecution
+ RendererProcessKilled
+ RendererProcessCrashed
+ SchedulerTrackedFeatureUsed
+ ConflictingBrowsingInstance
+ CacheFlushed
+ ServiceWorkerVersionActivation
+ SessionRestored
+ ServiceWorkerPostMessage
+ EnteredBackForwardCacheBeforeServiceWorkerHostAdded
+ RenderFrameHostReused_SameSite
+ RenderFrameHostReused_CrossSite
+ ServiceWorkerClaim
+ IgnoreEventAndEvict
+ HaveInnerContents
+ TimeoutPuttingInCache
+ BackForwardCacheDisabledByLowMemory
+ BackForwardCacheDisabledByCommandLine
+ NetworkRequestDatapipeDrainedAsBytesConsumer
+ NetworkRequestRedirected
+ NetworkRequestTimeout
+ NetworkExceedsBufferLimit
+ NavigationCancelledWhileRestoring
+ NotMostRecentNavigationEntry
+ BackForwardCacheDisabledForPrerender
+ UserAgentOverrideDiffers
+ ForegroundCacheLimit
+ BrowsingInstanceNotSwapped
+ BackForwardCacheDisabledForDelegate
+ UnloadHandlerExistsInMainFrame
+ UnloadHandlerExistsInSubFrame
+ ServiceWorkerUnregistration
+ CacheControlNoStore
+ CacheControlNoStoreCookieModified
+ CacheControlNoStoreHTTPOnlyCookieModified
+ NoResponseHead
+ Unknown
+ ActivationNavigationsDisallowedForBug1234857
+ ErrorDocument
+ FencedFramesEmbedder
+ CookieDisabled
+ HTTPAuthRequired
+ CookieFlushed
+ BroadcastChannelOnMessage
+ WebViewSettingsChanged
+ WebViewJavaScriptObjectChanged
+ WebViewMessageListenerInjected
+ WebViewSafeBrowsingAllowlistChanged
+ WebViewDocumentStartJavascriptChanged
+ #Blocklisted features
+ WebSocket
+ WebTransport
+ WebRTC
+ MainResourceHasCacheControlNoStore
+ MainResourceHasCacheControlNoCache
+ SubresourceHasCacheControlNoStore
+ SubresourceHasCacheControlNoCache
+ ContainsPlugins
+ DocumentLoaded
+ OutstandingNetworkRequestOthers
+ RequestedMIDIPermission
+ RequestedAudioCapturePermission
+ RequestedVideoCapturePermission
+ RequestedBackForwardCacheBlockedSensors
+ RequestedBackgroundWorkPermission
+ BroadcastChannel
+ WebXR
+ SharedWorker
+ SharedWorkerMessage
+ WebLocks
+ WebHID
+ WebShare
+ RequestedStorageAccessGrant
+ WebNfc
+ OutstandingNetworkRequestFetch
+ OutstandingNetworkRequestXHR
+ AppBanner
+ Printing
+ WebDatabase
+ PictureInPicture
+ SpeechRecognizer
+ IdleManager
+ PaymentManager
+ SpeechSynthesis
+ KeyboardLock
+ WebOTPService
+ OutstandingNetworkRequestDirectSocket
+ InjectedJavascript
+ InjectedStyleSheet
+ KeepaliveRequest
+ IndexedDBEvent
+ Dummy
+ JsNetworkRequestReceivedCacheControlNoStoreResource
+ WebRTCSticky
+ WebTransportSticky
+ WebSocketSticky
+ SmartCard
+ LiveMediaStreamTrack
+ UnloadHandler
+ ParserAborted
+ # Disabled for RenderFrameHost reasons
+ # See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
+ ContentSecurityHandler
+ ContentWebAuthenticationAPI
+ ContentFileChooser
+ ContentSerial
+ ContentFileSystemAccess
+ ContentMediaDevicesDispatcherHost
+ ContentWebBluetooth
+ ContentWebUSB
+ ContentMediaSessionService
+ ContentScreenReader
+ ContentDiscarded
+
+ # See components/back_forward_cache/back_forward_cache_disable.h for explanations.
+ EmbedderPopupBlockerTabHelper
+ EmbedderSafeBrowsingTriggeredPopupBlocker
+ EmbedderSafeBrowsingThreatDetails
+ EmbedderAppBannerManager
+ EmbedderDomDistillerViewerSource
+ EmbedderDomDistillerSelfDeletingRequestDelegate
+ EmbedderOomInterventionTabHelper
+ EmbedderOfflinePage
+ EmbedderChromePasswordManagerClientBindCredentialManager
+ EmbedderPermissionRequestManager
+ EmbedderModalDialog
+ EmbedderExtensions
+ EmbedderExtensionMessaging
+ EmbedderExtensionMessagingForOpenPort
+ EmbedderExtensionSentMessageToCachedFrame
+ RequestedByWebViewClient
+ PostMessageByWebViewClient
+ CacheControlNoStoreDeviceBoundSessionTerminated
+ CacheLimitPrunedOnModerateMemoryPressure
+ CacheLimitPrunedOnCriticalMemoryPressure
+
+ # Types of not restored reasons for back-forward cache.
+ experimental type BackForwardCacheNotRestoredReasonType extends string
+ enum
+ SupportPending
+ PageSupportNeeded
+ Circumstantial
+
+ experimental type BackForwardCacheBlockingDetails extends object
+ properties
+ # Url of the file where blockage happened. Optional because of tests.
+ optional string url
+ # Function name where blockage happened. Optional because of anonymous functions and tests.
+ optional string function
+ # Line number in the script (0-based).
+ integer lineNumber
+ # Column number in the script (0-based).
+ integer columnNumber
+
+ experimental type BackForwardCacheNotRestoredExplanation extends object
+ properties
+ # Type of the reason
+ BackForwardCacheNotRestoredReasonType type
+ # Not restored reason
+ BackForwardCacheNotRestoredReason reason
+ # Context associated with the reason. The meaning of this context is
+ # dependent on the reason:
+ # - EmbedderExtensionSentMessageToCachedFrame: the extension ID.
+ #
+ optional string context
+ optional array of BackForwardCacheBlockingDetails details
+
+ experimental type BackForwardCacheNotRestoredExplanationTree extends object
+ properties
+ # URL of each frame
+ string url
+ # Not restored reasons of each frame
+ array of BackForwardCacheNotRestoredExplanation explanations
+ # Array of children frame
+ array of BackForwardCacheNotRestoredExplanationTree children
+
+ # 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.
+ experimental event backForwardCacheNotUsed
+ parameters
+ # The loader id for the associated navigation.
+ Network.LoaderId loaderId
+ # The frame id of the associated frame.
+ FrameId frameId
+ # Array of reasons why the page could not be cached. This must not be empty.
+ array of BackForwardCacheNotRestoredExplanation notRestoredExplanations
+ # Tree structure of reasons why the page could not be cached for each frame.
+ optional BackForwardCacheNotRestoredExplanationTree notRestoredExplanationsTree
+
+ event loadEventFired
+ parameters
+ Network.MonotonicTime timestamp
+
+ # Fired when same-document navigation happens, e.g. due to history API usage or anchor navigation.
+ experimental event navigatedWithinDocument
+ parameters
+ # Id of the frame.
+ FrameId frameId
+ # Frame's new url.
+ string url
+ # Navigation type
+ enum navigationType
+ # Navigation due to fragment navigation.
+ fragment
+ # Navigation due to history API usage.
+ historyApi
+ # Navigation due to other reasons.
+ other
+
+
+ # Compressed image data requested by the `startScreencast`.
+ experimental event screencastFrame
+ parameters
+ # Base64-encoded compressed image.
+ binary data
+ # Screencast frame metadata.
+ ScreencastFrameMetadata metadata
+ # Frame number.
+ integer sessionId
+
+ # Fired when the page with currently enabled screencast was shown or hidden `.
+ experimental event screencastVisibilityChanged
+ parameters
+ # True if the page is visible.
+ boolean visible
+
+ # Fired when a new window is going to be opened, via window.open(), link click, form submission,
+ # etc.
+ event windowOpen
+ parameters
+ # The URL for the new window.
+ string url
+ # Window name.
+ string windowName
+ # An array of enabled window features.
+ array of string windowFeatures
+ # Whether or not it was triggered by user gesture.
+ boolean userGesture
+
+ # Issued for every compilation cache generated.
+ experimental event compilationCacheProduced
+ parameters
+ string url
+ # Base64-encoded data
+ binary data
+
+ # Enable/disable prerendering manually.
+ #
+ # This command is a short-term solution for https://crbug.com/1440085.
+ # See https://docs.google.com/document/d/12HVmFxYj5Jc-eJr5OmWsa2bqTJsbgGLKI6ZIyx0_wpA
+ # for more details.
+ #
+ # TODO(https://crbug.com/1440085): Remove this once Puppeteer supports tab targets.
+ experimental command setPrerenderingAllowed
+ parameters
+ boolean isAllowed
diff --git a/pdl/domains/Performance.pdl b/pdl/domains/Performance.pdl
new file mode 100644
index 00000000..ace5249d
--- /dev/null
+++ b/pdl/domains/Performance.pdl
@@ -0,0 +1,54 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+domain Performance
+
+ # Run-time execution metric.
+ type Metric extends object
+ properties
+ # Metric name.
+ string name
+ # Metric value.
+ number value
+
+ # Disable collecting and reporting metrics.
+ command disable
+
+ # Enable collecting and reporting metrics.
+ command enable
+ parameters
+ # Time domain to use for collecting and reporting duration metrics.
+ optional enum timeDomain
+ # Use monotonically increasing abstract time (default).
+ timeTicks
+ # Use thread running time.
+ threadTicks
+
+ # Sets time domain to use for collecting and reporting duration metrics.
+ # Note that this must be called before enabling metrics collection. Calling
+ # this method while metrics collection is enabled returns an error.
+ experimental deprecated command setTimeDomain
+ parameters
+ # Time domain
+ enum timeDomain
+ # Use monotonically increasing abstract time (default).
+ timeTicks
+ # Use thread running time.
+ threadTicks
+
+ # Retrieve current values of run-time metrics.
+ command getMetrics
+ returns
+ # Current values for run-time metrics.
+ array of Metric metrics
+
+ # Current values of the metrics.
+ event metrics
+ parameters
+ # Current values of the metrics.
+ array of Metric metrics
+ # Timestamp title.
+ string title
diff --git a/pdl/domains/PerformanceTimeline.pdl b/pdl/domains/PerformanceTimeline.pdl
new file mode 100644
index 00000000..aa18d2bb
--- /dev/null
+++ b/pdl/domains/PerformanceTimeline.pdl
@@ -0,0 +1,71 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Reporting of performance timeline events, as specified in
+# https://w3c.github.io/performance-timeline/#dom-performanceobserver.
+experimental domain PerformanceTimeline
+ depends on DOM
+ depends on Network
+
+ # See https://github.com/WICG/LargestContentfulPaint and largest_contentful_paint.idl
+ type LargestContentfulPaint extends object
+ properties
+ Network.TimeSinceEpoch renderTime
+ Network.TimeSinceEpoch loadTime
+ # The number of pixels being painted.
+ number size
+ # The id attribute of the element, if available.
+ optional string elementId
+ # The URL of the image (may be trimmed).
+ optional string url
+ optional DOM.BackendNodeId nodeId
+
+ type LayoutShiftAttribution extends object
+ properties
+ DOM.Rect previousRect
+ DOM.Rect currentRect
+ optional DOM.BackendNodeId nodeId
+
+ # See https://wicg.github.io/layout-instability/#sec-layout-shift and layout_shift.idl
+ type LayoutShift extends object
+ properties
+ # Score increment produced by this event.
+ number value
+ boolean hadRecentInput
+ Network.TimeSinceEpoch lastInputTime
+ array of LayoutShiftAttribution sources
+
+ type TimelineEvent extends object
+ properties
+ # Identifies the frame that this event is related to. Empty for non-frame targets.
+ Page.FrameId frameId
+ # The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
+ # This determines which of the optional "details" fields is present.
+ string type
+ # Name may be empty depending on the type.
+ string name
+ # Time in seconds since Epoch, monotonically increasing within document lifetime.
+ Network.TimeSinceEpoch time
+ # Event duration, if applicable.
+ optional number duration
+ optional LargestContentfulPaint lcpDetails
+ optional LayoutShift layoutShiftDetails
+
+ # Previously buffered events would be reported before method returns.
+ # See also: timelineEventAdded
+ command enable
+ parameters
+ # The types of event to report, as specified in
+ # https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
+ # The specified filter overrides any previous filters, passing empty
+ # filter disables recording.
+ # Note that not all types exposed to the web platform are currently supported.
+ array of string eventTypes
+
+ # Sent when a performance timeline event is added. See reportPerformanceTimeline method.
+ event timelineEventAdded
+ parameters
+ TimelineEvent event
diff --git a/pdl/domains/Preload.pdl b/pdl/domains/Preload.pdl
new file mode 100644
index 00000000..50976854
--- /dev/null
+++ b/pdl/domains/Preload.pdl
@@ -0,0 +1,290 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Preload
+ # Unique id
+ type RuleSetId extends string
+
+ # Corresponds to SpeculationRuleSet
+ type RuleSet extends object
+ properties
+ RuleSetId id
+ # Identifies a document which the rule set is associated with.
+ Network.LoaderId loaderId
+ # Source text of JSON representing the rule set. If it comes from
+ # `<script>` tag, it is the textContent of the node. Note that it is
+ # a JSON for valid case.
+ #
+ # See also:
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html
+ # - https://github.com/WICG/nav-speculation/blob/main/triggers.md
+ string sourceText
+ # A speculation rule set is either added through an inline
+ # `<script>` tag or through an external resource via the
+ # 'Speculation-Rules' HTTP header. For the first case, we include
+ # the BackendNodeId of the relevant `<script>` tag. For the second
+ # case, we include the external URL where the rule set was loaded
+ # from, and also RequestId if Network domain is enabled.
+ #
+ # See also:
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-script
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-header
+ optional DOM.BackendNodeId backendNodeId
+ optional string url
+ optional Network.RequestId requestId
+ # Error information
+ # `errorMessage` is null iff `errorType` is null.
+ optional RuleSetErrorType errorType
+ # TODO(https://crbug.com/1425354): Replace this property with structured error.
+ deprecated optional string errorMessage
+
+ type RuleSetErrorType extends string
+ enum
+ SourceIsNotJsonObject
+ InvalidRulesSkipped
+ InvalidRulesetLevelTag
+
+ # The type of preloading attempted. It corresponds to
+ # mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
+ # isn't being used by clients).
+ type SpeculationAction extends string
+ enum
+ Prefetch
+ Prerender
+
+ # Corresponds to mojom::SpeculationTargetHint.
+ # See https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
+ type SpeculationTargetHint extends string
+ enum
+ Blank
+ Self
+
+ # A key that identifies a preloading attempt.
+ #
+ # The url used is the url specified by the trigger (i.e. the initial URL), and
+ # not the final url that is navigated to. For example, prerendering allows
+ # same-origin main frame navigations during the attempt, but the attempt is
+ # still keyed with the initial URL.
+ type PreloadingAttemptKey extends object
+ properties
+ Network.LoaderId loaderId
+ SpeculationAction action
+ string url
+ optional SpeculationTargetHint targetHint
+
+ # Lists sources for a preloading attempt, specifically the ids of rule sets
+ # that had a speculation rule that triggered the attempt, and the
+ # BackendNodeIds of <a href> or <area href> elements that triggered the
+ # attempt (in the case of attempts triggered by a document rule). It is
+ # possible for multiple rule sets and links to trigger a single attempt.
+ type PreloadingAttemptSource extends object
+ properties
+ PreloadingAttemptKey key
+ array of RuleSetId ruleSetIds
+ array of DOM.BackendNodeId nodeIds
+
+ # Chrome manages different types of preloads together using a
+ # concept of preloading pipeline. For example, if a site uses a
+ # SpeculationRules for prerender, Chrome first starts a prefetch and
+ # then upgrades it to prerender.
+ #
+ # CDP events for them are emitted separately but they share
+ # `PreloadPipelineId`.
+ type PreloadPipelineId extends string
+
+ command enable
+
+ command disable
+
+ # Upsert. Currently, it is only emitted when a rule set added.
+ event ruleSetUpdated
+ parameters
+ RuleSet ruleSet
+
+ event ruleSetRemoved
+ parameters
+ RuleSetId id
+
+ # List of FinalStatus reasons for Prerender2.
+ type PrerenderFinalStatus extends string
+ enum
+ Activated
+ Destroyed
+ LowEndDevice
+ InvalidSchemeRedirect
+ InvalidSchemeNavigation
+ NavigationRequestBlockedByCsp
+ MojoBinderPolicy
+ RendererProcessCrashed
+ RendererProcessKilled
+ Download
+ TriggerDestroyed
+ NavigationNotCommitted
+ NavigationBadHttpStatus
+ ClientCertRequested
+ NavigationRequestNetworkError
+ CancelAllHostsForTesting
+ DidFailLoad
+ Stop
+ SslCertificateError
+ LoginAuthRequested
+ UaChangeRequiresReload
+ BlockedByClient
+ AudioOutputDeviceRequested
+ MixedContent
+ TriggerBackgrounded
+ MemoryLimitExceeded
+ DataSaverEnabled
+ TriggerUrlHasEffectiveUrl
+ ActivatedBeforeStarted
+ InactivePageRestriction
+ StartFailed
+ TimeoutBackgrounded
+ CrossSiteRedirectInInitialNavigation
+ CrossSiteNavigationInInitialNavigation
+ SameSiteCrossOriginRedirectNotOptInInInitialNavigation
+ SameSiteCrossOriginNavigationNotOptInInInitialNavigation
+ ActivationNavigationParameterMismatch
+ ActivatedInBackground
+ EmbedderHostDisallowed
+ ActivationNavigationDestroyedBeforeSuccess
+ TabClosedByUserGesture
+ TabClosedWithoutUserGesture
+ PrimaryMainFrameRendererProcessCrashed
+ PrimaryMainFrameRendererProcessKilled
+ ActivationFramePolicyNotCompatible
+ PreloadingDisabled
+ BatterySaverEnabled
+ ActivatedDuringMainFrameNavigation
+ PreloadingUnsupportedByWebContents
+ CrossSiteRedirectInMainFrameNavigation
+ CrossSiteNavigationInMainFrameNavigation
+ SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation
+ SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
+ MemoryPressureOnTrigger
+ MemoryPressureAfterTriggered
+ PrerenderingDisabledByDevTools
+ SpeculationRuleRemoved
+ ActivatedWithAuxiliaryBrowsingContexts
+ MaxNumOfRunningEagerPrerendersExceeded
+ MaxNumOfRunningNonEagerPrerendersExceeded
+ MaxNumOfRunningEmbedderPrerendersExceeded
+ PrerenderingUrlHasEffectiveUrl
+ RedirectedPrerenderingUrlHasEffectiveUrl
+ ActivationUrlHasEffectiveUrl
+ JavaScriptInterfaceAdded
+ JavaScriptInterfaceRemoved
+ AllPrerenderingCanceled
+ WindowClosed
+ SlowNetwork
+ OtherPrerenderedPageActivated
+ V8OptimizerDisabled
+ PrerenderFailedDuringPrefetch
+ BrowsingDataRemoved
+ PrerenderHostReused
+
+ # Fired when a preload enabled state is updated.
+ event preloadEnabledStateUpdated
+ parameters
+ boolean disabledByPreference
+ boolean disabledByDataSaver
+ boolean disabledByBatterySaver
+ boolean disabledByHoldbackPrefetchSpeculationRules
+ boolean disabledByHoldbackPrerenderSpeculationRules
+
+ # Preloading status values, see also PreloadingTriggeringOutcome. This
+ # status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
+ type PreloadingStatus extends string
+ enum
+ Pending
+ Running
+ Ready
+ Success
+ Failure
+ # PreloadingTriggeringOutcome which not used by prefetch nor prerender.
+ NotSupported
+
+ # TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
+ # filter out the ones that aren't necessary to the developers.
+ type PrefetchStatus extends string
+ enum
+ # Prefetch is not disabled by PrefetchHeldback.
+ PrefetchAllowed
+ PrefetchFailedIneligibleRedirect
+ PrefetchFailedInvalidRedirect
+ PrefetchFailedMIMENotSupported
+ PrefetchFailedNetError
+ PrefetchFailedNon2XX
+ PrefetchEvictedAfterBrowsingDataRemoved
+ PrefetchEvictedAfterCandidateRemoved
+ PrefetchEvictedForNewerPrefetch
+ PrefetchHeldback
+ # A previous prefetch to the origin got a HTTP 503 response with an
+ # Retry-After header that has no elapsed yet.
+ PrefetchIneligibleRetryAfter
+ PrefetchIsPrivacyDecoy
+ PrefetchIsStale
+ PrefetchNotEligibleBrowserContextOffTheRecord
+ PrefetchNotEligibleDataSaverEnabled
+ PrefetchNotEligibleExistingProxy
+ PrefetchNotEligibleHostIsNonUnique
+ PrefetchNotEligibleNonDefaultStoragePartition
+ PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy
+ PrefetchNotEligibleSchemeIsNotHttps
+ PrefetchNotEligibleUserHasCookies
+ PrefetchNotEligibleUserHasServiceWorker
+ PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler
+ PrefetchNotEligibleRedirectFromServiceWorker
+ PrefetchNotEligibleRedirectToServiceWorker
+ PrefetchNotEligibleBatterySaverEnabled
+ PrefetchNotEligiblePreloadingDisabled
+ PrefetchNotFinishedInTime
+ PrefetchNotStarted
+ PrefetchNotUsedCookiesChanged
+ PrefetchProxyNotAvailable
+ # The response of the prefetch is used for the next navigation. This is
+ # the final successful state.
+ PrefetchResponseUsed
+ # The prefetch finished successfully but was never used.
+ PrefetchSuccessfulButNotUsed
+ PrefetchNotUsedProbeFailed
+
+ # Fired when a prefetch attempt is updated.
+ event prefetchStatusUpdated
+ parameters
+ PreloadingAttemptKey key
+ PreloadPipelineId pipelineId
+ # The frame id of the frame initiating prefetch.
+ Page.FrameId initiatingFrameId
+ string prefetchUrl
+ PreloadingStatus status
+ PrefetchStatus prefetchStatus
+ Network.RequestId requestId
+
+ # Information of headers to be displayed when the header mismatch occurred.
+ type PrerenderMismatchedHeaders extends object
+ properties
+ string headerName
+ optional string initialValue
+ optional string activationValue
+
+ # Fired when a prerender attempt is updated.
+ event prerenderStatusUpdated
+ parameters
+ PreloadingAttemptKey key
+ PreloadPipelineId pipelineId
+ PreloadingStatus status
+ optional PrerenderFinalStatus prerenderStatus
+ # This is used to give users more information about the name of Mojo interface
+ # that is incompatible with prerender and has caused the cancellation of the attempt.
+ optional string disallowedMojoInterface
+ optional array of PrerenderMismatchedHeaders mismatchedHeaders
+
+ # Send a list of sources for all preloading attempts in a document.
+ event preloadingAttemptSourcesUpdated
+ parameters
+ Network.LoaderId loaderId
+ array of PreloadingAttemptSource preloadingAttemptSources
diff --git a/pdl/domains/Security.pdl b/pdl/domains/Security.pdl
new file mode 100644
index 00000000..35c5ed03
--- /dev/null
+++ b/pdl/domains/Security.pdl
@@ -0,0 +1,196 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+domain Security
+
+ # An internal certificate ID value.
+ type CertificateId extends integer
+
+ # A description of mixed content (HTTP resources on HTTPS pages), as defined by
+ # https://www.w3.org/TR/mixed-content/#categories
+ type MixedContentType extends string
+ enum
+ blockable
+ optionally-blockable
+ none
+
+ # The security level of a page or resource.
+ type SecurityState extends string
+ enum
+ unknown
+ neutral
+ insecure
+ secure
+ info
+ insecure-broken
+
+ # Details about the security state of the page certificate.
+ experimental type CertificateSecurityState extends object
+ properties
+ # Protocol name (e.g. "TLS 1.2" or "QUIC").
+ string protocol
+ # Key Exchange used by the connection, or the empty string if not applicable.
+ string keyExchange
+ # (EC)DH group used by the connection, if applicable.
+ optional string keyExchangeGroup
+ # Cipher name.
+ string cipher
+ # TLS MAC. Note that AEAD ciphers do not have separate MACs.
+ optional string mac
+ # Page certificate.
+ array of string certificate
+ # Certificate subject name.
+ string subjectName
+ # Name of the issuing CA.
+ string issuer
+ # Certificate valid from date.
+ Network.TimeSinceEpoch validFrom
+ # Certificate valid to (expiration) date
+ Network.TimeSinceEpoch validTo
+ # The highest priority network error code, if the certificate has an error.
+ optional string certificateNetworkError
+ # True if the certificate uses a weak signature algorithm.
+ boolean certificateHasWeakSignature
+ # True if the certificate has a SHA1 signature in the chain.
+ boolean certificateHasSha1Signature
+ # True if modern SSL
+ boolean modernSSL
+ # True if the connection is using an obsolete SSL protocol.
+ boolean obsoleteSslProtocol
+ # True if the connection is using an obsolete SSL key exchange.
+ boolean obsoleteSslKeyExchange
+ # True if the connection is using an obsolete SSL cipher.
+ boolean obsoleteSslCipher
+ # True if the connection is using an obsolete SSL signature.
+ boolean obsoleteSslSignature
+
+ experimental type SafetyTipStatus extends string
+ enum
+ badReputation
+ lookalike
+
+ experimental type SafetyTipInfo extends object
+ properties
+ # Describes whether the page triggers any safety tips or reputation warnings. Default is unknown.
+ SafetyTipStatus safetyTipStatus
+ # The URL the safety tip suggested ("Did you mean?"). Only filled in for lookalike matches.
+ optional string safeUrl
+
+ # Security state information about the page.
+ experimental type VisibleSecurityState extends object
+ properties
+ # The security level of the page.
+ SecurityState securityState
+ # Security state details about the page certificate.
+ optional CertificateSecurityState certificateSecurityState
+ # The type of Safety Tip triggered on the page. Note that this field will be set even if the Safety Tip UI was not actually shown.
+ optional SafetyTipInfo safetyTipInfo
+ # Array of security state issues ids.
+ array of string securityStateIssueIds
+
+ # An explanation of an factor contributing to the security state.
+ type SecurityStateExplanation extends object
+ properties
+ # Security state representing the severity of the factor being explained.
+ SecurityState securityState
+ # Title describing the type of factor.
+ string title
+ # Short phrase describing the type of factor.
+ string summary
+ # Full text explanation of the factor.
+ string description
+ # The type of mixed content described by the explanation.
+ MixedContentType mixedContentType
+ # Page certificate.
+ array of string certificate
+ # Recommendations to fix any issues.
+ optional array of string recommendations
+
+ # Information about insecure content on the page.
+ deprecated type InsecureContentStatus extends object
+ properties
+ # Always false.
+ boolean ranMixedContent
+ # Always false.
+ boolean displayedMixedContent
+ # Always false.
+ boolean containedMixedForm
+ # Always false.
+ boolean ranContentWithCertErrors
+ # Always false.
+ boolean displayedContentWithCertErrors
+ # Always set to unknown.
+ SecurityState ranInsecureContentStyle
+ # Always set to unknown.
+ SecurityState displayedInsecureContentStyle
+
+ # The action to take when a certificate error occurs. continue will continue processing the
+ # request and cancel will cancel the request.
+ type CertificateErrorAction extends string
+ enum
+ continue
+ cancel
+
+ # Disables tracking security state changes.
+ command disable
+
+ # Enables tracking security state changes.
+ command enable
+
+ # Enable/disable whether all certificate errors should be ignored.
+ command setIgnoreCertificateErrors
+ parameters
+ # If true, all certificate errors will be ignored.
+ boolean ignore
+
+ # Handles a certificate error that fired a certificateError event.
+ deprecated command handleCertificateError
+ parameters
+ # The ID of the event.
+ integer eventId
+ # The action to take on the certificate error.
+ CertificateErrorAction action
+
+ # Enable/disable overriding certificate errors. If enabled, all certificate error events need to
+ # be handled by the DevTools client and should be answered with `handleCertificateError` commands.
+ deprecated command setOverrideCertificateErrors
+ parameters
+ # If true, certificate errors will be overridden.
+ boolean override
+
+ # 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.
+ deprecated event certificateError
+ parameters
+ # The ID of the event.
+ integer eventId
+ # The type of the error.
+ string errorType
+ # The url that was requested.
+ string requestURL
+
+ # The security state of the page changed.
+ experimental event visibleSecurityStateChanged
+ parameters
+ # Security state information about the page.
+ VisibleSecurityState visibleSecurityState
+
+ # The security state of the page changed. No longer being sent.
+ deprecated event securityStateChanged
+ parameters
+ # Security state.
+ SecurityState securityState
+ # True if the page was loaded over cryptographic transport such as HTTPS.
+ deprecated boolean schemeIsCryptographic
+ # Previously a list of explanations for the security state. Now always
+ # empty.
+ deprecated array of SecurityStateExplanation explanations
+ # Information about insecure content on the page.
+ deprecated InsecureContentStatus insecureContentStatus
+ # Overrides user-visible description of the state. Always omitted.
+ deprecated optional string summary
diff --git a/pdl/domains/ServiceWorker.pdl b/pdl/domains/ServiceWorker.pdl
new file mode 100644
index 00000000..8932ff9e
--- /dev/null
+++ b/pdl/domains/ServiceWorker.pdl
@@ -0,0 +1,121 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain ServiceWorker
+ depends on Target
+
+ type RegistrationID extends string
+
+ # ServiceWorker registration.
+ type ServiceWorkerRegistration extends object
+ properties
+ RegistrationID registrationId
+ string scopeURL
+ boolean isDeleted
+
+ type ServiceWorkerVersionRunningStatus extends string
+ enum
+ stopped
+ starting
+ running
+ stopping
+
+ type ServiceWorkerVersionStatus extends string
+ enum
+ new
+ installing
+ installed
+ activating
+ activated
+ redundant
+
+ # ServiceWorker version.
+ type ServiceWorkerVersion extends object
+ properties
+ string versionId
+ RegistrationID registrationId
+ string scriptURL
+ ServiceWorkerVersionRunningStatus runningStatus
+ ServiceWorkerVersionStatus status
+ # The Last-Modified header value of the main script.
+ optional number scriptLastModified
+ # The time at which the response headers of the main script were received from the server.
+ # For cached script it is the last time the cache entry was validated.
+ optional number scriptResponseTime
+ optional array of Target.TargetID controlledClients
+ optional Target.TargetID targetId
+ optional string routerRules
+
+ # ServiceWorker error message.
+ type ServiceWorkerErrorMessage extends object
+ properties
+ string errorMessage
+ RegistrationID registrationId
+ string versionId
+ string sourceURL
+ integer lineNumber
+ integer columnNumber
+
+ command deliverPushMessage
+ parameters
+ string origin
+ RegistrationID registrationId
+ string data
+
+ command disable
+
+ command dispatchSyncEvent
+ parameters
+ string origin
+ RegistrationID registrationId
+ string tag
+ boolean lastChance
+
+ command dispatchPeriodicSyncEvent
+ parameters
+ string origin
+ RegistrationID registrationId
+ string tag
+
+ command enable
+
+ command setForceUpdateOnPageLoad
+ parameters
+ boolean forceUpdateOnPageLoad
+
+ command skipWaiting
+ parameters
+ string scopeURL
+
+ command startWorker
+ parameters
+ string scopeURL
+
+ command stopAllWorkers
+
+ command stopWorker
+ parameters
+ string versionId
+
+ command unregister
+ parameters
+ string scopeURL
+
+ command updateRegistration
+ parameters
+ string scopeURL
+
+ event workerErrorReported
+ parameters
+ ServiceWorkerErrorMessage errorMessage
+
+ event workerRegistrationUpdated
+ parameters
+ array of ServiceWorkerRegistration registrations
+
+ event workerVersionUpdated
+ parameters
+ array of ServiceWorkerVersion versions
diff --git a/pdl/domains/Storage.pdl b/pdl/domains/Storage.pdl
new file mode 100644
index 00000000..5c4e1302
--- /dev/null
+++ b/pdl/domains/Storage.pdl
@@ -0,0 +1,913 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+experimental domain Storage
+ depends on Browser
+ depends on Network
+
+ type SerializedStorageKey extends string
+
+ # Enum of possible storage types.
+ type StorageType extends string
+ enum
+ cookies
+ file_systems
+ indexeddb
+ local_storage
+ shader_cache
+ websql
+ service_workers
+ cache_storage
+ interest_groups
+ shared_storage
+ storage_buckets
+ all
+ other
+
+ # Usage for a storage type.
+ type UsageForType extends object
+ properties
+ # Name of storage type.
+ StorageType storageType
+ # Storage usage (bytes).
+ number usage
+
+ # Pair of issuer origin and number of available (signed, but not used) Trust
+ # Tokens from that issuer.
+ experimental type TrustTokens extends object
+ properties
+ string issuerOrigin
+ number count
+
+ # Protected audience interest group auction identifier.
+ type InterestGroupAuctionId extends string
+
+ # Enum of interest group access types.
+ type InterestGroupAccessType extends string
+ enum
+ join
+ leave
+ update
+ loaded
+ bid
+ win
+ additionalBid
+ additionalBidWin
+ topLevelBid
+ topLevelAdditionalBid
+ clear
+
+ # Enum of auction events.
+ type InterestGroupAuctionEventType extends string
+ enum
+ started
+ configResolved
+
+ # Enum of network fetches auctions can do.
+ type InterestGroupAuctionFetchType extends string
+ enum
+ bidderJs
+ bidderWasm
+ sellerJs
+ bidderTrustedSignals
+ sellerTrustedSignals
+
+ # Enum of shared storage access scopes.
+ type SharedStorageAccessScope extends string
+ enum
+ window
+ sharedStorageWorklet
+ protectedAudienceWorklet
+ header
+
+ # Enum of shared storage access methods.
+ type SharedStorageAccessMethod extends string
+ enum
+ addModule
+ createWorklet
+ selectURL
+ run
+ batchUpdate
+ set
+ append
+ delete
+ clear
+ get
+ keys
+ values
+ entries
+ length
+ remainingBudget
+
+ # Struct for a single key-value pair in an origin's shared storage.
+ type SharedStorageEntry extends object
+ properties
+ string key
+ string value
+
+ # Details for an origin's shared storage.
+ type SharedStorageMetadata extends object
+ properties
+ # Time when the origin's shared storage was last created.
+ Network.TimeSinceEpoch creationTime
+ # Number of key-value pairs stored in origin's shared storage.
+ integer length
+ # Current amount of bits of entropy remaining in the navigation budget.
+ number remainingBudget
+ # Total number of bytes stored as key-value pairs in origin's shared
+ # storage.
+ integer bytesUsed
+
+ # Represents a dictionary object passed in as privateAggregationConfig to
+ # run or selectURL.
+ type SharedStoragePrivateAggregationConfig extends object
+ properties
+ # The chosen aggregation service deployment.
+ optional string aggregationCoordinatorOrigin
+ # The context ID provided.
+ optional string contextId
+ # Configures the maximum size allowed for filtering IDs.
+ integer filteringIdMaxBytes
+ # The limit on the number of contributions in the final report.
+ optional integer maxContributions
+
+ # Pair of reporting metadata details for a candidate URL for `selectURL()`.
+ type SharedStorageReportingMetadata extends object
+ properties
+ string eventType
+ string reportingUrl
+
+ # Bundles a candidate URL with its reporting metadata.
+ type SharedStorageUrlWithMetadata extends object
+ properties
+ # Spec of candidate URL.
+ string url
+ # Any associated reporting metadata.
+ array of SharedStorageReportingMetadata reportingMetadata
+
+ # Bundles the parameters for shared storage access events whose
+ # presence/absence can vary according to SharedStorageAccessType.
+ type SharedStorageAccessParams extends object
+ properties
+ # Spec of the module script URL.
+ # Present only for SharedStorageAccessMethods: addModule and
+ # createWorklet.
+ optional string scriptSourceUrl
+ # String denoting "context-origin", "script-origin", or a custom
+ # origin to be used as the worklet's data origin.
+ # Present only for SharedStorageAccessMethod: createWorklet.
+ optional string dataOrigin
+ # Name of the registered operation to be run.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional string operationName
+ # ID of the operation call.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional string operationId
+ # Whether or not to keep the worket alive for future run or selectURL
+ # calls.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional boolean keepAlive
+ # Configures the private aggregation options.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional SharedStoragePrivateAggregationConfig privateAggregationConfig
+ # The operation's serialized data in bytes (converted to a string).
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ # TODO(crbug.com/401011862): Consider updating this parameter to binary.
+ optional string serializedData
+ # Array of candidate URLs' specs, along with any associated metadata.
+ # Present only for SharedStorageAccessMethod: selectURL.
+ optional array of SharedStorageUrlWithMetadata urlsWithMetadata
+ # Spec of the URN:UUID generated for a selectURL call.
+ # Present only for SharedStorageAccessMethod: selectURL.
+ optional string urnUuid
+ # Key for a specific entry in an origin's shared storage.
+ # Present only for SharedStorageAccessMethods: set, append, delete, and
+ # get.
+ optional string key
+ # Value for a specific entry in an origin's shared storage.
+ # Present only for SharedStorageAccessMethods: set and append.
+ optional string value
+ # Whether or not to set an entry for a key if that key is already present.
+ # Present only for SharedStorageAccessMethod: set.
+ optional boolean ignoreIfPresent
+ # A number denoting the (0-based) order of the worklet's
+ # creation relative to all other shared storage worklets created by
+ # documents using the current storage partition.
+ # Present only for SharedStorageAccessMethods: addModule, createWorklet.
+ optional integer workletOrdinal
+ # Hex representation of the DevTools token used as the TargetID for the
+ # associated shared storage worklet.
+ # Present only for SharedStorageAccessMethods: addModule, createWorklet,
+ # run, selectURL, and any other SharedStorageAccessMethod when the
+ # SharedStorageAccessScope is sharedStorageWorklet.
+ optional Target.TargetID workletTargetId
+ # Name of the lock to be acquired, if present.
+ # Optionally present only for SharedStorageAccessMethods: batchUpdate,
+ # set, append, delete, and clear.
+ optional string withLock
+ # If the method has been called as part of a batchUpdate, then this
+ # number identifies the batch to which it belongs.
+ # Optionally present only for SharedStorageAccessMethods:
+ # batchUpdate (required), set, append, delete, and clear.
+ optional string batchUpdateId
+ # Number of modifier methods sent in batch.
+ # Present only for SharedStorageAccessMethod: batchUpdate.
+ optional integer batchSize
+
+ type StorageBucketsDurability extends string
+ enum
+ relaxed
+ strict
+
+ type StorageBucket extends object
+ properties
+ SerializedStorageKey storageKey
+ # If not specified, it is the default bucket of the storageKey.
+ optional string name
+
+ type StorageBucketInfo extends object
+ properties
+ StorageBucket bucket
+ string id
+ Network.TimeSinceEpoch expiration
+ # Storage quota (bytes).
+ number quota
+ boolean persistent
+ StorageBucketsDurability durability
+
+ # Returns a storage key given a frame id.
+ command getStorageKeyForFrame
+ parameters
+ Page.FrameId frameId
+ returns
+ SerializedStorageKey storageKey
+
+ # Clears storage for origin.
+ command clearDataForOrigin
+ parameters
+ # Security origin.
+ string origin
+ # Comma separated list of StorageType to clear.
+ string storageTypes
+
+ # Clears storage for storage key.
+ command clearDataForStorageKey
+ parameters
+ # Storage key.
+ string storageKey
+ # Comma separated list of StorageType to clear.
+ string storageTypes
+
+ # Returns all browser cookies.
+ command getCookies
+ parameters
+ # Browser context to use when called on the browser endpoint.
+ optional Browser.BrowserContextID browserContextId
+ returns
+ # Array of cookie objects.
+ array of Network.Cookie cookies
+
+ # Sets given cookies.
+ command setCookies
+ parameters
+ # Cookies to be set.
+ array of Network.CookieParam cookies
+ # Browser context to use when called on the browser endpoint.
+ optional Browser.BrowserContextID browserContextId
+
+ # Clears cookies.
+ command clearCookies
+ parameters
+ # Browser context to use when called on the browser endpoint.
+ optional Browser.BrowserContextID browserContextId
+
+ # Returns usage and quota in bytes.
+ command getUsageAndQuota
+ parameters
+ # Security origin.
+ string origin
+ returns
+ # Storage usage (bytes).
+ number usage
+ # Storage quota (bytes).
+ number quota
+ # Whether or not the origin has an active storage quota override
+ boolean overrideActive
+ # Storage usage per type (bytes).
+ array of UsageForType usageBreakdown
+
+ # Override quota for the specified origin
+ experimental command overrideQuotaForOrigin
+ parameters
+ # Security origin.
+ string origin
+ # The quota size (in bytes) to override the original quota with.
+ # If this is called multiple times, the overridden quota will be equal to
+ # the quotaSize provided in the final call. If this is called without
+ # specifying a quotaSize, the quota will be reset to the default value for
+ # the specified origin. If this is called multiple times with different
+ # origins, the override will be maintained for each origin until it is
+ # disabled (called without a quotaSize).
+ optional number quotaSize
+
+ # Registers origin to be notified when an update occurs to its cache storage list.
+ command trackCacheStorageForOrigin
+ parameters
+ # Security origin.
+ string origin
+
+ # Registers storage key to be notified when an update occurs to its cache storage list.
+ command trackCacheStorageForStorageKey
+ parameters
+ # Storage key.
+ string storageKey
+
+ # Registers origin to be notified when an update occurs to its IndexedDB.
+ command trackIndexedDBForOrigin
+ parameters
+ # Security origin.
+ string origin
+
+ # Registers storage key to be notified when an update occurs to its IndexedDB.
+ command trackIndexedDBForStorageKey
+ parameters
+ # Storage key.
+ string storageKey
+
+ # Unregisters origin from receiving notifications for cache storage.
+ command untrackCacheStorageForOrigin
+ parameters
+ # Security origin.
+ string origin
+
+ # Unregisters storage key from receiving notifications for cache storage.
+ command untrackCacheStorageForStorageKey
+ parameters
+ # Storage key.
+ string storageKey
+
+ # Unregisters origin from receiving notifications for IndexedDB.
+ command untrackIndexedDBForOrigin
+ parameters
+ # Security origin.
+ string origin
+
+ # Unregisters storage key from receiving notifications for IndexedDB.
+ command untrackIndexedDBForStorageKey
+ parameters
+ # Storage key.
+ string storageKey
+
+ # Returns the number of stored Trust Tokens per issuer for the
+ # current browsing context.
+ experimental command getTrustTokens
+ returns
+ array of TrustTokens tokens
+
+ # Removes all Trust Tokens issued by the provided issuerOrigin.
+ # Leaves other stored data, including the issuer's Redemption Records, intact.
+ experimental command clearTrustTokens
+ parameters
+ string issuerOrigin
+ returns
+ # True if any tokens were deleted, false otherwise.
+ boolean didDeleteTokens
+
+ # Gets details for a named interest group.
+ experimental command getInterestGroupDetails
+ parameters
+ string ownerOrigin
+ string name
+ returns
+ # This largely corresponds to:
+ # https://wicg.github.io/turtledove/#dictdef-generatebidinterestgroup
+ # but has absolute expirationTime instead of relative lifetimeMs and
+ # also adds joiningOrigin.
+ object details
+
+ # Enables/Disables issuing of interestGroupAccessed events.
+ experimental command setInterestGroupTracking
+ parameters
+ boolean enable
+
+ # Enables/Disables issuing of interestGroupAuctionEventOccurred and
+ # interestGroupAuctionNetworkRequestCreated.
+ experimental command setInterestGroupAuctionTracking
+ parameters
+ boolean enable
+
+ # Gets metadata for an origin's shared storage.
+ experimental command getSharedStorageMetadata
+ parameters
+ string ownerOrigin
+ returns
+ SharedStorageMetadata metadata
+
+ # Gets the entries in an given origin's shared storage.
+ experimental command getSharedStorageEntries
+ parameters
+ string ownerOrigin
+ returns
+ array of SharedStorageEntry entries
+
+ # Sets entry with `key` and `value` for a given origin's shared storage.
+ experimental command setSharedStorageEntry
+ parameters
+ string ownerOrigin
+ string key
+ string value
+ # If `ignoreIfPresent` is included and true, then only sets the entry if
+ # `key` doesn't already exist.
+ optional boolean ignoreIfPresent
+
+ # Deletes entry for `key` (if it exists) for a given origin's shared storage.
+ experimental command deleteSharedStorageEntry
+ parameters
+ string ownerOrigin
+ string key
+
+ # Clears all entries for a given origin's shared storage.
+ experimental command clearSharedStorageEntries
+ parameters
+ string ownerOrigin
+
+ # Resets the budget for `ownerOrigin` by clearing all budget withdrawals.
+ experimental command resetSharedStorageBudget
+ parameters
+ string ownerOrigin
+
+ # Enables/disables issuing of sharedStorageAccessed events.
+ experimental command setSharedStorageTracking
+ parameters
+ boolean enable
+
+ # Set tracking for a storage key's buckets.
+ experimental command setStorageBucketTracking
+ parameters
+ string storageKey
+ boolean enable
+
+ # Deletes the Storage Bucket with the given storage key and bucket name.
+ experimental command deleteStorageBucket
+ parameters
+ StorageBucket bucket
+
+ # Deletes state for sites identified as potential bounce trackers, immediately.
+ experimental command runBounceTrackingMitigations
+ returns
+ array of string deletedSites
+
+ # A cache's contents have been modified.
+ event cacheStorageContentUpdated
+ parameters
+ # Origin to update.
+ string origin
+ # Storage key to update.
+ string storageKey
+ # Storage bucket to update.
+ string bucketId
+ # Name of cache in origin.
+ string cacheName
+
+ # A cache has been added/deleted.
+ event cacheStorageListUpdated
+ parameters
+ # Origin to update.
+ string origin
+ # Storage key to update.
+ string storageKey
+ # Storage bucket to update.
+ string bucketId
+
+ # The origin's IndexedDB object store has been modified.
+ event indexedDBContentUpdated
+ parameters
+ # Origin to update.
+ string origin
+ # Storage key to update.
+ string storageKey
+ # Storage bucket to update.
+ string bucketId
+ # Database to update.
+ string databaseName
+ # ObjectStore to update.
+ string objectStoreName
+
+ # The origin's IndexedDB database list has been modified.
+ event indexedDBListUpdated
+ parameters
+ # Origin to update.
+ string origin
+ # Storage key to update.
+ string storageKey
+ # Storage bucket to update.
+ string bucketId
+
+ # One of the interest groups was accessed. Note that these events are global
+ # to all targets sharing an interest group store.
+ event interestGroupAccessed
+ parameters
+ Network.TimeSinceEpoch accessTime
+ InterestGroupAccessType type
+ string ownerOrigin
+ string name
+ # For topLevelBid/topLevelAdditionalBid, and when appropriate,
+ # win and additionalBidWin
+ optional string componentSellerOrigin
+ # For bid or somethingBid event, if done locally and not on a server.
+ optional number bid
+ optional string bidCurrency
+ # For non-global events --- links to interestGroupAuctionEvent
+ optional InterestGroupAuctionId uniqueAuctionId
+
+ # An auction involving interest groups is taking place. These events are
+ # target-specific.
+ event interestGroupAuctionEventOccurred
+ parameters
+ Network.TimeSinceEpoch eventTime
+ InterestGroupAuctionEventType type
+ InterestGroupAuctionId uniqueAuctionId
+ # Set for child auctions.
+ optional InterestGroupAuctionId parentAuctionId
+ # Set for started and configResolved
+ optional object auctionConfig
+
+ # Specifies which auctions a particular network fetch may be related to, and
+ # in what role. Note that it is not ordered with respect to
+ # Network.requestWillBeSent (but will happen before loadingFinished
+ # loadingFailed).
+ event interestGroupAuctionNetworkRequestCreated
+ parameters
+ InterestGroupAuctionFetchType type
+ Network.RequestId requestId
+ # This is the set of the auctions using the worklet that issued this
+ # request. In the case of trusted signals, it's possible that only some of
+ # them actually care about the keys being queried.
+ array of InterestGroupAuctionId auctions
+
+ # Shared storage was accessed by the associated page.
+ # The following parameters are included in all events.
+ event sharedStorageAccessed
+ parameters
+ # Time of the access.
+ Network.TimeSinceEpoch accessTime
+ # Enum value indicating the access scope.
+ SharedStorageAccessScope scope
+ # Enum value indicating the Shared Storage API method invoked.
+ SharedStorageAccessMethod method
+ # DevTools Frame Token for the primary frame tree's root.
+ Page.FrameId mainFrameId
+ # Serialization of the origin owning the Shared Storage data.
+ string ownerOrigin
+ # Serialization of the site owning the Shared Storage data.
+ string ownerSite
+ # The sub-parameters wrapped by `params` are all optional and their
+ # presence/absence depends on `type`.
+ SharedStorageAccessParams params
+
+ # A shared storage run or selectURL operation finished its execution.
+ # The following parameters are included in all events.
+ event sharedStorageWorkletOperationExecutionFinished
+ parameters
+ # Time that the operation finished.
+ Network.TimeSinceEpoch finishedTime
+ # Time, in microseconds, from start of shared storage JS API call until
+ # end of operation execution in the worklet.
+ integer executionTime
+ # Enum value indicating the Shared Storage API method invoked.
+ SharedStorageAccessMethod method
+ # ID of the operation call.
+ string operationId
+ # Hex representation of the DevTools token used as the TargetID for the
+ # associated shared storage worklet.
+ Target.TargetID workletTargetId
+ # DevTools Frame Token for the primary frame tree's root.
+ Page.FrameId mainFrameId
+ # Serialization of the origin owning the Shared Storage data.
+ string ownerOrigin
+
+ event storageBucketCreatedOrUpdated
+ parameters
+ StorageBucketInfo bucketInfo
+
+ event storageBucketDeleted
+ parameters
+ string bucketId
+
+ # https://wicg.github.io/attribution-reporting-api/
+ experimental command setAttributionReportingLocalTestingMode
+ parameters
+ # If enabled, noise is suppressed and reports are sent immediately.
+ boolean enabled
+
+ # Enables/disables issuing of Attribution Reporting events.
+ experimental command setAttributionReportingTracking
+ parameters
+ boolean enable
+
+ # Sends all pending Attribution Reports immediately, regardless of their
+ # scheduled report time.
+ experimental command sendPendingAttributionReports
+ returns
+ # The number of reports that were sent.
+ integer numSent
+
+ experimental type AttributionReportingSourceType extends string
+ enum
+ navigation
+ event
+
+ experimental type UnsignedInt64AsBase10 extends string
+ experimental type UnsignedInt128AsBase16 extends string
+ experimental type SignedInt64AsBase10 extends string
+
+ experimental type AttributionReportingFilterDataEntry extends object
+ properties
+ string key
+ array of string values
+
+ experimental type AttributionReportingFilterConfig extends object
+ properties
+ array of AttributionReportingFilterDataEntry filterValues
+ # duration in seconds
+ optional integer lookbackWindow
+
+ experimental type AttributionReportingFilterPair extends object
+ properties
+ array of AttributionReportingFilterConfig filters
+ array of AttributionReportingFilterConfig notFilters
+
+ experimental type AttributionReportingAggregationKeysEntry extends object
+ properties
+ string key
+ UnsignedInt128AsBase16 value
+
+ experimental type AttributionReportingEventReportWindows extends object
+ properties
+ # duration in seconds
+ integer start
+ # duration in seconds
+ array of integer ends
+
+ experimental type AttributionReportingTriggerDataMatching extends string
+ enum
+ exact
+ modulus
+
+ experimental type AttributionReportingAggregatableDebugReportingData extends object
+ properties
+ UnsignedInt128AsBase16 keyPiece
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number value
+ array of string types
+
+ experimental type AttributionReportingAggregatableDebugReportingConfig extends object
+ properties
+ # number instead of integer because not all uint32 can be represented by
+ # int, only present for source registrations
+ optional number budget
+ UnsignedInt128AsBase16 keyPiece
+ array of AttributionReportingAggregatableDebugReportingData debugData
+ optional string aggregationCoordinatorOrigin
+
+ experimental type AttributionScopesData extends object
+ properties
+ array of string values
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number limit
+ number maxEventStates
+
+ experimental type AttributionReportingNamedBudgetDef extends object
+ properties
+ string name
+ integer budget
+
+ experimental type AttributionReportingSourceRegistration extends object
+ properties
+ Network.TimeSinceEpoch time
+ # duration in seconds
+ integer expiry
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ array of number triggerData
+ AttributionReportingEventReportWindows eventReportWindows
+ # duration in seconds
+ integer aggregatableReportWindow
+ AttributionReportingSourceType type
+ string sourceOrigin
+ string reportingOrigin
+ array of string destinationSites
+ UnsignedInt64AsBase10 eventId
+ SignedInt64AsBase10 priority
+ array of AttributionReportingFilterDataEntry filterData
+ array of AttributionReportingAggregationKeysEntry aggregationKeys
+ optional UnsignedInt64AsBase10 debugKey
+ AttributionReportingTriggerDataMatching triggerDataMatching
+ SignedInt64AsBase10 destinationLimitPriority
+ AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
+ optional AttributionScopesData scopesData
+ integer maxEventLevelReports
+ array of AttributionReportingNamedBudgetDef namedBudgets
+ boolean debugReporting
+ number eventLevelEpsilon
+
+ experimental type AttributionReportingSourceRegistrationResult extends string
+ enum
+ success
+ internalError
+ insufficientSourceCapacity
+ insufficientUniqueDestinationCapacity
+ excessiveReportingOrigins
+ prohibitedByBrowserPolicy
+ successNoised
+ destinationReportingLimitReached
+ destinationGlobalLimitReached
+ destinationBothLimitsReached
+ reportingOriginsPerSiteLimitReached
+ exceedsMaxChannelCapacity
+ exceedsMaxScopesChannelCapacity
+ exceedsMaxTriggerStateCardinality
+ exceedsMaxEventStatesLimit
+ destinationPerDayReportingLimitReached
+
+ experimental event attributionReportingSourceRegistered
+ parameters
+ AttributionReportingSourceRegistration registration
+ AttributionReportingSourceRegistrationResult result
+
+ experimental type AttributionReportingSourceRegistrationTimeConfig extends string
+ enum
+ include
+ exclude
+
+ experimental type AttributionReportingAggregatableValueDictEntry extends object
+ properties
+ string key
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number value
+ UnsignedInt64AsBase10 filteringId
+
+
+ experimental type AttributionReportingAggregatableValueEntry extends object
+ properties
+ array of AttributionReportingAggregatableValueDictEntry values
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingEventTriggerData extends object
+ properties
+ UnsignedInt64AsBase10 data
+ SignedInt64AsBase10 priority
+ optional UnsignedInt64AsBase10 dedupKey
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingAggregatableTriggerData extends object
+ properties
+ UnsignedInt128AsBase16 keyPiece
+ array of string sourceKeys
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingAggregatableDedupKey extends object
+ properties
+ optional UnsignedInt64AsBase10 dedupKey
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingNamedBudgetCandidate extends object
+ properties
+ optional string name
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingTriggerRegistration extends object
+ properties
+ AttributionReportingFilterPair filters
+ optional UnsignedInt64AsBase10 debugKey
+ array of AttributionReportingAggregatableDedupKey aggregatableDedupKeys
+ array of AttributionReportingEventTriggerData eventTriggerData
+ array of AttributionReportingAggregatableTriggerData aggregatableTriggerData
+ array of AttributionReportingAggregatableValueEntry aggregatableValues
+ integer aggregatableFilteringIdMaxBytes
+ boolean debugReporting
+ optional string aggregationCoordinatorOrigin
+ AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
+ optional string triggerContextId
+ AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
+ array of string scopes
+ array of AttributionReportingNamedBudgetCandidate namedBudgets
+
+ experimental type AttributionReportingEventLevelResult extends string
+ enum
+ success
+ successDroppedLowerPriority
+ internalError
+ noCapacityForAttributionDestination
+ noMatchingSources
+ deduplicated
+ excessiveAttributions
+ priorityTooLow
+ neverAttributedSource
+ excessiveReportingOrigins
+ noMatchingSourceFilterData
+ prohibitedByBrowserPolicy
+ noMatchingConfigurations
+ excessiveReports
+ falselyAttributedSource
+ reportWindowPassed
+ notRegistered
+ reportWindowNotStarted
+ noMatchingTriggerData
+
+ experimental type AttributionReportingAggregatableResult extends string
+ enum
+ success
+ internalError
+ noCapacityForAttributionDestination
+ noMatchingSources
+ excessiveAttributions
+ excessiveReportingOrigins
+ noHistograms
+ insufficientBudget
+ insufficientNamedBudget
+ noMatchingSourceFilterData
+ notRegistered
+ prohibitedByBrowserPolicy
+ deduplicated
+ reportWindowPassed
+ excessiveReports
+
+ experimental event attributionReportingTriggerRegistered
+ parameters
+ AttributionReportingTriggerRegistration registration
+ AttributionReportingEventLevelResult eventLevel
+ AttributionReportingAggregatableResult aggregatable
+
+ experimental type AttributionReportingReportResult extends string
+ enum
+ # A network request was attempted for the report.
+ sent
+ # No request was attempted because of browser policy.
+ prohibited
+ # No request was attempted because of an error in report assembly,
+ # e.g. the aggregation service was unavailable.
+ failedToAssemble
+ # No request was attempted because the report's expiry passed.
+ expired
+
+ experimental event attributionReportingReportSent
+ parameters
+ string url
+ object body
+ AttributionReportingReportResult result
+ # If result is `sent`, populated with net/HTTP status.
+ optional integer netError
+ optional string netErrorName
+ optional integer httpStatusCode
+
+ experimental event attributionReportingVerboseDebugReportSent
+ parameters
+ string url
+ optional array of object body
+ optional integer netError
+ optional string netErrorName
+ optional integer httpStatusCode
+
+ # A single Related Website Set object.
+ experimental type RelatedWebsiteSet extends object
+ properties
+ # The primary site of this set, along with the ccTLDs if there is any.
+ array of string primarySites
+ # The associated sites of this set, along with the ccTLDs if there is any.
+ array of string associatedSites
+ # The service sites of this set, along with the ccTLDs if there is any.
+ array of string serviceSites
+
+ # Returns the effective Related Website Sets in use by this profile for the browser
+ # session. The effective Related Website Sets will not change during a browser session.
+ experimental command getRelatedWebsiteSets
+ returns
+ array of RelatedWebsiteSet sets
+
+ # Returns the list of URLs from a page and its embedded resources that match
+ # existing grace period URL pattern rules.
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
+ experimental command getAffectedUrlsForThirdPartyCookieMetadata
+ parameters
+ # The URL of the page currently being visited.
+ string firstPartyUrl
+ # The list of embedded resource URLs from the page.
+ array of string thirdPartyUrls
+
+ returns
+ # Array of matching URLs. If there is a primary pattern match for the first-
+ # party URL, only the first-party URL is returned in the array.
+ array of string matchedUrls
+
+ command setProtectedAudienceKAnonymity
+ parameters
+ string owner
+ string name
+ array of binary hashes
diff --git a/pdl/domains/SystemInfo.pdl b/pdl/domains/SystemInfo.pdl
new file mode 100644
index 00000000..2ff9c252
--- /dev/null
+++ b/pdl/domains/SystemInfo.pdl
@@ -0,0 +1,145 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# The SystemInfo domain defines methods and events for querying low-level system information.
+experimental domain SystemInfo
+
+ # Describes a single graphics processor (GPU).
+ type GPUDevice extends object
+ properties
+ # PCI ID of the GPU vendor, if available; 0 otherwise.
+ number vendorId
+ # PCI ID of the GPU device, if available; 0 otherwise.
+ number deviceId
+ # Sub sys ID of the GPU, only available on Windows.
+ optional number subSysId
+ # Revision of the GPU, only available on Windows.
+ optional number revision
+ # String description of the GPU vendor, if the PCI ID is not available.
+ string vendorString
+ # String description of the GPU device, if the PCI ID is not available.
+ string deviceString
+ # String description of the GPU driver vendor.
+ string driverVendor
+ # String description of the GPU driver version.
+ string driverVersion
+
+ # Describes the width and height dimensions of an entity.
+ type Size extends object
+ properties
+ # Width in pixels.
+ integer width
+ # Height in pixels.
+ integer height
+
+ # Describes a supported video decoding profile with its associated minimum and
+ # maximum resolutions.
+ type VideoDecodeAcceleratorCapability extends object
+ properties
+ # Video codec profile that is supported, e.g. VP9 Profile 2.
+ string profile
+ # Maximum video dimensions in pixels supported for this |profile|.
+ Size maxResolution
+ # Minimum video dimensions in pixels supported for this |profile|.
+ Size minResolution
+
+ # Describes a supported video encoding profile with its associated maximum
+ # resolution and maximum framerate.
+ type VideoEncodeAcceleratorCapability extends object
+ properties
+ # Video codec profile that is supported, e.g H264 Main.
+ string profile
+ # Maximum video dimensions in pixels supported for this |profile|.
+ Size maxResolution
+ # Maximum encoding framerate in frames per second supported for this
+ # |profile|, as fraction's numerator and denominator, e.g. 24/1 fps,
+ # 24000/1001 fps, etc.
+ integer maxFramerateNumerator
+ integer maxFramerateDenominator
+
+ # YUV subsampling type of the pixels of a given image.
+ type SubsamplingFormat extends string
+ enum
+ yuv420
+ yuv422
+ yuv444
+
+ # Image format of a given image.
+ type ImageType extends string
+ enum
+ jpeg
+ webp
+ unknown
+
+ # Describes a supported image decoding profile with its associated minimum and
+ # maximum resolutions and subsampling.
+ type ImageDecodeAcceleratorCapability extends object
+ properties
+ # Image coded, e.g. Jpeg.
+ ImageType imageType
+ # Maximum supported dimensions of the image in pixels.
+ Size maxDimensions
+ # Minimum supported dimensions of the image in pixels.
+ Size minDimensions
+ # Optional array of supported subsampling formats, e.g. 4:2:0, if known.
+ array of SubsamplingFormat subsamplings
+
+ # Provides information about the GPU(s) on the system.
+ type GPUInfo extends object
+ properties
+ # The graphics devices on the system. Element 0 is the primary GPU.
+ array of GPUDevice devices
+ # An optional dictionary of additional GPU related attributes.
+ optional object auxAttributes
+ # An optional dictionary of graphics features and their status.
+ optional object featureStatus
+ # An optional array of GPU driver bug workarounds.
+ array of string driverBugWorkarounds
+ # Supported accelerated video decoding capabilities.
+ array of VideoDecodeAcceleratorCapability videoDecoding
+ # Supported accelerated video encoding capabilities.
+ array of VideoEncodeAcceleratorCapability videoEncoding
+ # Supported accelerated image decoding capabilities.
+ array of ImageDecodeAcceleratorCapability imageDecoding
+
+ # Represents process info.
+ type ProcessInfo extends object
+ properties
+ # Specifies process type.
+ string type
+ # Specifies process id.
+ integer id
+ # Specifies cumulative CPU usage in seconds across all threads of the
+ # process since the process start.
+ number cpuTime
+
+ # Returns information about the system.
+ command getInfo
+ returns
+ # Information about the GPUs on the system.
+ GPUInfo gpu
+ # A platform-dependent description of the model of the machine. On Mac OS, this is, for
+ # example, 'MacBookPro'. Will be the empty string if not supported.
+ string modelName
+ # A platform-dependent description of the version of the machine. On Mac OS, this is, for
+ # example, '10.1'. Will be the empty string if not supported.
+ string modelVersion
+ # The command line string used to launch the browser. Will be the empty string if not
+ # supported.
+ string commandLine
+
+ # Returns information about the feature state.
+ command getFeatureState
+ parameters
+ string featureState
+ returns
+ boolean featureEnabled
+
+ # Returns information about all running processes.
+ command getProcessInfo
+ returns
+ # An array of process info blocks.
+ array of ProcessInfo processInfo
diff --git a/pdl/domains/Target.pdl b/pdl/domains/Target.pdl
new file mode 100644
index 00000000..92d271b2
--- /dev/null
+++ b/pdl/domains/Target.pdl
@@ -0,0 +1,325 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# Supports additional targets discovery and allows to attach to them.
+domain Target
+
+ type TargetID extends string
+
+ # Unique identifier of attached debugging session.
+ type SessionID extends string
+
+ type TargetInfo extends object
+ properties
+ TargetID targetId
+ # List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22
+ string type
+ string title
+ string url
+ # Whether the target has an attached client.
+ boolean attached
+ # Opener target Id
+ optional TargetID openerId
+ # Whether the target has access to the originating window.
+ experimental boolean canAccessOpener
+ # Frame id of originating window (is only set if target has an opener).
+ experimental optional Page.FrameId openerFrameId
+ experimental optional Browser.BrowserContextID browserContextId
+ # Provides additional details for specific target types. For example, for
+ # the type of "page", this may be set to "prerender".
+ experimental optional string subtype
+
+ # A filter used by target query/discovery/auto-attach operations.
+ experimental type FilterEntry extends object
+ properties
+ # If set, causes exclusion of matching targets from the list.
+ optional boolean exclude
+ # If not present, matches any type.
+ optional string type
+
+ # The entries in TargetFilter are matched sequentially against targets and
+ # the first entry that matches determines if the target is included or not,
+ # depending on the value of `exclude` field in the entry.
+ # If filter is not specified, the one assumed is
+ # [{type: "browser", exclude: true}, {type: "tab", exclude: true}, {}]
+ # (i.e. include everything but `browser` and `tab`).
+ experimental type TargetFilter extends array of FilterEntry
+
+ experimental type RemoteLocation extends object
+ properties
+ string host
+ integer port
+
+ # The state of the target window.
+ experimental type WindowState extends string
+ enum
+ normal
+ minimized
+ maximized
+ fullscreen
+
+ # Activates (focuses) the target.
+ command activateTarget
+ parameters
+ TargetID targetId
+
+ # Attaches to the target with given id.
+ command attachToTarget
+ parameters
+ TargetID targetId
+ # Enables "flat" access to the session via specifying sessionId attribute in the commands.
+ # We plan to make this the default, deprecate non-flattened mode,
+ # and eventually retire it. See crbug.com/991325.
+ optional boolean flatten
+ returns
+ # Id assigned to the session.
+ SessionID sessionId
+
+ # Attaches to the browser target, only uses flat sessionId mode.
+ experimental command attachToBrowserTarget
+ returns
+ # Id assigned to the session.
+ SessionID sessionId
+
+ # Closes the target. If the target is a page that gets closed too.
+ command closeTarget
+ parameters
+ TargetID targetId
+ returns
+ # Always set to true. If an error occurs, the response indicates protocol error.
+ deprecated boolean success
+
+ # Inject object to the target's main frame that provides a communication
+ # channel with browser target.
+ #
+ # Injected object will be available as `window[bindingName]`.
+ #
+ # The object has the following API:
+ # - `binding.send(json)` - a method to send messages over the remote debugging protocol
+ # - `binding.onmessage = json => handleMessage(json)` - a callback that will be called for the protocol notifications and command responses.
+ experimental command exposeDevToolsProtocol
+ parameters
+ TargetID targetId
+ # Binding name, 'cdp' if not specified.
+ optional string bindingName
+ # If true, inherits the current root session's permissions (default: false).
+ optional boolean inheritPermissions
+
+ # Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
+ # one.
+ command createBrowserContext
+ parameters
+ # If specified, disposes this context when debugging session disconnects.
+ experimental optional boolean disposeOnDetach
+ # Proxy server, similar to the one passed to --proxy-server
+ experimental optional string proxyServer
+ # Proxy bypass list, similar to the one passed to --proxy-bypass-list
+ experimental optional string proxyBypassList
+ # An optional list of origins to grant unlimited cross-origin access to.
+ # Parts of the URL other than those constituting origin are ignored.
+ experimental optional array of string originsWithUniversalNetworkAccess
+ returns
+ # The id of the context created.
+ Browser.BrowserContextID browserContextId
+
+ # Returns all browser contexts created with `Target.createBrowserContext` method.
+ command getBrowserContexts
+ returns
+ # An array of browser context ids.
+ array of Browser.BrowserContextID browserContextIds
+
+ # Creates a new page.
+ command createTarget
+ parameters
+ # The initial URL the page will be navigated to. An empty string indicates about:blank.
+ string url
+ # Frame left origin in DIP (requires newWindow to be true or headless shell).
+ experimental optional integer left
+ # Frame top origin in DIP (requires newWindow to be true or headless shell).
+ experimental optional integer top
+ # Frame width in DIP (requires newWindow to be true or headless shell).
+ optional integer width
+ # Frame height in DIP (requires newWindow to be true or headless shell).
+ optional integer height
+ # Frame window state (requires newWindow to be true or headless shell).
+ # Default is normal.
+ optional WindowState windowState
+ # The browser context to create the page in.
+ experimental optional Browser.BrowserContextID browserContextId
+ # Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
+ # not supported on MacOS yet, false by default).
+ experimental optional boolean enableBeginFrameControl
+ # Whether to create a new Window or Tab (false by default, not supported by headless shell).
+ optional boolean newWindow
+ # Whether to create the target in background or foreground (false by default, not supported
+ # by headless shell).
+ optional boolean background
+ # Whether to create the target of type "tab".
+ experimental optional boolean forTab
+ # Whether to create a hidden target. The hidden target is observable via protocol, but not
+ # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
+ # `background: false`. The life-time of the tab is limited to the life-time of the session.
+ experimental optional boolean hidden
+ returns
+ # The id of the page opened.
+ TargetID targetId
+
+ # Detaches session with given id.
+ command detachFromTarget
+ parameters
+ # Session to detach.
+ optional SessionID sessionId
+ # Deprecated.
+ deprecated optional TargetID targetId
+
+ # Deletes a BrowserContext. All the belonging pages will be closed without calling their
+ # beforeunload hooks.
+ command disposeBrowserContext
+ parameters
+ Browser.BrowserContextID browserContextId
+
+ # Returns information about a target.
+ experimental command getTargetInfo
+ parameters
+ optional TargetID targetId
+ returns
+ TargetInfo targetInfo
+
+ # Retrieves a list of available targets.
+ command getTargets
+ parameters
+ # Only targets matching filter will be reported. If filter is not specified
+ # and target discovery is currently enabled, a filter used for target discovery
+ # is used for consistency.
+ experimental optional TargetFilter filter
+ returns
+ # The list of targets.
+ array of TargetInfo targetInfos
+
+ # Sends protocol message over session with given id.
+ # Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
+ # and crbug.com/991325.
+ deprecated command sendMessageToTarget
+ parameters
+ string message
+ # Identifier of the session.
+ optional SessionID sessionId
+ # Deprecated.
+ deprecated optional TargetID targetId
+
+ # Controls whether to automatically attach to new targets which are considered
+ # to be directly related to this one (for example, iframes or workers).
+ # When turned on, attaches to all existing related targets as well. When turned off,
+ # automatically detaches from all currently attached targets.
+ # This also clears all targets added by `autoAttachRelated` from the list of targets to watch
+ # for creation of related targets.
+ # You might want to call this recursively for auto-attached targets to attach
+ # to all available targets.
+ command setAutoAttach
+ parameters
+ # Whether to auto-attach to related targets.
+ boolean autoAttach
+ # Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
+ # to run paused targets.
+ boolean waitForDebuggerOnStart
+ # Enables "flat" access to the session via specifying sessionId attribute in the commands.
+ # We plan to make this the default, deprecate non-flattened mode,
+ # and eventually retire it. See crbug.com/991325.
+ experimental optional boolean flatten
+ # Only targets matching filter will be attached.
+ experimental optional TargetFilter filter
+
+ # Adds the specified target to the list of targets that will be monitored for any related target
+ # creation (such as child frames, child workers and new versions of service worker) and reported
+ # through `attachedToTarget`. The specified target is also auto-attached.
+ # This cancels the effect of any previous `setAutoAttach` and is also cancelled by subsequent
+ # `setAutoAttach`. Only available at the Browser target.
+ experimental command autoAttachRelated
+ parameters
+ TargetID targetId
+ # Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
+ # to run paused targets.
+ boolean waitForDebuggerOnStart
+ # Only targets matching filter will be attached.
+ experimental optional TargetFilter filter
+
+ # Controls whether to discover available targets and notify via
+ # `targetCreated/targetInfoChanged/targetDestroyed` events.
+ command setDiscoverTargets
+ parameters
+ # Whether to discover available targets.
+ boolean discover
+ # Only targets matching filter will be attached. If `discover` is false,
+ # `filter` must be omitted or empty.
+ experimental optional TargetFilter filter
+
+ # Enables target discovery for the specified locations, when `setDiscoverTargets` was set to
+ # `true`.
+ experimental command setRemoteLocations
+ parameters
+ # List of remote locations.
+ array of RemoteLocation locations
+
+ # Issued when attached to target because of auto-attach or `attachToTarget` command.
+ experimental event attachedToTarget
+ parameters
+ # Identifier assigned to the session used to send/receive messages.
+ SessionID sessionId
+ TargetInfo targetInfo
+ boolean waitingForDebugger
+
+ # 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.
+ experimental event detachedFromTarget
+ parameters
+ # Detached session identifier.
+ SessionID sessionId
+ # Deprecated.
+ deprecated optional TargetID targetId
+
+ # Notifies about a new protocol message received from the session (as reported in
+ # `attachedToTarget` event).
+ event receivedMessageFromTarget
+ parameters
+ # Identifier of a session which sends a message.
+ SessionID sessionId
+ string message
+ # Deprecated.
+ deprecated optional TargetID targetId
+
+ # Issued when a possible inspection target is created.
+ event targetCreated
+ parameters
+ TargetInfo targetInfo
+
+ # Issued when a target is destroyed.
+ event targetDestroyed
+ parameters
+ TargetID targetId
+
+ # Issued when a target has crashed.
+ event targetCrashed
+ parameters
+ TargetID targetId
+ # Termination status type.
+ string status
+ # Termination error code.
+ integer errorCode
+
+ # Issued when some information about a target has changed. This only happens between
+ # `targetCreated` and `targetDestroyed`.
+ event targetInfoChanged
+ parameters
+ TargetInfo targetInfo
+
+ # Opens a DevTools window for the target.
+ experimental command openDevTools
+ parameters
+ # This can be the page or tab target ID.
+ TargetID targetId
+ returns
+ # The targetId of DevTools page target.
+ TargetID targetId
diff --git a/pdl/domains/Tethering.pdl b/pdl/domains/Tethering.pdl
new file mode 100644
index 00000000..1b49b1cb
--- /dev/null
+++ b/pdl/domains/Tethering.pdl
@@ -0,0 +1,28 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# The Tethering domain defines methods and events for browser port binding.
+experimental domain Tethering
+
+ # Request browser port binding.
+ command bind
+ parameters
+ # Port number to bind.
+ integer port
+
+ # Request browser port unbinding.
+ command unbind
+ parameters
+ # Port number to unbind.
+ integer port
+
+ # Informs that port was successfully bound and got a specified connection id.
+ event accepted
+ parameters
+ # Port number that was successfully bound.
+ integer port
+ # Connection id to be used.
+ string connectionId
diff --git a/pdl/domains/Tracing.pdl b/pdl/domains/Tracing.pdl
new file mode 100644
index 00000000..44fc3f39
--- /dev/null
+++ b/pdl/domains/Tracing.pdl
@@ -0,0 +1,157 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+domain Tracing
+ depends on IO
+
+ # Configuration for memory dump. Used only when "memory-infra" category is enabled.
+ experimental type MemoryDumpConfig extends object
+
+ type TraceConfig extends object
+ properties
+ # Controls how the trace buffer stores data. The default is `recordUntilFull`.
+ experimental optional enum recordMode
+ recordUntilFull
+ recordContinuously
+ recordAsMuchAsPossible
+ echoToConsole
+ # Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value
+ # of 200 MB would be used.
+ experimental optional number traceBufferSizeInKb
+ # Turns on JavaScript stack sampling.
+ experimental optional boolean enableSampling
+ # Turns on system tracing.
+ experimental optional boolean enableSystrace
+ # Turns on argument filter.
+ experimental optional boolean enableArgumentFilter
+ # Included category filters.
+ optional array of string includedCategories
+ # Excluded category filters.
+ optional array of string excludedCategories
+ # Configuration to synthesize the delays in tracing.
+ experimental optional array of string syntheticDelays
+ # Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
+ experimental optional MemoryDumpConfig memoryDumpConfig
+
+ # Data format of a trace. Can be either the legacy JSON format or the
+ # protocol buffer format. Note that the JSON format will be deprecated soon.
+ experimental type StreamFormat extends string
+ enum
+ json
+ proto
+
+ # Compression type to use for traces returned via streams.
+ experimental type StreamCompression extends string
+ enum
+ none
+ gzip
+
+ # Details exposed when memory request explicitly declared.
+ # Keep consistent with memory_dump_request_args.h and
+ # memory_instrumentation.mojom
+ experimental type MemoryDumpLevelOfDetail extends string
+ enum
+ background
+ light
+ detailed
+
+ # Backend type to use for tracing. `chrome` uses the Chrome-integrated
+ # tracing service and is supported on all platforms. `system` is only
+ # supported on Chrome OS and uses the Perfetto system tracing service.
+ # `auto` chooses `system` when the perfettoConfig provided to Tracing.start
+ # specifies at least one non-Chrome data source; otherwise uses `chrome`.
+ experimental type TracingBackend extends string
+ enum
+ auto
+ chrome
+ system
+
+ # Stop trace events collection.
+ command end
+
+ # Gets supported tracing categories.
+ experimental command getCategories
+ returns
+ # A list of supported tracing categories.
+ array of string categories
+
+ # Record a clock sync marker in the trace.
+ experimental command recordClockSyncMarker
+ parameters
+ # The ID of this clock sync marker
+ string syncId
+
+ # Request a global memory dump.
+ experimental command requestMemoryDump
+ parameters
+ # Enables more deterministic results by forcing garbage collection
+ optional boolean deterministic
+ # Specifies level of details in memory dump. Defaults to "detailed".
+ optional MemoryDumpLevelOfDetail levelOfDetail
+ returns
+ # GUID of the resulting global memory dump.
+ string dumpGuid
+ # True iff the global memory dump succeeded.
+ boolean success
+
+ # Start trace events collection.
+ command start
+ parameters
+ # Category/tag filter
+ experimental deprecated optional string categories
+ # Tracing options
+ experimental deprecated optional string options
+ # If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
+ experimental optional number bufferUsageReportingInterval
+ # Whether to report trace events as series of dataCollected events or to save trace to a
+ # stream (defaults to `ReportEvents`).
+ optional enum transferMode
+ ReportEvents
+ ReturnAsStream
+ # Trace data format to use. This only applies when using `ReturnAsStream`
+ # transfer mode (defaults to `json`).
+ optional StreamFormat streamFormat
+ # Compression format to use. This only applies when using `ReturnAsStream`
+ # transfer mode (defaults to `none`)
+ experimental optional StreamCompression streamCompression
+ optional TraceConfig traceConfig
+ # Base64-encoded serialized perfetto.protos.TraceConfig protobuf message
+ # When specified, the parameters `categories`, `options`, `traceConfig`
+ # are ignored.
+ experimental optional binary perfettoConfig
+ # Backend type (defaults to `auto`)
+ experimental optional TracingBackend tracingBackend
+
+ experimental event bufferUsage
+ parameters
+ # A number in range [0..1] that indicates the used size of event buffer as a fraction of its
+ # total size.
+ optional number percentFull
+ # An approximate number of events in the trace log.
+ optional number eventCount
+ # A number in range [0..1] that indicates the used size of event buffer as a fraction of its
+ # total size.
+ optional number value
+
+ # Contains a bucket of collected trace events. When tracing is stopped collected events will be
+ # sent as a sequence of dataCollected events followed by tracingComplete event.
+ experimental event dataCollected
+ parameters
+ array of object value
+
+ # Signals that tracing is stopped and there is no trace buffers pending flush, all data were
+ # delivered via dataCollected events.
+ event tracingComplete
+ parameters
+ # Indicates whether some trace data is known to have been lost, e.g. because the trace ring
+ # buffer wrapped around.
+ boolean dataLossOccurred
+ # A handle of the stream that holds resulting trace data.
+ optional IO.StreamHandle stream
+ # Trace data format of returned stream.
+ optional StreamFormat traceFormat
+ # Compression format of returned stream.
+ optional StreamCompression streamCompression
diff --git a/pdl/domains/WebAudio.pdl b/pdl/domains/WebAudio.pdl
new file mode 100644
index 00000000..5df199dd
--- /dev/null
+++ b/pdl/domains/WebAudio.pdl
@@ -0,0 +1,205 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows inspection of Web Audio API.
+# https://webaudio.github.io/web-audio-api/
+experimental domain WebAudio
+
+ # An unique ID for a graph object (AudioContext, AudioNode, AudioParam) in Web Audio API
+ type GraphObjectId extends string
+
+ # Enum of BaseAudioContext types
+ type ContextType extends string
+ enum
+ realtime
+ offline
+
+ # Enum of AudioContextState from the spec
+ type ContextState extends string
+ enum
+ suspended
+ running
+ closed
+ interrupted
+
+ # Enum of AudioNode types
+ type NodeType extends string
+
+ # Enum of AudioNode::ChannelCountMode from the spec
+ type ChannelCountMode extends string
+ enum
+ clamped-max
+ explicit
+ max
+
+ # Enum of AudioNode::ChannelInterpretation from the spec
+ type ChannelInterpretation extends string
+ enum
+ discrete
+ speakers
+
+ # Enum of AudioParam types
+ type ParamType extends string
+
+ # Enum of AudioParam::AutomationRate from the spec
+ type AutomationRate extends string
+ enum
+ a-rate
+ k-rate
+
+ # Fields in AudioContext that change in real-time.
+ type ContextRealtimeData extends object
+ properties
+ # The current context time in second in BaseAudioContext.
+ number currentTime
+ # The time spent on rendering graph divided by render quantum duration,
+ # and multiplied by 100. 100 means the audio renderer reached the full
+ # capacity and glitch may occur.
+ number renderCapacity
+ # A running mean of callback interval.
+ number callbackIntervalMean
+ # A running variance of callback interval.
+ number callbackIntervalVariance
+
+ # Protocol object for BaseAudioContext
+ type BaseAudioContext extends object
+ properties
+ GraphObjectId contextId
+ ContextType contextType
+ ContextState contextState
+ optional ContextRealtimeData realtimeData
+ # Platform-dependent callback buffer size.
+ number callbackBufferSize
+ # Number of output channels supported by audio hardware in use.
+ number maxOutputChannelCount
+ # Context sample rate.
+ number sampleRate
+
+# Protocol object for AudioListener
+ type AudioListener extends object
+ properties
+ GraphObjectId listenerId
+ GraphObjectId contextId
+
+ # Protocol object for AudioNode
+ type AudioNode extends object
+ properties
+ GraphObjectId nodeId
+ GraphObjectId contextId
+ NodeType nodeType
+ number numberOfInputs
+ number numberOfOutputs
+ number channelCount
+ ChannelCountMode channelCountMode
+ ChannelInterpretation channelInterpretation
+
+ # Protocol object for AudioParam
+ type AudioParam extends object
+ properties
+ GraphObjectId paramId
+ GraphObjectId nodeId
+ GraphObjectId contextId
+ ParamType paramType
+ AutomationRate rate
+ number defaultValue
+ number minValue
+ number maxValue
+
+ # Enables the WebAudio domain and starts sending context lifetime events.
+ command enable
+
+ # Disables the WebAudio domain.
+ command disable
+
+ # Fetch the realtime data from the registered contexts.
+ command getRealtimeData
+ parameters
+ GraphObjectId contextId
+ returns
+ ContextRealtimeData realtimeData
+
+ # Notifies that a new BaseAudioContext has been created.
+ event contextCreated
+ parameters
+ BaseAudioContext context
+
+ # Notifies that an existing BaseAudioContext will be destroyed.
+ event contextWillBeDestroyed
+ parameters
+ GraphObjectId contextId
+
+ # Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
+ event contextChanged
+ parameters
+ BaseAudioContext context
+
+# Notifies that the construction of an AudioListener has finished.
+ event audioListenerCreated
+ parameters
+ AudioListener listener
+
+ # Notifies that a new AudioListener has been created.
+ event audioListenerWillBeDestroyed
+ parameters
+ GraphObjectId contextId
+ GraphObjectId listenerId
+
+ # Notifies that a new AudioNode has been created.
+ event audioNodeCreated
+ parameters
+ AudioNode node
+
+ # Notifies that an existing AudioNode has been destroyed.
+ event audioNodeWillBeDestroyed
+ parameters
+ GraphObjectId contextId
+ GraphObjectId nodeId
+
+ # Notifies that a new AudioParam has been created.
+ event audioParamCreated
+ parameters
+ AudioParam param
+
+ # Notifies that an existing AudioParam has been destroyed.
+ event audioParamWillBeDestroyed
+ parameters
+ GraphObjectId contextId
+ GraphObjectId nodeId
+ GraphObjectId paramId
+
+ # Notifies that two AudioNodes are connected.
+ event nodesConnected
+ parameters
+ GraphObjectId contextId
+ GraphObjectId sourceId
+ GraphObjectId destinationId
+ optional number sourceOutputIndex
+ optional number destinationInputIndex
+
+ # Notifies that AudioNodes are disconnected. The destination can be null, and it means all the outgoing connections from the source are disconnected.
+ event nodesDisconnected
+ parameters
+ GraphObjectId contextId
+ GraphObjectId sourceId
+ GraphObjectId destinationId
+ optional number sourceOutputIndex
+ optional number destinationInputIndex
+
+ # Notifies that an AudioNode is connected to an AudioParam.
+ event nodeParamConnected
+ parameters
+ GraphObjectId contextId
+ GraphObjectId sourceId
+ GraphObjectId destinationId
+ optional number sourceOutputIndex
+
+ # Notifies that an AudioNode is disconnected to an AudioParam.
+ event nodeParamDisconnected
+ parameters
+ GraphObjectId contextId
+ GraphObjectId sourceId
+ GraphObjectId destinationId
+ optional number sourceOutputIndex
diff --git a/pdl/domains/WebAuthn.pdl b/pdl/domains/WebAuthn.pdl
new file mode 100644
index 00000000..0ef007ce
--- /dev/null
+++ b/pdl/domains/WebAuthn.pdl
@@ -0,0 +1,230 @@
+# Copyright 2017 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+#
+# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
+
+# This domain allows configuring virtual authenticators to test the WebAuthn
+# API.
+experimental domain WebAuthn
+ type AuthenticatorId extends string
+
+ type AuthenticatorProtocol extends string
+ enum
+ # Universal 2nd Factor.
+ u2f
+ # Client To Authenticator Protocol 2.
+ ctap2
+
+ type Ctap2Version extends string
+ enum
+ ctap2_0
+ ctap2_1
+
+ type AuthenticatorTransport extends string
+ enum
+ # Cross-Platform authenticator attachments:
+ usb
+ nfc
+ ble
+ cable
+ # Platform authenticator attachment:
+ internal
+
+ type VirtualAuthenticatorOptions extends object
+ properties
+ AuthenticatorProtocol protocol
+ # Defaults to ctap2_0. Ignored if |protocol| == u2f.
+ optional Ctap2Version ctap2Version
+ AuthenticatorTransport transport
+ # Defaults to false.
+ optional boolean hasResidentKey
+ # Defaults to false.
+ optional boolean hasUserVerification
+ # If set to true, the authenticator will support the largeBlob extension.
+ # https://w3c.github.io/webauthn#largeBlob
+ # Defaults to false.
+ optional boolean hasLargeBlob
+ # If set to true, the authenticator will support the credBlob extension.
+ # https://fidoalliance.org/specs/fido-v2.1-rd-20201208/fido-client-to-authenticator-protocol-v2.1-rd-20201208.html#sctn-credBlob-extension
+ # Defaults to false.
+ optional boolean hasCredBlob
+ # If set to true, the authenticator will support the minPinLength extension.
+ # https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-20210615.html#sctn-minpinlength-extension
+ # Defaults to false.
+ optional boolean hasMinPinLength
+ # If set to true, the authenticator will support the prf extension.
+ # https://w3c.github.io/webauthn/#prf-extension
+ # Defaults to false.
+ optional boolean hasPrf
+ # If set to true, tests of user presence will succeed immediately.
+ # Otherwise, they will not be resolved. Defaults to true.
+ optional boolean automaticPresenceSimulation
+ # Sets whether User Verification succeeds or fails for an authenticator.
+ # Defaults to false.
+ optional boolean isUserVerified
+ # Credentials created by this authenticator will have the backup
+ # eligibility (BE) flag set to this value. Defaults to false.
+ # https://w3c.github.io/webauthn/#sctn-credential-backup
+ optional boolean defaultBackupEligibility
+ # Credentials created by this authenticator will have the backup state
+ # (BS) flag set to this value. Defaults to false.
+ # https://w3c.github.io/webauthn/#sctn-credential-backup
+ optional boolean defaultBackupState
+
+ type Credential extends object
+ properties
+ binary credentialId
+ boolean isResidentCredential
+ # Relying Party ID the credential is scoped to. Must be set when adding a
+ # credential.
+ optional string rpId
+ # The ECDSA P-256 private key in PKCS#8 format.
+ binary privateKey
+ # An opaque byte sequence with a maximum size of 64 bytes mapping the
+ # credential to a specific user.
+ optional binary userHandle
+ # Signature counter. This is incremented by one for each successful
+ # assertion.
+ # See https://w3c.github.io/webauthn/#signature-counter
+ integer signCount
+ # The large blob associated with the credential.
+ # See https://w3c.github.io/webauthn/#sctn-large-blob-extension
+ optional binary largeBlob
+ # Assertions returned by this credential will have the backup eligibility
+ # (BE) flag set to this value. Defaults to the authenticator's
+ # defaultBackupEligibility value.
+ optional boolean backupEligibility
+ # Assertions returned by this credential will have the backup state (BS)
+ # flag set to this value. Defaults to the authenticator's
+ # defaultBackupState value.
+ optional boolean backupState
+ # The credential's user.name property. Equivalent to empty if not set.
+ # https://w3c.github.io/webauthn/#dom-publickeycredentialentity-name
+ optional string userName
+ # The credential's user.displayName property. Equivalent to empty if
+ # not set.
+ # https://w3c.github.io/webauthn/#dom-publickeycredentialuserentity-displayname
+ optional string userDisplayName
+
+ # Enable the WebAuthn domain and start intercepting credential storage and
+ # retrieval with a virtual authenticator.
+ command enable
+ parameters
+ # Whether to enable the WebAuthn user interface. Enabling the UI is
+ # recommended for debugging and demo purposes, as it is closer to the real
+ # experience. Disabling the UI is recommended for automated testing.
+ # Supported at the embedder's discretion if UI is available.
+ # Defaults to false.
+ optional boolean enableUI
+
+ # Disable the WebAuthn domain.
+ command disable
+
+ # Creates and adds a virtual authenticator.
+ command addVirtualAuthenticator
+ parameters
+ VirtualAuthenticatorOptions options
+ returns
+ AuthenticatorId authenticatorId
+
+ # Resets parameters isBogusSignature, isBadUV, isBadUP to false if they are not present.
+ command setResponseOverrideBits
+ parameters
+ AuthenticatorId authenticatorId
+ # If isBogusSignature is set, overrides the signature in the authenticator response to be zero.
+ # Defaults to false.
+ optional boolean isBogusSignature
+ # If isBadUV is set, overrides the UV bit in the flags in the authenticator response to
+ # be zero. Defaults to false.
+ optional boolean isBadUV
+ # If isBadUP is set, overrides the UP bit in the flags in the authenticator response to
+ # be zero. Defaults to false.
+ optional boolean isBadUP
+
+ # Removes the given authenticator.
+ command removeVirtualAuthenticator
+ parameters
+ AuthenticatorId authenticatorId
+
+ # Adds the credential to the specified authenticator.
+ command addCredential
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
+ # Returns a single credential stored in the given virtual authenticator that
+ # matches the credential ID.
+ command getCredential
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+ returns
+ Credential credential
+
+ # Returns all the credentials stored in the given virtual authenticator.
+ command getCredentials
+ parameters
+ AuthenticatorId authenticatorId
+ returns
+ array of Credential credentials
+
+ # Removes a credential from the authenticator.
+ command removeCredential
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+
+ # Clears all the credentials from the specified device.
+ command clearCredentials
+ parameters
+ AuthenticatorId authenticatorId
+
+ # Sets whether User Verification succeeds or fails for an authenticator.
+ # The default is true.
+ command setUserVerified
+ parameters
+ AuthenticatorId authenticatorId
+ boolean isUserVerified
+
+ # Sets whether tests of user presence will succeed immediately (if true) or fail to resolve (if false) for an authenticator.
+ # The default is true.
+ command setAutomaticPresenceSimulation
+ parameters
+ AuthenticatorId authenticatorId
+ boolean enabled
+
+ # Allows setting credential properties.
+ # https://w3c.github.io/webauthn/#sctn-automation-set-credential-properties
+ command setCredentialProperties
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+ optional boolean backupEligibility
+ optional boolean backupState
+
+ # Triggered when a credential is added to an authenticator.
+ event credentialAdded
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
+ # Triggered when a credential is deleted, e.g. through
+ # PublicKeyCredential.signalUnknownCredential().
+ event credentialDeleted
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+
+ # Triggered when a credential is updated, e.g. through
+ # PublicKeyCredential.signalCurrentUserDetails().
+ event credentialUpdated
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
+ # Triggered when a credential is used in a webauthn assertion.
+ event credentialAsserted
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
Roll protocol to r1498597 — 2025-08-08T04:34:59.000Z
@@ browser_protocol.pdl:2496 @@ experimental domain CSS
# resolved even then, return the provided value without any changes.
experimental command resolveValues
parameters
- # Substitution functions (var()/env()/attr()) and cascade-dependent
- # keywords (revert/revert-layer) do not work.
+ # Cascade-dependent keywords (revert/revert-layer) do not work.
array of string values
# Id of the node in whose context the expression is evaluated
DOM.NodeId nodeId
@@ -8690,6 +8689,7 @@ domain Page
deferred-fetch
deferred-fetch-minimal
device-attributes
+ digital-credentials-create
digital-credentials-get
direct-sockets
direct-sockets-private
Roll protocol to r1498010 — 2025-08-07T04:35:01.000Z
@@ browser_protocol.pdl:1096 @@ experimental domain Audits
enum
BlockedFrameNavigation
BlockedSubresource
+ NoisedCanvasReadback
# This issue warns about uses of APIs that may be considered misuse to
# re-identify users.
@@ -1104,6 +1105,8 @@ experimental domain Audits
UserReidentificationIssueType type
# Applies to BlockedFrameNavigation and BlockedSubresource issue types.
optional AffectedRequest request
+ # Applies to NoisedCanvasReadback issue type.
+ optional SourceCodeLocation sourceCodeLocation
# A unique identifier for the type of issue. Each type may use one of the
# optional fields in InspectorIssueDetails to convey more specific
@@ -3016,6 +3019,7 @@ domain DOM
before
after
picker-icon
+ interest-hint
marker
backdrop
column
Roll protocol to r1495869 — 2025-08-02T04:33:09.000Z
@@ browser_protocol.pdl:10296 @@ domain Page
# Whether or not it was triggered by user gesture.
boolean userGesture
- # Issued for every compilation cache generated. Is only available
- # if Page.setGenerateCompilationCache is enabled.
+ # Issued for every compilation cache generated.
experimental event compilationCacheProduced
parameters
string url
@@ -12097,6 +12096,15 @@ domain Target
parameters
TargetInfo targetInfo
+ # Opens a DevTools window for the target.
+ experimental command openDevTools
+ parameters
+ # This can be the page or tab target ID.
+ TargetID targetId
+ returns
+ # The targetId of DevTools page target.
+ TargetID targetId
+
# The Tethering domain defines methods and events for browser port binding.
experimental domain Tethering
Roll protocol to r1495237 — 2025-08-01T04:41:09.000Z
@@ browser_protocol.pdl:825 @@ experimental domain Audits
ValidationFailedSignatureMismatch
ValidationFailedIntegrityMismatch
+ type UnencodedDigestError extends string
+ enum
+ MalformedDictionary
+ UnknownAlgorithm
+ IncorrectDigestType
+ IncorrectDigestLength
+
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
@@ -863,6 +870,11 @@ experimental domain Audits
array of string integrityAssertions
AffectedRequest request
+ type UnencodedDigestIssueDetails extends object
+ properties
+ UnencodedDigestError error
+ AffectedRequest request
+
type GenericIssueErrorType extends string
enum
FormLabelForNameError
@@ -1123,6 +1135,7 @@ experimental domain Audits
SharedDictionaryIssue
ElementAccessibilityIssue
SRIMessageSignatureIssue
+ UnencodedDigestIssue
UserReidentificationIssue
# This struct holds a list of optional fields with additional information
@@ -1154,6 +1167,7 @@ experimental domain Audits
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
optional ElementAccessibilityIssueDetails elementAccessibilityIssueDetails
optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
+ optional UnencodedDigestIssueDetails unencodedDigestIssueDetails
optional UserReidentificationIssueDetails userReidentificationIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
Roll protocol to r1493946 — 2025-07-30T04:34:37.000Z
@@ browser_protocol.pdl:2134 @@ experimental domain CSS
optional DOM.LogicalAxes logicalAxes
# true if the query contains scroll-state() queries.
optional boolean queriesScrollState
+ # true if the query contains anchored() queries.
+ optional boolean queriesAnchored
# CSS Supports at-rule descriptor.
experimental type CSSSupports extends object
@@ -3717,9 +3719,9 @@ domain DOM
# Returns the query container of the given node based on container query
# conditions: containerName, physical and logical axes, and whether it queries
- # scroll-state. If no axes are provided and queriesScrollState is false, the
- # style container is returned, which is the direct parent or the closest
- # element with a matching container-name.
+ # scroll-state or anchored elements. If no axes are provided and
+ # queriesScrollState is false, the style container is returned, which is the
+ # direct parent or the closest element with a matching container-name.
experimental command getContainerForNode
parameters
NodeId nodeId
@@ -3727,6 +3729,7 @@ domain DOM
optional PhysicalAxes physicalAxes
optional LogicalAxes logicalAxes
optional boolean queriesScrollState
+ optional boolean queriesAnchored
returns
# The container node for the given node, or null if not found.
optional NodeId nodeId
@@ -13245,6 +13248,7 @@ experimental domain Preload
V8OptimizerDisabled
PrerenderFailedDuringPrefetch
BrowsingDataRemoved
+ PrerenderHostReused
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1491235 — 2025-07-24T04:34:08.000Z
@@ browser_protocol.pdl:6362 @@ domain Network
# https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
PrivateNetworkAccessPermissionDenied
# Request was a local network request and is denied by user permission.
- # https://github.com/explainers-by-googlers/local-network-access
+ # https://wicg.github.io/local-network-access/
LocalNetworkAccessPermissionDenied
type CorsErrorStatus extends object
Roll protocol to r1490591 — 2025-07-23T04:34:18.000Z
@@ browser_protocol.pdl:6508 @@ domain Network
Security.SecurityState securityState
# Security details for the request.
optional SecurityDetails securityDetails
+ # Indicates whether the request was sent through IP Protection proxies. If
+ # set to true, the request used the IP Protection privacy feature.
+ experimental optional boolean isIpProtectionUsed
# WebSocket request data.
type WebSocketRequest extends object
Roll protocol to r1488636 — 2025-07-18T04:33:56.000Z
@@ browser_protocol.pdl:7711 @@ domain Network
experimental type IPAddressSpace extends string
enum
Loopback
- Private
+ Local
Public
Unknown
@@ -13103,6 +13103,7 @@ experimental domain Preload
enum
SourceIsNotJsonObject
InvalidRulesSkipped
+ InvalidRulesetLevelTag
# The type of preloading attempted. It corresponds to
# mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
Roll protocol to r1488040 — 2025-07-17T04:33:47.000Z
@@ browser_protocol.pdl:2559 @@ experimental domain CSS
# A list of CSS at-function rules referenced by styles of this node.
experimental optional array of CSSFunctionRule cssFunctionRules
+ # Returns the values of the default UA-defined environment variables used in env()
+ experimental command getEnvironmentVariables
+ returns
+ object environmentVariables
+
# Returns all media queries parsed by the rendering engine.
command getMediaQueries
returns
@@ -9447,6 +9452,8 @@ domain Page
optional Network.LoaderId loaderId
# User friendly error message, present if and only if navigation has failed.
optional string errorText
+ # Whether the navigation resulted in a download.
+ experimental optional boolean isDownload
# Navigates current page to the given history entry.
command navigateToHistoryEntry
Roll protocol to r1487398 — 2025-07-16T04:33:49.000Z
@@ browser_protocol.pdl:3751 @@ domain DOM
# The anchor element of the given anchor query.
NodeId nodeId
+ # When enabling, this API force-opens the popover identified by nodeId
+ # and keeps it open until disabled.
+ experimental command forceShowPopover
+ parameters
+ # Id of the popover HTMLElement
+ NodeId nodeId
+ # If true, opens the popover and keeps it open. If false, closes the
+ # popover if it was previously force-opened.
+ boolean enable
+ returns
+ # List of popovers that were closed in order to respect popover stacking order.
+ array of NodeId nodeIds
+
# Fired when `Element`'s attribute is modified.
event attributeModified
parameters
Roll protocol to r1485358 — 2025-07-11T04:33:31.000Z
@@ browser_protocol.pdl:8609 @@ domain Page
accelerometer
all-screens-capture
ambient-light-sensor
+ aria-notify
attribution-reporting
autoplay
bluetooth
Roll protocol to r1484773 — 2025-07-10T04:32:32.000Z
@@ browser_protocol.pdl:1748 @@ domain Browser
# with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
Bounds bounds
+ # Set size of the browser contents resizing browser window as necessary.
+ experimental command setContentsSize
+ parameters
+ # Browser window id.
+ WindowID windowId
+ # The window contents width in DIP. Assumes current width if omitted.
+ # Must be specified if 'height' is omitted.
+ optional integer width
+ # The window contents height in DIP. Assumes current height if omitted.
+ # Must be specified if 'width' is omitted.
+ optional integer height
+
# Set dock tile details, platform-specific.
experimental command setDockTile
parameters
Roll protocol to r1483532 — 2025-07-08T04:32:14.000Z
@@ browser_protocol.pdl:3386 @@ domain DOM
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
+ # Include all shadow roots. Equals to false if not specified.
+ experimental optional boolean includeShadowDOM
returns
# Outer HTML markup.
string outerHTML
@@ -4874,6 +4876,13 @@ domain Emulation
# Image types to disable.
array of DisabledImageType imageTypes
+
+ # Override the value of navigator.connection.saveData
+ experimental command setDataSaverOverride
+ parameters
+ # Override value. Omitting the parameter disables the override.
+ optional boolean dataSaverEnabled
+
experimental command setHardwareConcurrencyOverride
parameters
# Hardware concurrency to report
Roll protocol to r1481382 — 2025-07-02T04:32:10.000Z
@@ browser_protocol.pdl:8253 @@ experimental domain Overlay
searchForNode
searchForUAShadowDOM
captureAreaScreenshot
- showDistances
none
# Disables domain notifications.
@@ -10639,10 +10638,6 @@ experimental domain ServiceWorker
command enable
- command inspectWorker
- parameters
- string versionId
-
command setForceUpdateOnPageLoad
parameters
boolean forceUpdateOnPageLoad
Roll protocol to r1479623 — 2025-06-27T04:31:59.000Z
@@ browser_protocol.pdl:7671 @@ domain Network
experimental type IPAddressSpace extends string
enum
- Local
+ Loopback
Private
Public
Unknown
Roll protocol to r1478340 — 2025-06-25T04:32:05.000Z
@@ browser_protocol.pdl:1031 @@ experimental domain Audits
# Additional information about the Partitioning Blob URL issue.
PartitioningBlobURLInfo partitioningBlobURLInfo
- type SelectElementAccessibilityIssueReason extends string
+ type ElementAccessibilityIssueReason extends string
enum
DisallowedSelectChild
DisallowedOptGroupChild
NonPhrasingContentOptionChild
InteractiveContentOptionChild
InteractiveContentLegendChild
+ InteractiveContentSummaryDescendant
- # This issue warns about errors in the select element content model.
- type SelectElementAccessibilityIssueDetails extends object
+ # This issue warns about errors in the select or summary element content model.
+ type ElementAccessibilityIssueDetails extends object
properties
DOM.BackendNodeId nodeId
- SelectElementAccessibilityIssueReason selectElementAccessibilityIssueReason
+ ElementAccessibilityIssueReason elementAccessibilityIssueReason
boolean hasDisallowedAttributes
type StyleSheetLoadingIssueReason extends string
@@ -1120,7 +1121,7 @@ experimental domain Audits
FederatedAuthUserInfoRequestIssue
PropertyRuleIssue
SharedDictionaryIssue
- SelectElementAccessibilityIssue
+ ElementAccessibilityIssue
SRIMessageSignatureIssue
UserReidentificationIssue
@@ -1151,7 +1152,7 @@ experimental domain Audits
optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
- optional SelectElementAccessibilityIssueDetails selectElementAccessibilityIssueDetails
+ optional ElementAccessibilityIssueDetails elementAccessibilityIssueDetails
optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
optional UserReidentificationIssueDetails userReidentificationIssueDetails
@@ -3517,7 +3518,8 @@ domain DOM
# Get the popover target for a given element. In this case, this given
# element can only be an HTMLFormControlElement (<input>, <button>).
PopoverTarget
- # Get the interest target for a given element.
+ # Get the interestfor target (the attribute used to be named
+ # `interesttarget`) for for a given element.
InterestTarget
# Get the commandfor target for a given element. In this case, this given
# element can only be an HTMLButtonElement.
@@ -10060,6 +10062,7 @@ domain Page
BroadcastChannel
WebXR
SharedWorker
+ SharedWorkerMessage
WebLocks
WebHID
WebShare
Roll protocol to r1477697 — 2025-06-24T04:32:08.000Z
@@ browser_protocol.pdl:9720 @@ domain Page
# Clears seeded compilation cache.
experimental command clearCompilationCache
- # Enum of possible auto-response for permission / prompt dialogs.
- experimental type AutoResponseMode extends string
- enum
- none
- autoAccept
- autoReject
- autoOptOut
-
# Sets the Secure Payment Confirmation transaction mode.
# https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
experimental command setSPCTransactionMode
parameters
- AutoResponseMode mode
+ enum mode
+ none
+ autoAccept
+ autoChooseToAuthAnotherWay
+ autoReject
+ autoOptOut
# Extensions for Custom Handlers API:
# https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
experimental command setRPHRegistrationMode
parameters
- AutoResponseMode mode
+ enum mode
+ none
+ autoAccept
+ autoReject
# Generates a report for testing.
experimental command generateTestReport
Roll protocol to r1475386 — 2025-06-18T04:31:55.000Z
@@ browser_protocol.pdl:11541 @@ experimental domain Storage
optional string netErrorName
optional integer httpStatusCode
+ experimental event attributionReportingVerboseDebugReportSent
+ parameters
+ string url
+ optional array of object body
+ optional integer netError
+ optional string netErrorName
+ optional integer httpStatusCode
+
# A single Related Website Set object.
experimental type RelatedWebsiteSet extends object
properties
@@ -13421,15 +13429,30 @@ experimental domain PWA
integer badgeCount
array of FileHandler fileHandlers
- # Installs the given manifest identity, optionally using the given install_url
- # or IWA bundle location.
+ # Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
+ #
+ # IWA-specific install description:
+ # manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
+ #
+ # File installation mode:
+ # The installUrlOrBundleUrl can be either file:// or http(s):// pointing
+ # to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
+ # The .swbn file's signing key.
+ #
+ # Dev proxy installation mode:
+ # installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
+ # web_package::SignedWebBundleId must be of type dev proxy.
+ #
+ # The advantage of dev proxy mode is that all changes to IWA
+ # automatically will be reflected in the running app without
+ # reinstallation.
+ #
+ # To generate bundle id for proxy mode:
+ # 1. Generate 32 random bytes.
+ # 2. Add a specific suffix 0x00 at the end.
+ # 3. Encode the entire sequence using Base32 without padding.
#
- # TODO(crbug.com/337872319) Support IWA to meet the following specific
- # requirement.
- # IWA-specific install description: If the manifest_id is isolated-app://,
- # install_url_or_bundle_url is required, and can be either an http(s) URL or
- # file:// URL pointing to a signed web bundle (.swbn). The .swbn file's
- # signing key must correspond to manifest_id. If Chrome is not in IWA dev
+ # If Chrome is not in IWA dev
# mode, the installation will fail, regardless of the state of the allowlist.
command install
parameters
Roll protocol to r1473885 — 2025-06-14T04:31:36.000Z
@@ browser_protocol.pdl:4467 @@ domain Emulation
pause
pauseIfNetworkFetchesPending
- # Used to specify User Agent form-factor values. See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
- experimental type UserAgentFormFactor extends string
- enum
- Desktop
- Automotive
- Mobile
- Tablet
- XR
- EInk
- Watch
-
# Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
experimental type UserAgentBrandVersion extends object
properties
@@ -4500,7 +4489,9 @@ domain Emulation
boolean mobile
optional string bitness
optional boolean wow64
- optional array of UserAgentFormFactor formFactors
+ # Used to specify User Agent form-factor values.
+ # See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
+ optional array of string formFactors
# Used to specify sensor types to emulate.
# See https://w3c.github.io/sensors/#automation for more information.
Roll protocol to r1473367 — 2025-06-13T04:31:57.000Z
@@ browser_protocol.pdl:6931 @@ domain Network
properties
# The outer response of signed HTTP exchange which was received from network.
Response outerResponse
+ # Whether network response for the signed exchange was accompanied by
+ # extra headers.
+ boolean hasExtraInfo
# Information about the signed exchange header.
optional SignedExchangeHeader header
# Security details for the signed exchange header.
Roll protocol to r1472835 — 2025-06-12T04:31:40.000Z
@@ browser_protocol.pdl:8653 @@ domain Page
join-ad-interest-group
keyboard-map
language-detector
+ language-model
local-fonts
local-network-access
magnetometer
Roll protocol to r1472211 — 2025-06-11T04:31:52.000Z
@@ browser_protocol.pdl:4467 @@ domain Emulation
pause
pauseIfNetworkFetchesPending
+ # Used to specify User Agent form-factor values. See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
+ experimental type UserAgentFormFactor extends string
+ enum
+ Desktop
+ Automotive
+ Mobile
+ Tablet
+ XR
+ EInk
+ Watch
+
# Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
experimental type UserAgentBrandVersion extends object
properties
@@ -4489,6 +4500,7 @@ domain Emulation
boolean mobile
optional string bitness
optional boolean wow64
+ optional array of UserAgentFormFactor formFactors
# Used to specify sensor types to emulate.
# See https://w3c.github.io/sensors/#automation for more information.
Roll protocol to r1470888 — 2025-06-07T04:31:13.000Z
@@ browser_protocol.pdl:4700 @@ domain Emulation
protanopia
tritanopia
+ # Emulates the given OS text scale.
+ command setEmulatedOSTextScale
+ parameters
+ optional number scale
+
# Overrides the Geolocation Position or Error. Omitting latitude, longitude or
# accuracy emulates position unavailable.
command setGeolocationOverride
Roll protocol to r1468520 — 2025-06-03T04:31:40.000Z
@@ browser_protocol.pdl:8514 @@ domain Page
AdFrameType adFrameType
optional array of AdFrameExplanation explanations
- # Identifies the bottom-most script which caused the frame to be labelled
- # as an ad.
+ # Identifies the script which caused a script or frame to be labelled as an
+ # ad.
experimental type AdScriptId extends object
properties
- # Script Id of the bottom-most script which caused the frame to be labelled
- # as an ad.
+ # Script Id of the script which caused a script or frame to be labelled as
+ # an ad.
Runtime.ScriptId scriptId
- # Id of adScriptId's debugger.
+ # Id of scriptId's debugger.
Runtime.UniqueDebuggerId debuggerId
+ # Encapsulates the script ancestry and the root script filterlist rule that
+ # caused the frame to be labelled as an ad. Only created when `ancestryChain`
+ # is not empty.
+ experimental type AdScriptAncestry extends object
+ properties
+ # A chain of `AdScriptId`s representing the ancestry of an ad script that
+ # led to the creation of a frame. The chain is ordered from the script
+ # itself (lower level) up to its root ancestor that was flagged by
+ # filterlist.
+ array of AdScriptId ancestryChain
+ # The filterlist rule that caused the root (last) script in
+ # `ancestryChain` to be ad-tagged. Only populated if the rule is
+ # available.
+ optional string rootScriptFilterlistRule
+
# Indicates whether the frame is a secure context and why it is the case.
experimental type SecureContextType extends string
enum
@@ -9291,15 +9306,16 @@ domain Page
# Recommendation for manifest's id attribute to match current id computed from start_url
optional string recommendedId
- experimental command getAdScriptAncestryIds
+ experimental command getAdScriptAncestry
parameters
FrameId frameId
returns
# The ancestry chain of ad script identifiers leading to this frame's
- # creation, ordered from the most immediate script (in the frame creation
+ # creation, along with the root script's filterlist rule. The ancestry
+ # chain is ordered from the most immediate script (in the frame creation
# stack) to more distant ancestors (that created the immediately preceding
# script). Only sent if frame is labelled as an ad and ids are available.
- array of AdScriptId adScriptAncestryIds
+ optional AdScriptAncestry adScriptAncestry
# Returns present frame tree structure.
command getFrameTree
Roll protocol to r1467305 — 2025-05-30T04:31:28.000Z
@@ browser_protocol.pdl:3006 @@ domain DOM
view-transition
view-transition-group
view-transition-image-pair
+ view-transition-group-children
view-transition-old
view-transition-new
placeholder
Roll protocol to r1466870 — 2025-05-29T04:34:46.000Z
@@ browser_protocol.pdl:10838 @@ experimental domain Storage
# Whether or not to set an entry for a key if that key is already present.
# Present only for SharedStorageAccessMethod: set.
optional boolean ignoreIfPresent
- # If the method is called on a shared storage worklet, or as part of
- # a shared storage worklet script, it will have a number for the
- # associated worklet, denoting the (0-indexed) order of the worklet's
+ # A number denoting the (0-based) order of the worklet's
# creation relative to all other shared storage worklets created by
# documents using the current storage partition.
- # Present only for SharedStorageAccessMethods: addModule, createWorklet,
- # run, selectURL, and any other SharedStorageAccessMethod when the
- # SharedStorageAccessScope is sharedStorageWorklet.
- # TODO(crbug.com/401011862): Pass this only for addModule & createWorklet.
+ # Present only for SharedStorageAccessMethods: addModule, createWorklet.
optional integer workletOrdinal
# Hex representation of the DevTools token used as the TargetID for the
# associated shared storage worklet.
@@ -12036,7 +12031,7 @@ domain Tracing
type TraceConfig extends object
properties
- # Controls how the trace buffer stores data.
+ # Controls how the trace buffer stores data. The default is `recordUntilFull`.
experimental optional enum recordMode
recordUntilFull
recordContinuously
Roll protocol to r1465725 — 2025-05-27T04:31:56.000Z
@@ browser_protocol.pdl:1634 @@ domain Browser
inProgress
completed
canceled
+ # If download is "completed", provides the path of the downloaded file.
+ # Depending on the platform, it is not guaranteed to be set, nor the file
+ # is guaranteed to exist.
+ experimental optional string filePath
# Close browser gracefully.
command close
@@ -3008,6 +3012,7 @@ domain DOM
file-selector-button
details-content
picker
+ permission-icon
# Shadow root type.
type ShadowRootType extends string
Roll protocol to r1464554 — 2025-05-23T04:31:06.000Z
@@ browser_protocol.pdl:3513 @@ domain DOM
PopoverTarget
# Get the interest target for a given element.
InterestTarget
+ # Get the commandfor target for a given element. In this case, this given
+ # element can only be an HTMLButtonElement.
+ CommandFor
returns
# NodeId of the element matching the queried relation.
NodeId nodeId
Roll protocol to r1463868 — 2025-05-22T04:31:25.000Z
@@ browser_protocol.pdl:10800 @@ experimental domain Storage
# Name of the registered operation to be run.
# Present only for SharedStorageAccessMethods: run and selectURL.
optional string operationName
+ # ID of the operation call.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional string operationId
# Whether or not to keep the worket alive for future run or selectURL
# calls.
# Present only for SharedStorageAccessMethods: run and selectURL.
@@ -10827,12 +10830,22 @@ experimental domain Storage
# Whether or not to set an entry for a key if that key is already present.
# Present only for SharedStorageAccessMethod: set.
optional boolean ignoreIfPresent
- # If the method is called on a worklet, or as part of
- # a worklet script, it will have an ID for the associated worklet.
+ # If the method is called on a shared storage worklet, or as part of
+ # a shared storage worklet script, it will have a number for the
+ # associated worklet, denoting the (0-indexed) order of the worklet's
+ # creation relative to all other shared storage worklets created by
+ # documents using the current storage partition.
+ # Present only for SharedStorageAccessMethods: addModule, createWorklet,
+ # run, selectURL, and any other SharedStorageAccessMethod when the
+ # SharedStorageAccessScope is sharedStorageWorklet.
+ # TODO(crbug.com/401011862): Pass this only for addModule & createWorklet.
+ optional integer workletOrdinal
+ # Hex representation of the DevTools token used as the TargetID for the
+ # associated shared storage worklet.
# Present only for SharedStorageAccessMethods: addModule, createWorklet,
# run, selectURL, and any other SharedStorageAccessMethod when the
- # SharedStorageAccessScope is worklet.
- optional string workletId
+ # SharedStorageAccessScope is sharedStorageWorklet.
+ optional Target.TargetID workletTargetId
# Name of the lock to be acquired, if present.
# Optionally present only for SharedStorageAccessMethods: batchUpdate,
# set, append, delete, and clear.
@@ -11197,6 +11210,27 @@ experimental domain Storage
# presence/absence depends on `type`.
SharedStorageAccessParams params
+ # A shared storage run or selectURL operation finished its execution.
+ # The following parameters are included in all events.
+ event sharedStorageWorkletOperationExecutionFinished
+ parameters
+ # Time that the operation finished.
+ Network.TimeSinceEpoch finishedTime
+ # Time, in microseconds, from start of shared storage JS API call until
+ # end of operation execution in the worklet.
+ integer executionTime
+ # Enum value indicating the Shared Storage API method invoked.
+ SharedStorageAccessMethod method
+ # ID of the operation call.
+ string operationId
+ # Hex representation of the DevTools token used as the TargetID for the
+ # associated shared storage worklet.
+ Target.TargetID workletTargetId
+ # DevTools Frame Token for the primary frame tree's root.
+ Page.FrameId mainFrameId
+ # Serialization of the origin owning the Shared Storage data.
+ string ownerOrigin
+
event storageBucketCreatedOrUpdated
parameters
StorageBucketInfo bucketInfo
Roll protocol to r1462568 — 2025-05-20T04:31:10.000Z
@@ browser_protocol.pdl:13667 @@ experimental domain BluetoothEmulation
event descriptorOperationReceived
parameters
string descriptorId
- CharacteristicOperationType type
+ DescriptorOperationType type
optional binary data
Roll protocol to r1461159 — 2025-05-16T04:31:23.000Z
@@ browser_protocol.pdl:4744 @@ domain Emulation
PressureSource source
optional PressureMetadata metadata
+ # TODO: OBSOLETE: To remove when setPressureDataOverride is merged.
# Provides a given pressure state that will be processed and eventually be
# delivered to PressureObserver users. |source| must have been previously
# overridden by setPressureSourceOverrideEnabled.
@@ -4752,6 +4753,15 @@ domain Emulation
PressureSource source
PressureState state
+ # Provides a given pressure data set that will be processed and eventually be
+ # delivered to PressureObserver users. |source| must have been previously
+ # overridden by setPressureSourceOverrideEnabled.
+ experimental command setPressureDataOverride
+ parameters
+ PressureSource source
+ PressureState state
+ optional number ownContributionEstimate
+
# Overrides the Idle state.
command setIdleOverride
parameters
@@ -13050,7 +13060,6 @@ experimental domain Preload
InvalidSchemeRedirect
InvalidSchemeNavigation
NavigationRequestBlockedByCsp
- MainFrameNavigation
MojoBinderPolicy
RendererProcessCrashed
RendererProcessKilled
Roll protocol to r1460501 — 2025-05-15T04:31:15.000Z
@@ browser_protocol.pdl:11250 @@ experimental domain Storage
# duration in seconds
array of integer ends
- experimental type AttributionReportingTriggerSpec extends object
- properties
- # number instead of integer because not all uint32 can be represented by
- # int
- array of number triggerData
- AttributionReportingEventReportWindows eventReportWindows
-
experimental type AttributionReportingTriggerDataMatching extends string
enum
exact
@@ -11297,7 +11290,10 @@ experimental domain Storage
Network.TimeSinceEpoch time
# duration in seconds
integer expiry
- array of AttributionReportingTriggerSpec triggerSpecs
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ array of number triggerData
+ AttributionReportingEventReportWindows eventReportWindows
# duration in seconds
integer aggregatableReportWindow
AttributionReportingSourceType type
Roll protocol to r1459876 — 2025-05-14T04:31:17.000Z
@@ browser_protocol.pdl:5971 @@ domain Network
Ping
CSPViolationReport
Preflight
+ FedCM
Other
# Unique loader identifier.
@@ -8607,6 +8608,7 @@ domain Page
media-playback-while-not-visible
microphone
midi
+ on-device-speech-recognition
otp-credentials
payment
picture-in-picture
Roll protocol to r1457408 — 2025-05-08T04:31:17.000Z
@@ browser_protocol.pdl:7959 @@ domain Network
LoadNetworkResourcePageResult resource
# Sets Controls for third-party cookie access
- # Page reload is required before the new cookie bahavior will be observed
+ # Page reload is required before the new cookie behavior will be observed
experimental command setCookieControls
parameters
# Whether 3pc restriction is enabled.
Roll protocol to r1456738 — 2025-05-07T04:30:59.000Z
@@ browser_protocol.pdl:6223 @@ domain Network
mixed-content
origin
inspector
+ integrity
subresource-filter
content-type
coep-frame-resource-needs-coep-header
Roll protocol to r1456087 — 2025-05-06T04:30:50.000Z
@@ browser_protocol.pdl:7018 @@ domain Network
experimental optional integer maxResourceBufferSize
# Longest post body size (in bytes) that would be included in requestWillBeSent notification
optional integer maxPostDataSize
+ # Whether DirectSocket chunk send/receive events should be reported.
+ experimental optional boolean reportDirectSocketTraffic
# Returns all browser cookies. Depending on the backend support, will return detailed cookie
# information in the `cookies` field.
@@ -7549,18 +7551,80 @@ domain Network
binary data
MonotonicTime timestamp
- # Fired when there is an error
- # when writing to tcp direct socket stream.
- # For example, if user writes illegal type like string
- # instead of ArrayBuffer or ArrayBufferView.
- # There's no reporting for reading, because
- # we cannot know errors on the other side.
- experimental event directTCPSocketChunkError
+ experimental type DirectUDPSocketOptions extends object
+ properties
+ optional string remoteAddr
+ # Unsigned int 16.
+ optional integer remotePort
+
+ optional string localAddr
+ # Unsigned int 16.
+ optional integer localPort
+
+ optional DirectSocketDnsQueryType dnsQueryType
+
+ # Expected to be unsigned integer.
+ optional number sendBufferSize
+ # Expected to be unsigned integer.
+ optional number receiveBufferSize
+
+
+ # Fired upon direct_socket.UDPSocket creation.
+ experimental event directUDPSocketCreated
+ parameters
+ RequestId identifier
+ DirectUDPSocketOptions options
+ MonotonicTime timestamp
+ optional Initiator initiator
+
+ # Fired when direct_socket.UDPSocket connection is opened.
+ experimental event directUDPSocketOpened
+ parameters
+ RequestId identifier
+ string localAddr
+ # Expected to be unsigned integer.
+ integer localPort
+ MonotonicTime timestamp
+ optional string remoteAddr
+ # Expected to be unsigned integer.
+ optional integer remotePort
+
+ # Fired when direct_socket.UDPSocket is aborted.
+ experimental event directUDPSocketAborted
parameters
RequestId identifier
string errorMessage
MonotonicTime timestamp
+ # Fired when direct_socket.UDPSocket is closed.
+ experimental event directUDPSocketClosed
+ parameters
+ RequestId identifier
+ MonotonicTime timestamp
+
+ experimental type DirectUDPMessage extends object
+ properties
+ binary data
+ # Null for connected mode.
+ optional string remoteAddr
+ # Null for connected mode.
+ # Expected to be unsigned integer.
+ optional integer remotePort
+
+ # Fired when message is sent to udp direct socket stream.
+ experimental event directUDPSocketChunkSent
+ parameters
+ RequestId identifier
+ DirectUDPMessage message
+ MonotonicTime timestamp
+
+ # Fired when message is received from udp direct socket stream.
+ experimental event directUDPSocketChunkReceived
+ parameters
+ RequestId identifier
+ DirectUDPMessage message
+ MonotonicTime timestamp
+
experimental type PrivateNetworkRequestPolicy extends string
enum
Allow
Roll protocol to r1454823 — 2025-05-02T04:30:38.000Z
@@ browser_protocol.pdl:11380 @@ experimental domain Storage
AttributionReportingEventLevelResult eventLevel
AttributionReportingAggregatableResult aggregatable
+ experimental type AttributionReportingReportResult extends string
+ enum
+ # A network request was attempted for the report.
+ sent
+ # No request was attempted because of browser policy.
+ prohibited
+ # No request was attempted because of an error in report assembly,
+ # e.g. the aggregation service was unavailable.
+ failedToAssemble
+ # No request was attempted because the report's expiry passed.
+ expired
+
+ experimental event attributionReportingReportSent
+ parameters
+ string url
+ object body
+ AttributionReportingReportResult result
+ # If result is `sent`, populated with net/HTTP status.
+ optional integer netError
+ optional string netErrorName
+ optional integer httpStatusCode
+
# A single Related Website Set object.
experimental type RelatedWebsiteSet extends object
properties
@@ -13385,6 +13407,12 @@ experimental domain BluetoothEmulation
subscribe-to-notifications
unsubscribe-from-notifications
+ # Indicates the various types of descriptor operation.
+ type DescriptorOperationType extends string
+ enum
+ read
+ write
+
# Stores the manufacturer data
type ManufacturerData extends object
properties
@@ -13481,6 +13509,18 @@ experimental domain BluetoothEmulation
integer code
optional binary data
+ # Simulates the response from the descriptor with |descriptorId| for a
+ # descriptor operation of |type|. The |code| value follows the Error
+ # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
+ # The |data| is expected to exist when simulating a successful read operation
+ # response.
+ command simulateDescriptorOperationResponse
+ parameters
+ string descriptorId
+ DescriptorOperationType type
+ integer code
+ optional binary data
+
# Adds a service with |serviceUuid| to the peripheral with |address|.
command addService
parameters
@@ -13527,6 +13567,11 @@ experimental domain BluetoothEmulation
parameters
string descriptorId
+ # Simulates a GATT disconnection from the peripheral with |address|.
+ command simulateGATTDisconnection
+ parameters
+ string address
+
# Event for when a GATT operation of |type| to the peripheral with |address|
# happened.
event gattOperationReceived
@@ -13543,3 +13588,12 @@ experimental domain BluetoothEmulation
CharacteristicOperationType type
optional binary data
optional CharacteristicWriteType writeType
+
+ # Event for when a descriptor operation of |type| to the descriptor
+ # respresented by |descriptorId| happened. |data| is expected to exist when
+ # |type| is write.
+ event descriptorOperationReceived
+ parameters
+ string descriptorId
+ CharacteristicOperationType type
+ optional binary data
Roll protocol to r1453708 — 2025-04-30T04:30:29.000Z
@@ browser_protocol.pdl:1079 @@ experimental domain Audits
# The value of the property rule property that failed to parse
optional string propertyValue
+ type UserReidentificationIssueType extends string
+ enum
+ BlockedFrameNavigation
+ BlockedSubresource
+
+ # This issue warns about uses of APIs that may be considered misuse to
+ # re-identify users.
+ type UserReidentificationIssueDetails extends object
+ properties
+ UserReidentificationIssueType type
+ # Applies to BlockedFrameNavigation and BlockedSubresource issue types.
+ optional AffectedRequest request
+
# 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.
@@ -1109,6 +1122,7 @@ experimental domain Audits
SharedDictionaryIssue
SelectElementAccessibilityIssue
SRIMessageSignatureIssue
+ UserReidentificationIssue
# 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
@@ -1139,6 +1153,7 @@ experimental domain Audits
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
optional SelectElementAccessibilityIssueDetails selectElementAccessibilityIssueDetails
optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
+ optional UserReidentificationIssueDetails userReidentificationIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
Roll protocol to r1453071 — 2025-04-29T04:30:14.000Z
@@ browser_protocol.pdl:8455 @@ domain Page
# All Permissions Policy features. This enum should match the one defined
# in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
+ # LINT.IfChange(PermissionsPolicyFeature)
experimental type PermissionsPolicyFeature extends string
enum
accelerometer
@@ -8521,6 +8522,7 @@ domain Page
keyboard-map
language-detector
local-fonts
+ local-network-access
magnetometer
media-playback-while-not-visible
microphone
@@ -8534,6 +8536,7 @@ domain Page
private-state-token-redemption
publickey-credentials-create
publickey-credentials-get
+ record-ad-auction-events
rewriter
run-ad-auction
screen-wake-lock
@@ -8558,6 +8561,7 @@ domain Page
window-management
writer
xr-spatial-tracking
+ # LINT.ThenChange(//services/network/public/cpp/permissions_policy/permissions_policy_features.json5:PermissionsPolicy)
# Reason for a permissions policy feature to be disabled.
experimental type PermissionsPolicyBlockReason extends string
@@ -13351,6 +13355,21 @@ experimental domain BluetoothEmulation
connection
discovery
+ # Indicates the various types of characteristic write.
+ type CharacteristicWriteType extends string
+ enum
+ write-default-deprecated
+ write-with-response
+ write-without-response
+
+ # Indicates the various types of characteristic operation.
+ type CharacteristicOperationType extends string
+ enum
+ read
+ write
+ subscribe-to-notifications
+ unsubscribe-from-notifications
+
# Stores the manufacturer data
type ManufacturerData extends object
properties
@@ -13435,6 +13454,18 @@ experimental domain BluetoothEmulation
GATTOperationType type
integer code
+ # Simulates the response from the characteristic with |characteristicId| for a
+ # characteristic operation of |type|. The |code| value follows the Error
+ # Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
+ # The |data| is expected to exist when simulating a successful read operation
+ # response.
+ command simulateCharacteristicOperationResponse
+ parameters
+ string characteristicId
+ CharacteristicOperationType type
+ integer code
+ optional binary data
+
# Adds a service with |serviceUuid| to the peripheral with |address|.
command addService
parameters
@@ -13487,3 +13518,13 @@ experimental domain BluetoothEmulation
parameters
string address
GATTOperationType type
+
+ # Event for when a characteristic operation of |type| to the characteristic
+ # respresented by |characteristicId| happened. |data| and |writeType| is
+ # expected to exist when |type| is write.
+ event characteristicOperationReceived
+ parameters
+ string characteristicId
+ CharacteristicOperationType type
+ optional binary data
+ optional CharacteristicWriteType writeType
Roll protocol to r1452169 — 2025-04-26T04:29:56.000Z
@@ js_protocol.pdl:649 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
- # For Wasm modules, the content of the `build_id` custom section.
+ # For Wasm modules, the content of the `build_id` custom section. For JavaScript the `debugId` magic comment.
string buildId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
@@ -690,7 +690,7 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
- # For Wasm modules, the content of the `build_id` custom section.
+ # For Wasm modules, the content of the `build_id` custom section. For JavaScript the `debugId` magic comment.
string buildId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
Roll protocol to r1451615 — 2025-04-25T04:30:43.000Z
@@ browser_protocol.pdl:9186 @@ domain Page
# Recommendation for manifest's id attribute to match current id computed from start_url
optional string recommendedId
- experimental command getAdScriptId
+ experimental command getAdScriptAncestryIds
parameters
FrameId frameId
returns
- # Identifies the bottom-most script which caused the frame to be labelled
- # as an ad. Only sent if frame is labelled as an ad and id is available.
- optional AdScriptId adScriptId
+ # The ancestry chain of ad script identifiers leading to this frame's
+ # creation, ordered from the most immediate script (in the frame creation
+ # stack) to more distant ancestors (that created the immediately preceding
+ # script). Only sent if frame is labelled as an ad and ids are available.
+ array of AdScriptId adScriptAncestryIds
# Returns present frame tree structure.
command getFrameTree
@@ -9804,6 +9806,8 @@ domain Page
# closed.
event javascriptDialogClosed
parameters
+ # Frame id.
+ experimental FrameId frameId
# Whether dialog was confirmed.
boolean result
# User input in case of prompt.
@@ -9815,6 +9819,8 @@ domain Page
parameters
# Frame url.
string url
+ # Frame id.
+ experimental FrameId frameId
# Message that will be displayed by the dialog.
string message
# Dialog type.
Roll protocol to r1450379 — 2025-04-23T04:30:35.000Z
@@ browser_protocol.pdl:10656 @@ experimental domain Storage
# storage.
integer bytesUsed
+ # Represents a dictionary object passed in as privateAggregationConfig to
+ # run or selectURL.
+ type SharedStoragePrivateAggregationConfig extends object
+ properties
+ # The chosen aggregation service deployment.
+ optional string aggregationCoordinatorOrigin
+ # The context ID provided.
+ optional string contextId
+ # Configures the maximum size allowed for filtering IDs.
+ integer filteringIdMaxBytes
+ # The limit on the number of contributions in the final report.
+ optional integer maxContributions
+
# Pair of reporting metadata details for a candidate URL for `selectURL()`.
type SharedStorageReportingMetadata extends object
properties
@@ -10675,44 +10688,61 @@ experimental domain Storage
type SharedStorageAccessParams extends object
properties
# Spec of the module script URL.
- # Present only for SharedStorageAccessType.documentAddModule.
+ # Present only for SharedStorageAccessMethods: addModule and
+ # createWorklet.
optional string scriptSourceUrl
+ # String denoting "context-origin", "script-origin", or a custom
+ # origin to be used as the worklet's data origin.
+ # Present only for SharedStorageAccessMethod: createWorklet.
+ optional string dataOrigin
# Name of the registered operation to be run.
- # Present only for SharedStorageAccessType.documentRun and
- # SharedStorageAccessType.documentSelectURL.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
optional string operationName
+ # Whether or not to keep the worket alive for future run or selectURL
+ # calls.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional boolean keepAlive
+ # Configures the private aggregation options.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ optional SharedStoragePrivateAggregationConfig privateAggregationConfig
# The operation's serialized data in bytes (converted to a string).
- # Present only for SharedStorageAccessType.documentRun and
- # SharedStorageAccessType.documentSelectURL.
+ # Present only for SharedStorageAccessMethods: run and selectURL.
+ # TODO(crbug.com/401011862): Consider updating this parameter to binary.
optional string serializedData
# Array of candidate URLs' specs, along with any associated metadata.
- # Present only for SharedStorageAccessType.documentSelectURL.
+ # Present only for SharedStorageAccessMethod: selectURL.
optional array of SharedStorageUrlWithMetadata urlsWithMetadata
+ # Spec of the URN:UUID generated for a selectURL call.
+ # Present only for SharedStorageAccessMethod: selectURL.
+ optional string urnUuid
# Key for a specific entry in an origin's shared storage.
- # Present only for SharedStorageAccessType.documentSet,
- # SharedStorageAccessType.documentAppend,
- # SharedStorageAccessType.documentDelete,
- # SharedStorageAccessType.workletSet,
- # SharedStorageAccessType.workletAppend,
- # SharedStorageAccessType.workletDelete,
- # SharedStorageAccessType.workletGet,
- # SharedStorageAccessType.headerSet,
- # SharedStorageAccessType.headerAppend, and
- # SharedStorageAccessType.headerDelete.
+ # Present only for SharedStorageAccessMethods: set, append, delete, and
+ # get.
optional string key
# Value for a specific entry in an origin's shared storage.
- # Present only for SharedStorageAccessType.documentSet,
- # SharedStorageAccessType.documentAppend,
- # SharedStorageAccessType.workletSet,
- # SharedStorageAccessType.workletAppend,
- # SharedStorageAccessType.headerSet, and
- # SharedStorageAccessType.headerAppend.
+ # Present only for SharedStorageAccessMethods: set and append.
optional string value
# Whether or not to set an entry for a key if that key is already present.
- # Present only for SharedStorageAccessType.documentSet,
- # SharedStorageAccessType.workletSet, and
- # SharedStorageAccessType.headerSet.
+ # Present only for SharedStorageAccessMethod: set.
optional boolean ignoreIfPresent
+ # If the method is called on a worklet, or as part of
+ # a worklet script, it will have an ID for the associated worklet.
+ # Present only for SharedStorageAccessMethods: addModule, createWorklet,
+ # run, selectURL, and any other SharedStorageAccessMethod when the
+ # SharedStorageAccessScope is worklet.
+ optional string workletId
+ # Name of the lock to be acquired, if present.
+ # Optionally present only for SharedStorageAccessMethods: batchUpdate,
+ # set, append, delete, and clear.
+ optional string withLock
+ # If the method has been called as part of a batchUpdate, then this
+ # number identifies the batch to which it belongs.
+ # Optionally present only for SharedStorageAccessMethods:
+ # batchUpdate (required), set, append, delete, and clear.
+ optional string batchUpdateId
+ # Number of modifier methods sent in batch.
+ # Present only for SharedStorageAccessMethod: batchUpdate.
+ optional integer batchSize
type StorageBucketsDurability extends string
enum
@@ -11193,6 +11223,8 @@ experimental domain Storage
optional AttributionScopesData scopesData
integer maxEventLevelReports
array of AttributionReportingNamedBudgetDef namedBudgets
+ boolean debugReporting
+ number eventLevelEpsilon
experimental type AttributionReportingSourceRegistrationResult extends string
enum
Roll protocol to r1449749 — 2025-04-22T04:30:50.000Z
@@ browser_protocol.pdl:11165 @@ experimental domain Storage
number limit
number maxEventStates
+ experimental type AttributionReportingNamedBudgetDef extends object
+ properties
+ string name
+ integer budget
+
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
@@ -11187,6 +11192,7 @@ experimental domain Storage
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
optional AttributionScopesData scopesData
integer maxEventLevelReports
+ array of AttributionReportingNamedBudgetDef namedBudgets
experimental type AttributionReportingSourceRegistrationResult extends string
enum
@@ -11249,6 +11255,11 @@ experimental domain Storage
optional UnsignedInt64AsBase10 dedupKey
AttributionReportingFilterPair filters
+ experimental type AttributionReportingNamedBudgetCandidate extends object
+ properties
+ optional string name
+ AttributionReportingFilterPair filters
+
experimental type AttributionReportingTriggerRegistration extends object
properties
AttributionReportingFilterPair filters
@@ -11264,6 +11275,7 @@ experimental domain Storage
optional string triggerContextId
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
array of string scopes
+ array of AttributionReportingNamedBudgetCandidate namedBudgets
experimental type AttributionReportingEventLevelResult extends string
enum
Roll protocol to r1449119 — 2025-04-19T04:29:57.000Z
@@ browser_protocol.pdl:4854 @@ domain Emulation
# Whether the override should be enabled.
boolean enabled
+ # Allows overriding the difference between the small and large viewport sizes, which determine the
+ # value of the `svh` and `lvh` unit, respectively. Only supported for top-level frames.
+ experimental command setSmallViewportHeightDifferenceOverride
+ parameters
+ # This will cause an element of size 100svh to be `difference` pixels smaller than an element
+ # of size 100lvh.
+ integer difference
+
# This domain provides experimental commands only supported in headless mode.
experimental domain HeadlessExperimental
depends on Page
@@ -9977,7 +9985,8 @@ domain Page
RequestedByWebViewClient
PostMessageByWebViewClient
CacheControlNoStoreDeviceBoundSessionTerminated
- CacheLimitPruned
+ CacheLimitPrunedOnModerateMemoryPressure
+ CacheLimitPrunedOnCriticalMemoryPressure
# Types of not restored reasons for back-forward cache.
experimental type BackForwardCacheNotRestoredReasonType extends string
Roll protocol to r1448144 — 2025-04-17T04:30:33.000Z
@@ browser_protocol.pdl:11333 @@ experimental domain Storage
# party URL, only the first-party URL is returned in the array.
array of string matchedUrls
+ command setProtectedAudienceKAnonymity
+ parameters
+ string owner
+ string name
+ array of binary hashes
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1447524 — 2025-04-16T04:30:24.000Z
@@ browser_protocol.pdl:7512 @@ domain Network
RequestId identifier
MonotonicTime timestamp
+ # Fired when data is sent to tcp direct socket stream.
+ experimental event directTCPSocketChunkSent
+ parameters
+ RequestId identifier
+ binary data
+ MonotonicTime timestamp
+
+ # Fired when data is received from tcp direct socket stream.
+ experimental event directTCPSocketChunkReceived
+ parameters
+ RequestId identifier
+ binary data
+ MonotonicTime timestamp
+
+ # Fired when there is an error
+ # when writing to tcp direct socket stream.
+ # For example, if user writes illegal type like string
+ # instead of ArrayBuffer or ArrayBufferView.
+ # There's no reporting for reading, because
+ # we cannot know errors on the other side.
+ experimental event directTCPSocketChunkError
+ parameters
+ RequestId identifier
+ string errorMessage
+ MonotonicTime timestamp
+
experimental type PrivateNetworkRequestPolicy extends string
enum
Allow
Roll protocol to r1446921 — 2025-04-15T04:30:37.000Z
@@ browser_protocol.pdl:4676 @@ domain Emulation
protanopia
tritanopia
- # Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
- # unavailable.
+ # Overrides the Geolocation Position or Error. Omitting latitude, longitude or
+ # accuracy emulates position unavailable.
command setGeolocationOverride
parameters
# Mock latitude
@@ -4686,6 +4686,14 @@ domain Emulation
optional number longitude
# Mock accuracy
optional number accuracy
+ # Mock altitude
+ optional number altitude
+ # Mock altitudeAccuracy
+ optional number altitudeAccuracy
+ # Mock heading
+ optional number heading
+ # Mock speed
+ optional number speed
experimental command getOverriddenSensorInformation
parameters
Roll protocol to r1445099 — 2025-04-10T04:30:17.000Z
@@ browser_protocol.pdl:1537 @@ domain Browser
enum
openTabSearch
closeTabSearch
+ openGlic
# Set permission settings for given origin.
experimental command setPermission
@@ -6333,6 +6334,7 @@ domain Network
cache
fetch-event
race-network-and-fetch-handler
+ race-network-and-cache
experimental type ServiceWorkerRouterInfo extends object
properties
Roll protocol to r1443917 — 2025-04-08T04:30:16.000Z
@@ browser_protocol.pdl:8453 @@ domain Page
cross-origin-isolated
deferred-fetch
deferred-fetch-minimal
+ device-attributes
digital-credentials-get
direct-sockets
direct-sockets-private
@@ -11642,11 +11643,14 @@ domain Target
# Deprecated.
deprecated optional TargetID targetId
- # Controls whether to automatically attach to new targets which are considered to be related to
- # this one. When turned on, attaches to all existing related targets as well. When turned off,
+ # Controls whether to automatically attach to new targets which are considered
+ # to be directly related to this one (for example, iframes or workers).
+ # When turned on, attaches to all existing related targets as well. When turned off,
# automatically detaches from all currently attached targets.
# This also clears all targets added by `autoAttachRelated` from the list of targets to watch
# for creation of related targets.
+ # You might want to call this recursively for auto-attached targets to attach
+ # to all available targets.
command setAutoAttach
parameters
# Whether to auto-attach to related targets.
Roll protocol to r1443047 — 2025-04-05T04:29:44.000Z
@@ browser_protocol.pdl:13339 @@ experimental domain BluetoothEmulation
# An identifier that uniquely represents this service.
string serviceId
- # Removes the service respresented by |serviceId| from the peripheral with
- # |address|.
+ # Removes the service respresented by |serviceId| from the simulated central.
command removeService
parameters
- string address
string serviceId
# Adds a characteristic with |characteristicUuid| and |properties| to the
- # service represented by |serviceId| in the peripheral with |address|.
+ # service represented by |serviceId|.
command addCharacteristic
parameters
- string address
string serviceId
string characteristicUuid
CharacteristicProperties properties
@@ -13359,34 +13356,24 @@ experimental domain BluetoothEmulation
string characteristicId
# Removes the characteristic respresented by |characteristicId| from the
- # service respresented by |serviceId| in the peripheral with |address|.
+ # simulated central.
command removeCharacteristic
parameters
- string address
- string serviceId
string characteristicId
# Adds a descriptor with |descriptorUuid| to the characteristic respresented
- # by |characteristicId| in the service represented by |serviceId| of the
- # peripheral with |address|.
+ # by |characteristicId|.
command addDescriptor
parameters
- string address
- string serviceId
string characteristicId
string descriptorUuid
returns
# An identifier that uniquely represents this descriptor.
string descriptorId
- # Removes the descriptor with |descriptorId| from the characteristic
- # respresented by |characteristicId| in the service represented by |serviceId|
- # of the peripheral with |address|.
+ # Removes the descriptor with |descriptorId| from the simulated central.
command removeDescriptor
parameters
- string address
- string serviceId
- string characteristicId
string descriptorId
# Event for when a GATT operation of |type| to the peripheral with |address|
Roll protocol to r1441961 — 2025-04-03T04:31:08.000Z
@@ browser_protocol.pdl:11591 @@ domain Target
optional boolean background
# Whether to create the target of type "tab".
experimental optional boolean forTab
+ # Whether to create a hidden target. The hidden target is observable via protocol, but not
+ # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
+ # `background: false`. The life-time of the tab is limited to the life-time of the session.
+ experimental optional boolean hidden
returns
# The id of the page opened.
TargetID targetId
Roll protocol to r1441344 — 2025-04-02T04:30:43.000Z
@@ browser_protocol.pdl:983 @@ experimental domain Audits
TypeNotMatching
UiDismissedNoEmbargo
CorsError
+ SuppressedBySegmentationPlatform
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -2436,7 +2437,12 @@ experimental domain CSS
# For example, a value of '1em' is evaluated according to the computed
# 'font-size' of the element and a value 'calc(1px + 2px)' will be
# resolved to '3px'.
- command resolveValues
+ # If the `propertyName` was specified the `values` are resolved as if
+ # they were property's declaration. If a value cannot be parsed according
+ # to the provided property syntax, the value is parsed using combined
+ # syntax as if null `propertyName` was provided. If the value cannot be
+ # resolved even then, return the provided value without any changes.
+ experimental command resolveValues
parameters
# Substitution functions (var()/env()/attr()) and cascade-dependent
# keywords (revert/revert-layer) do not work.
@@ -2447,9 +2453,9 @@ experimental domain CSS
optional string propertyName
# Pseudo element type, only works for pseudo elements that generate
# elements in the tree, such as ::before and ::after.
- experimental optional DOM.PseudoType pseudoType
+ optional DOM.PseudoType pseudoType
# Pseudo element custom ident.
- experimental optional string pseudoIdentifier
+ optional string pseudoIdentifier
returns
array of string results
@@ -13356,6 +13362,29 @@ experimental domain BluetoothEmulation
string serviceId
string characteristicId
+ # Adds a descriptor with |descriptorUuid| to the characteristic respresented
+ # by |characteristicId| in the service represented by |serviceId| of the
+ # peripheral with |address|.
+ command addDescriptor
+ parameters
+ string address
+ string serviceId
+ string characteristicId
+ string descriptorUuid
+ returns
+ # An identifier that uniquely represents this descriptor.
+ string descriptorId
+
+ # Removes the descriptor with |descriptorId| from the characteristic
+ # respresented by |characteristicId| in the service represented by |serviceId|
+ # of the peripheral with |address|.
+ command removeDescriptor
+ parameters
+ string address
+ string serviceId
+ string characteristicId
+ string descriptorId
+
# Event for when a GATT operation of |type| to the peripheral with |address|
# happened.
event gattOperationReceived
Roll protocol to r1439962 — 2025-03-30T04:30:16.000Z
@@ browser_protocol.pdl:13266 @@ experimental domain BluetoothEmulation
integer rssi
ScanRecord scanRecord
+ # Describes the properties of a characteristic. This follows Bluetooth Core
+ # Specification BT 4.2 Vol 3 Part G 3.3.1. Characteristic Properties.
+ type CharacteristicProperties extends object
+ properties
+ optional boolean broadcast
+ optional boolean read
+ optional boolean writeWithoutResponse
+ optional boolean write
+ optional boolean notify
+ optional boolean indicate
+ optional boolean authenticatedSignedWrites
+ optional boolean extendedProperties
+
# Enable the BluetoothEmulation domain.
command enable
parameters
@@ -13307,20 +13320,41 @@ experimental domain BluetoothEmulation
GATTOperationType type
integer code
- # Adds a service with |uuid| to the peripheral with |address|.
+ # Adds a service with |serviceUuid| to the peripheral with |address|.
command addService
parameters
string address
string serviceUuid
returns
# An identifier that uniquely represents this service.
- string id
+ string serviceId
- # Removes the service respresented by |id| from the peripheral with |address|.
+ # Removes the service respresented by |serviceId| from the peripheral with
+ # |address|.
command removeService
parameters
string address
- string id
+ string serviceId
+
+ # Adds a characteristic with |characteristicUuid| and |properties| to the
+ # service represented by |serviceId| in the peripheral with |address|.
+ command addCharacteristic
+ parameters
+ string address
+ string serviceId
+ string characteristicUuid
+ CharacteristicProperties properties
+ returns
+ # An identifier that uniquely represents this characteristic.
+ string characteristicId
+
+ # Removes the characteristic respresented by |characteristicId| from the
+ # service respresented by |serviceId| in the peripheral with |address|.
+ command removeCharacteristic
+ parameters
+ string address
+ string serviceId
+ string characteristicId
# Event for when a GATT operation of |type| to the peripheral with |address|
# happened.
Roll protocol to r1439209 — 2025-03-28T04:30:28.000Z
@@ browser_protocol.pdl:823 @@ experimental domain Audits
ValidationFailedSignatureExpired
ValidationFailedInvalidLength
ValidationFailedSignatureMismatch
+ ValidationFailedIntegrityMismatch
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
@@ -859,6 +860,7 @@ experimental domain Audits
properties
SRIMessageSignatureError error
string signatureBase
+ array of string integrityAssertions
AffectedRequest request
type GenericIssueErrorType extends string
@@ -6640,6 +6642,8 @@ domain Network
PortMismatch
# The cookie's source scheme value does not match the request origin's scheme.
SchemeMismatch
+ # Unpartitioned cookie access from an anonymous context was blocked.
+ AnonymousContext
# Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
experimental type CookieExemptionReason extends string
@@ -13303,6 +13307,21 @@ experimental domain BluetoothEmulation
GATTOperationType type
integer code
+ # Adds a service with |uuid| to the peripheral with |address|.
+ command addService
+ parameters
+ string address
+ string serviceUuid
+ returns
+ # An identifier that uniquely represents this service.
+ string id
+
+ # Removes the service respresented by |id| from the peripheral with |address|.
+ command removeService
+ parameters
+ string address
+ string id
+
# Event for when a GATT operation of |type| to the peripheral with |address|
# happened.
event gattOperationReceived
Roll protocol to r1438564 — 2025-03-27T04:30:05.000Z
@@ browser_protocol.pdl:10554 @@ experimental domain Storage
bidderTrustedSignals
sellerTrustedSignals
- # Enum of shared storage access types.
- type SharedStorageAccessType extends string
- enum
- documentAddModule
- documentSelectURL
- documentRun
- documentSet
- documentAppend
- documentDelete
- documentClear
- documentGet
- workletSet
- workletAppend
- workletDelete
- workletClear
- workletGet
- workletKeys
- workletEntries
- workletLength
- workletRemainingBudget
- headerSet
- headerAppend
- headerDelete
- headerClear
+ # Enum of shared storage access scopes.
+ type SharedStorageAccessScope extends string
+ enum
+ window
+ sharedStorageWorklet
+ protectedAudienceWorklet
+ header
+
+ # Enum of shared storage access methods.
+ type SharedStorageAccessMethod extends string
+ enum
+ addModule
+ createWorklet
+ selectURL
+ run
+ batchUpdate
+ set
+ append
+ delete
+ clear
+ get
+ keys
+ values
+ entries
+ length
+ remainingBudget
# Struct for a single key-value pair in an origin's shared storage.
type SharedStorageEntry extends object
@@ -10993,12 +10995,16 @@ experimental domain Storage
parameters
# Time of the access.
Network.TimeSinceEpoch accessTime
+ # Enum value indicating the access scope.
+ SharedStorageAccessScope scope
# Enum value indicating the Shared Storage API method invoked.
- SharedStorageAccessType type
+ SharedStorageAccessMethod method
# DevTools Frame Token for the primary frame tree's root.
Page.FrameId mainFrameId
- # Serialized origin for the context that invoked the Shared Storage API.
+ # Serialization of the origin owning the Shared Storage data.
string ownerOrigin
+ # Serialization of the site owning the Shared Storage data.
+ string ownerSite
# The sub-parameters wrapped by `params` are all optional and their
# presence/absence depends on `type`.
SharedStorageAccessParams params
Roll protocol to r1436416 — 2025-03-22T04:29:26.000Z
@@ browser_protocol.pdl:8464 @@ domain Page
interest-cohort
join-ad-interest-group
keyboard-map
+ language-detector
local-fonts
magnetometer
media-playback-while-not-visible
@@ -8478,6 +8479,7 @@ domain Page
private-state-token-redemption
publickey-credentials-create
publickey-credentials-get
+ rewriter
run-ad-auction
screen-wake-lock
serial
@@ -8488,7 +8490,9 @@ domain Page
speaker-selection
storage-access
sub-apps
+ summarizer
sync-xhr
+ translator
unload
usb
usb-unrestricted
@@ -8497,6 +8501,7 @@ domain Page
web-printing
web-share
window-management
+ writer
xr-spatial-tracking
# Reason for a permissions policy feature to be disabled.
@@ -13215,6 +13220,12 @@ experimental domain BluetoothEmulation
powered-off
powered-on
+ # Indicates the various types of GATT event.
+ type GATTOperationType extends string
+ enum
+ connection
+ discovery
+
# Stores the manufacturer data
type ManufacturerData extends object
properties
@@ -13276,3 +13287,19 @@ experimental domain BluetoothEmulation
command simulateAdvertisement
parameters
ScanEntry entry
+
+ # Simulates the response code from the peripheral with |address| for a
+ # GATT operation of |type|. The |code| value follows the HCI Error Codes from
+ # Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
+ command simulateGATTOperationResponse
+ parameters
+ string address
+ GATTOperationType type
+ integer code
+
+ # Event for when a GATT operation of |type| to the peripheral with |address|
+ # happened.
+ event gattOperationReceived
+ parameters
+ string address
+ GATTOperationType type
Roll protocol to r1433962 — 2025-03-18T04:29:59.000Z
@@ browser_protocol.pdl:858 @@ experimental domain Audits
type SRIMessageSignatureIssueDetails extends object
properties
SRIMessageSignatureError error
+ string signatureBase
AffectedRequest request
type GenericIssueErrorType extends string
@@ -4594,7 +4595,8 @@ domain Emulation
experimental optional Page.Viewport viewport
# If set, the display feature of a multi-segment screen. If not set, multi-segment support
# is turned-off.
- experimental optional DisplayFeature displayFeature
+ # Deprecated, use Emulation.setDisplayFeaturesOverride.
+ experimental deprecated optional DisplayFeature displayFeature
# If set, the posture of a foldable device. If not set the posture is set
# to continuous.
# Deprecated, use Emulation.setDevicePostureOverride.
@@ -4612,6 +4614,18 @@ domain Emulation
# Does nothing if no override is set.
experimental command clearDevicePostureOverride
+ # Start using the given display features to pupulate the Viewport Segments API.
+ # This override can also be set in setDeviceMetricsOverride().
+ experimental command setDisplayFeaturesOverride
+ parameters
+ array of DisplayFeature features
+
+ # Clears the display features override set with either setDeviceMetricsOverride()
+ # or setDisplayFeaturesOverride() and starts using display features from the
+ # platform again.
+ # Does nothing if no override is set.
+ experimental command clearDisplayFeaturesOverride
+
experimental command setScrollbarsHidden
parameters
# Whether scrollbars should be always hidden.
@@ -12903,6 +12917,7 @@ experimental domain Preload
PrefetchFailedMIMENotSupported
PrefetchFailedNetError
PrefetchFailedNon2XX
+ PrefetchEvictedAfterBrowsingDataRemoved
PrefetchEvictedAfterCandidateRemoved
PrefetchEvictedForNewerPrefetch
PrefetchHeldback
Roll protocol to r1432532 — 2025-03-14T04:29:36.000Z
@@ browser_protocol.pdl:9911 @@ domain Page
RequestedByWebViewClient
PostMessageByWebViewClient
CacheControlNoStoreDeviceBoundSessionTerminated
+ CacheLimitPruned
# Types of not restored reasons for back-forward cache.
experimental type BackForwardCacheNotRestoredReasonType extends string
Roll protocol to r1431913 — 2025-03-13T04:30:01.000Z
@@ browser_protocol.pdl:1481 @@ domain Browser
idleDetection
keyboardLock
localFonts
+ localNetworkAccess
midi
midiSysex
nfc
@@ -1740,6 +1741,25 @@ domain Browser
parameters
string url
+ experimental type PrivacySandboxAPI extends string
+ enum
+ BiddingAndAuctionServices
+ TrustedKeyValue
+
+ # Configures encryption keys used with a given privacy sandbox API to talk
+ # to a trusted coordinator. Since this is intended for test automation only,
+ # coordinatorOrigin must be a .test domain. No existing coordinator
+ # configuration for the origin may exist.
+ command addPrivacySandboxCoordinatorKeyConfig
+ parameters
+ PrivacySandboxAPI api
+ string coordinatorOrigin
+ string keyConfig
+ # BrowserContext to perform the action in. When omitted, default browser
+ # context is used.
+ optional BrowserContextID browserContextId
+
+
# 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.
@@ -7466,6 +7486,7 @@ domain Network
PreflightBlock
PreflightWarn
PermissionBlock
+ PermissionWarn
experimental type IPAddressSpace extends string
enum
Roll protocol to r1430640 — 2025-03-11T04:29:58.000Z
@@ browser_protocol.pdl:9527 @@ domain Page
command setInterceptFileChooserDialog
parameters
boolean enabled
+ # If true, cancels the dialog by emitting relevant events (if any)
+ # in addition to not showing it if the interception is enabled
+ # (default: false).
+ experimental optional boolean cancel
event domContentEventFired
parameters
Roll protocol to r1429850 — 2025-03-08T04:26:13.000Z
@@ browser_protocol.pdl:7404 @@ domain Network
# Timestamp.
MonotonicTime timestamp
+ experimental type DirectSocketDnsQueryType extends string
+ enum
+ ipv4
+ ipv6
+
+ experimental type DirectTCPSocketOptions extends object
+ properties
+ # TCP_NODELAY option
+ boolean noDelay
+ # Expected to be unsigned integer.
+ optional number keepAliveDelay
+ # Expected to be unsigned integer.
+ optional number sendBufferSize
+ # Expected to be unsigned integer.
+ optional number receiveBufferSize
+ optional DirectSocketDnsQueryType dnsQueryType
+
+
+ # Fired upon direct_socket.TCPSocket creation.
+ experimental event directTCPSocketCreated
+ parameters
+ RequestId identifier
+ string remoteAddr
+ # Unsigned int 16.
+ integer remotePort
+ DirectTCPSocketOptions options
+ MonotonicTime timestamp
+ optional Initiator initiator
+
+ # Fired when direct_socket.TCPSocket connection is opened.
+ experimental event directTCPSocketOpened
+ parameters
+ RequestId identifier
+ string remoteAddr
+ # Expected to be unsigned integer.
+ integer remotePort
+ MonotonicTime timestamp
+ optional string localAddr
+ # Expected to be unsigned integer.
+ optional integer localPort
+
+ # Fired when direct_socket.TCPSocket is aborted.
+ experimental event directTCPSocketAborted
+ parameters
+ RequestId identifier
+ string errorMessage
+ MonotonicTime timestamp
+
+ # Fired when direct_socket.TCPSocket is closed.
+ experimental event directTCPSocketClosed
+ parameters
+ RequestId identifier
+ MonotonicTime timestamp
+
experimental type PrivateNetworkRequestPolicy extends string
enum
Allow
@@ -9444,7 +9498,7 @@ domain Page
autoReject
autoOptOut
-# Sets the Secure Payment Confirmation transaction mode.
+ # Sets the Secure Payment Confirmation transaction mode.
# https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
experimental command setSPCTransactionMode
parameters
@@ -12840,6 +12894,9 @@ experimental domain Preload
PrefetchNotEligibleSchemeIsNotHttps
PrefetchNotEligibleUserHasCookies
PrefetchNotEligibleUserHasServiceWorker
+ PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler
+ PrefetchNotEligibleRedirectFromServiceWorker
+ PrefetchNotEligibleRedirectToServiceWorker
PrefetchNotEligibleBatterySaverEnabled
PrefetchNotEligiblePreloadingDisabled
PrefetchNotFinishedInTime
@@ -13149,6 +13206,14 @@ experimental domain BluetoothEmulation
# Enable the BluetoothEmulation domain.
command enable
+ parameters
+ # State of the simulated central.
+ CentralState state
+ # If the simulated central supports low-energy.
+ boolean leSupported
+
+ # Set the state of the simulated central.
+ command setSimulatedCentralState
parameters
# State of the simulated central.
CentralState state
Roll protocol to r1428127 — 2025-03-05T04:29:34.000Z
@@ browser_protocol.pdl:4346 @@ domain Emulation
depends on Page
depends on Runtime
+ experimental type SafeAreaInsets extends object
+ properties
+ # Overrides safe-area-inset-top.
+ optional integer top
+ # Overrides safe-area-max-inset-top.
+ optional integer topMax
+ # Overrides safe-area-inset-left.
+ optional integer left
+ # Overrides safe-area-max-inset-left.
+ optional integer leftMax
+ # Overrides safe-area-inset-bottom.
+ optional integer bottom
+ # Overrides safe-area-max-inset-bottom.
+ optional integer bottomMax
+ # Overrides safe-area-inset-right.
+ optional integer right
+ # Overrides safe-area-max-inset-right.
+ optional integer rightMax
+
# Screen orientation.
type ScreenOrientation extends object
properties
@@ -4516,6 +4535,12 @@ domain Emulation
# cleared.
optional DOM.RGBA color
+ # Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+ # respective variables to be undefined, even if previously overridden.
+ experimental command setSafeAreaInsetsOverride
+ parameters
+ SafeAreaInsets insets
+
# Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
# window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
# query results).
Roll protocol to r1427544 — 2025-03-04T04:29:27.000Z
@@ browser_protocol.pdl:2252 @@ experimental domain CSS
# Associated style declaration.
CSSStyle style
+ # CSS function argument representation.
+ type CSSFunctionParameter extends object
+ properties
+ # The parameter name.
+ string name
+ # The parameter type.
+ string type
+
+ # CSS function conditional block representation.
+ type CSSFunctionConditionNode extends object
+ properties
+ # Media query for this conditional block. Only one type of condition should be set.
+ optional CSSMedia media
+ # Container query for this conditional block. Only one type of condition should be set.
+ optional CSSContainerQuery containerQueries
+ # @supports CSS at-rule condition. Only one type of condition should be set.
+ optional CSSSupports supports
+ # Block body.
+ array of CSSFunctionNode children
+ # The condition text.
+ string conditionText
+
+ # Section of the body of a CSS function rule.
+ type CSSFunctionNode extends object
+ properties
+ # A conditional block. If set, style should not be set.
+ optional CSSFunctionConditionNode condition
+ # Values set by this node. If set, condition should not be set.
+ optional CSSStyle style
+
+ # CSS function at-rule representation.
+ type CSSFunctionRule extends object
+ properties
+ # Name of the function.
+ Value name
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # List of parameters.
+ array of CSSFunctionParameter parameters
+ # Function body.
+ array of CSSFunctionNode children
+
# CSS keyframe rule representation.
type CSSKeyframeRule extends object
properties
@@ -2449,6 +2494,8 @@ experimental domain CSS
optional CSSFontPaletteValuesRule cssFontPaletteValuesRule
# Id of the first parent element that does not have display: contents.
experimental optional DOM.NodeId parentLayoutNodeId
+ # A list of CSS at-function rules referenced by styles of this node.
+ experimental optional array of CSSFunctionRule cssFunctionRules
# Returns all media queries parsed by the rendering engine.
command getMediaQueries
@@ -6145,6 +6192,9 @@ domain Network
# Request was a private network request and is denied by user permission.
# https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
PrivateNetworkAccessPermissionDenied
+ # Request was a local network request and is denied by user permission.
+ # https://github.com/explainers-by-googlers/local-network-access
+ LocalNetworkAccessPermissionDenied
type CorsErrorStatus extends object
properties
@@ -7336,6 +7386,7 @@ domain Network
WarnFromInsecureToMorePrivate
PreflightBlock
PreflightWarn
+ PermissionBlock
experimental type IPAddressSpace extends string
enum
Roll protocol to r1425554 — 2025-02-27T04:29:43.000Z
@@ browser_protocol.pdl:8235 @@ domain Page
PerformanceProfile
# All Permissions Policy features. This enum should match the one defined
- # in third_party/blink/renderer/core/permissions_policy/permissions_policy_features.json5.
+ # in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
experimental type PermissionsPolicyFeature extends string
enum
accelerometer
Roll protocol to r1423531 — 2025-02-22T04:29:31.000Z
@@ browser_protocol.pdl:8811 @@ domain Page
# Enables page domain notifications.
command enable
+ parameters
+ # If true, the `Page.fileChooserOpened` event will be emitted regardless of the state set by
+ # `Page.setInterceptFileChooserDialog` command (default: false).
+ experimental optional boolean enableFileChooserOpenedEvent
# The manifest of a webapp, see
# https://www.w3.org/TR/appmanifest/#dfn-manifest.
Roll protocol to r1422344 — 2025-02-20T04:28:59.000Z
@@ browser_protocol.pdl:9751 @@ domain Page
EmbedderExtensionSentMessageToCachedFrame
RequestedByWebViewClient
PostMessageByWebViewClient
+ CacheControlNoStoreDeviceBoundSessionTerminated
# Types of not restored reasons for back-forward cache.
experimental type BackForwardCacheNotRestoredReasonType extends string
Roll protocol to r1421213 — 2025-02-18T04:29:00.000Z
@@ browser_protocol.pdl:801 @@ experimental domain Audits
WriteErrorTooLongIdField
WriteErrorUnsupportedType
+ type SRIMessageSignatureError extends string
+ enum
+ MissingSignatureHeader
+ MissingSignatureInputHeader
+ InvalidSignatureHeader
+ InvalidSignatureInputHeader
+ SignatureHeaderValueIsNotByteSequence
+ SignatureHeaderValueIsParameterized
+ SignatureHeaderValueIsIncorrectLength
+ SignatureInputHeaderMissingLabel
+ SignatureInputHeaderValueNotInnerList
+ SignatureInputHeaderValueMissingComponents
+ SignatureInputHeaderInvalidComponentType
+ SignatureInputHeaderInvalidComponentName
+ SignatureInputHeaderInvalidHeaderComponentParameter
+ SignatureInputHeaderInvalidDerivedComponentParameter
+ SignatureInputHeaderKeyIdLength
+ SignatureInputHeaderInvalidParameter
+ SignatureInputHeaderMissingRequiredParameters
+ ValidationFailedSignatureExpired
+ ValidationFailedInvalidLength
+ ValidationFailedSignatureMismatch
+
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
@@ -832,6 +855,11 @@ experimental domain Audits
SharedDictionaryError sharedDictionaryError
AffectedRequest request
+ type SRIMessageSignatureIssueDetails extends object
+ properties
+ SRIMessageSignatureError error
+ AffectedRequest request
+
type GenericIssueErrorType extends string
enum
FormLabelForNameError
@@ -1076,6 +1104,7 @@ experimental domain Audits
PropertyRuleIssue
SharedDictionaryIssue
SelectElementAccessibilityIssue
+ SRIMessageSignatureIssue
# 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
@@ -1105,6 +1134,7 @@ experimental domain Audits
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
optional SelectElementAccessibilityIssueDetails selectElementAccessibilityIssueDetails
+ optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
Roll protocol to r1420292 — 2025-02-14T04:29:03.000Z
@@ browser_protocol.pdl:691 @@ experimental domain Audits
kInlineViolation
kEvalViolation
kURLViolation
+ kSRIViolation
kTrustedTypesSinkViolation
kTrustedTypesPolicyViolation
kWasmEvalViolation
@@ -3388,6 +3389,8 @@ domain DOM
# Get the popover target for a given element. In this case, this given
# element can only be an HTMLFormControlElement (<input>, <button>).
PopoverTarget
+ # Get the interest target for a given element.
+ InterestTarget
returns
# NodeId of the element matching the queried relation.
NodeId nodeId
Roll protocol to r1419694 — 2025-02-13T04:29:06.000Z
@@ browser_protocol.pdl:12675 @@ experimental domain Preload
OtherPrerenderedPageActivated
V8OptimizerDisabled
PrerenderFailedDuringPrefetch
+ BrowsingDataRemoved
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1419081 — 2025-02-12T04:29:01.000Z
@@ browser_protocol.pdl:986 @@ experimental domain Audits
string failureMessage
optional Network.RequestId requestId
+ type PartitioningBlobURLInfo extends string
+ enum
+ BlockedCrossPartitionFetching
+ EnforceNoopenerForNavigation
+
+ type PartitioningBlobURLIssueDetails extends object
+ properties
+ # The BlobURL that failed to load.
+ string url
+ # Additional information about the Partitioning Blob URL issue.
+ PartitioningBlobURLInfo partitioningBlobURLInfo
+
type SelectElementAccessibilityIssueReason extends string
enum
DisallowedSelectChild
@@ -1049,6 +1061,7 @@ experimental domain Audits
CorsIssue
AttributionReportingIssue
QuirksModeIssue
+ PartitioningBlobURLIssue
# Deprecated
NavigatorUserAgentIssue
GenericIssue
@@ -1078,6 +1091,7 @@ experimental domain Audits
optional CorsIssueDetails corsIssueDetails
optional AttributionReportingIssueDetails attributionReportingIssueDetails
optional QuirksModeIssueDetails quirksModeIssueDetails
+ optional PartitioningBlobURLIssueDetails partitioningBlobURLIssueDetails
deprecated optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
optional GenericIssueDetails genericIssueDetails
optional DeprecationIssueDetails deprecationIssueDetails
Roll protocol to r1418467 — 2025-02-11T04:28:54.000Z
@@ browser_protocol.pdl:950 @@ experimental domain Audits
RelyingPartyOriginIsOpaque
TypeNotMatching
UiDismissedNoEmbargo
+ CorsError
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -8362,6 +8363,14 @@ domain Page
OriginTrialStatus status
array of OriginTrialTokenWithStatus tokensWithStatus
+ # Additional information about the frame document's security origin.
+ experimental type SecurityOriginDetails extends object
+ properties
+ # Indicates whether the frame document's security origin is one
+ # of the local hostnames (e.g. "localhost") or IP addresses (IPv4
+ # 127.0.0.0/8 or IPv6 ::1).
+ boolean isLocalhost
+
# Information about the Frame on the page.
type Frame extends object
properties
@@ -8384,6 +8393,8 @@ domain Page
experimental string domainAndRegistry
# Frame document's security origin.
string securityOrigin
+ # Additional details about the frame document's security origin.
+ experimental optional SecurityOriginDetails securityOriginDetails
# Frame document's mimeType as determined by the browser.
string mimeType
# If the frame failed to load, this contains the URL that could not be loaded. Note that unlike url above, this URL may contain a fragment.
@@ -11283,6 +11294,8 @@ domain Target
TargetID targetId
# Binding name, 'cdp' if not specified.
optional string bindingName
+ # If true, inherits the current root session's permissions (default: false).
+ optional boolean inheritPermissions
# Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
# one.
Roll protocol to r1415363 — 2025-02-04T04:28:31.000Z
@@ browser_protocol.pdl:1171 @@ experimental domain Extensions
returns
# Extension id.
string id
+ # Uninstalls an unpacked extension (others not supported) from the profile.
+ # Available if the client is connected using the --remote-debugging-pipe flag
+ # and the --enable-unsafe-extension-debugging.
+ command uninstall
+ parameters
+ # Extension id.
+ string id
# Gets data from extension storage in the given `storageArea`. If `keys` is
# specified, these are used to filter the result.
command getStorageItems
Roll protocol to r1413902 — 2025-01-31T04:28:29.000Z
@@ browser_protocol.pdl:2253 @@ experimental domain CSS
parameters
# Identifier of the frame where "via-inspector" stylesheet should be created.
Page.FrameId frameId
+ # If true, creates a new stylesheet for every call. If false,
+ # returns a stylesheet previously created by a call with force=false
+ # for the frame's document if it exists or creates a new stylesheet
+ # (default: false).
+ optional boolean force
returns
# Identifier of the created "via-inspector" stylesheet.
StyleSheetId styleSheetId
Roll protocol to r1413303 — 2025-01-30T04:28:44.000Z
@@ browser_protocol.pdl:9396 @@ domain Page
experimental event frameResized
+ # Fired when a navigation starts. This event is fired for both
+ # renderer-initiated and browser-initiated navigations. For renderer-initiated
+ # navigations, the event is fired after `frameRequestedNavigation`.
+ # Navigation may still be cancelled after the event is issued. Multiple events
+ # can be fired for a single navigation, for example, when a same-document
+ # navigation becomes a cross-document navigation (such as in the case of a
+ # frameset).
+ experimental event frameStartedNavigating
+ parameters
+ # ID of the frame that is being navigated.
+ FrameId frameId
+ # The URL the navigation started with. The final URL can be different.
+ string url
+ # Loader identifier. Even though it is present in case of same-document
+ # navigation, the previously committed loaderId would not change unless
+ # the navigation changes from a same-document to a cross-document
+ # navigation.
+ Network.LoaderId loaderId
+ enum navigationType
+ reload
+ reloadBypassingCache
+ restore
+ restoreWithPost
+ historySameDocument
+ historyDifferentDocument
+ sameDocument
+ differentDocument
+
# Fired when a renderer-initiated navigation is requested.
# Navigation may still be cancelled after the event is issued.
experimental event frameRequestedNavigation
Roll protocol to r1412693 — 2025-01-29T04:28:28.000Z
@@ js_protocol.pdl:564 @@ domain Debugger
experimental optional array of LocationRange skipList
# Fired when breakpoint is resolved to an actual script and location.
- event breakpointResolved
+ # Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
+ deprecated event breakpointResolved
parameters
# Breakpoint unique identifier.
BreakpointId breakpointId
@@ -622,6 +623,13 @@ domain Debugger
# URL of the external symbol source.
optional string externalURL
+ type ResolvedBreakpoint extends object
+ properties
+ # Breakpoint unique identifier.
+ BreakpointId breakpointId
+ # Actual breakpoint location.
+ Location location
+
# Fired when virtual machine fails to parse the script.
event scriptFailedToParse
parameters
@@ -706,6 +714,10 @@ domain Debugger
experimental optional array of Debugger.DebugSymbols debugSymbols
# The name the embedder supplied for this script.
experimental optional string embedderName
+ # The list of set breakpoints in this script if calls to `setBreakpointByUrl`
+ # matches this script's URL or hash. Clients that use this list can ignore the
+ # `breakpointResolved` event. They are equivalent.
+ experimental optional array of ResolvedBreakpoint resolvedBreakpoints
experimental domain HeapProfiler
depends on Runtime
@@ -1560,10 +1572,14 @@ domain Runtime
# It is the total usage of the corresponding isolate not scoped to a particular Runtime.
experimental command getHeapUsage
returns
- # Used heap size in bytes.
+ # Used JavaScript heap size in bytes.
number usedSize
- # Allocated heap size in bytes.
+ # Allocated JavaScript heap size in bytes.
number totalSize
+ # Used size in bytes in the embedder's garbage-collected heap.
+ number embedderHeapUsedSize
+ # Size in bytes of backing storage for array buffers and external strings.
+ number backingStorageSize
# Returns properties of a given object. Object group of the result is inherited from the target
# object.
Roll protocol to r1410712 — 2025-01-24T04:28:44.000Z
@@ browser_protocol.pdl:6495 @@ domain Network
TopLevelStorageAccess
# The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
Scheme
+ # The cookie was included due to the 'allow-same-site-none-cookies' value being set in the sandboxing policy.
+ SameSiteNoneCookiesInSandbox
# A cookie which was not stored from a response with the corresponding reason.
experimental type BlockedSetCookieWithReason extends object
Roll protocol to r1409451 — 2025-01-22T04:28:58.000Z
@@ browser_protocol.pdl:10985 @@ experimental domain Storage
returns
array of RelatedWebsiteSet sets
+ # Returns the list of URLs from a page and its embedded resources that match
+ # existing grace period URL pattern rules.
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
+ experimental command getAffectedUrlsForThirdPartyCookieMetadata
+ parameters
+ # The URL of the page currently being visited.
+ string firstPartyUrl
+ # The list of embedded resource URLs from the page.
+ array of string thirdPartyUrls
+
+ returns
+ # Array of matching URLs. If there is a primary pattern match for the first-
+ # party URL, only the first-party URL is returned in the array.
+ array of string matchedUrls
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1406504 — 2025-01-15T04:28:35.000Z
@@ browser_protocol.pdl:11174 @@ domain Target
string host
integer port
+ # The state of the target window.
+ experimental type WindowState extends string
+ enum
+ normal
+ minimized
+ maximized
+ fullscreen
+
# Activates (focuses) the target.
command activateTarget
parameters
@@ -11255,6 +11263,9 @@ domain Target
optional integer width
# Frame height in DIP (requires newWindow to be true or headless shell).
optional integer height
+ # Frame window state (requires newWindow to be true or headless shell).
+ # Default is normal.
+ optional WindowState windowState
# The browser context to create the page in.
experimental optional Browser.BrowserContextID browserContextId
# Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
Roll protocol to r1404580 — 2025-01-10T04:29:07.000Z
@@ browser_protocol.pdl:949 @@ experimental domain Audits
InvalidFieldsSpecified
RelyingPartyOriginIsOpaque
TypeNotMatching
+ UiDismissedNoEmbargo
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -4217,56 +4218,6 @@ experimental domain DOMStorage
parameters
StorageId storageId
-experimental domain Database
-
- # Unique identifier of Database object.
- type DatabaseId extends string
-
- # Database object.
- type Database extends object
- properties
- # Database ID.
- DatabaseId id
- # Database domain.
- string domain
- # Database name.
- string name
- # Database version.
- string version
-
- # Database error.
- type Error extends object
- properties
- # Error message.
- string message
- # Error code.
- integer code
-
- # Disables database tracking, prevents database events from being sent to the client.
- command disable
-
- # Enables database tracking, database events will now be delivered to the client.
- command enable
-
- command executeSQL
- parameters
- DatabaseId databaseId
- string query
- returns
- optional array of string columnNames
- optional array of any values
- optional Error sqlError
-
- command getDatabaseTableNames
- parameters
- DatabaseId databaseId
- returns
- array of string tableNames
-
- event addDatabase
- parameters
- Database database
-
experimental domain DeviceOrientation
# Clears the overridden Device Orientation.
@@ -8246,6 +8197,7 @@ domain Page
ch-ua
ch-ua-arch
ch-ua-bitness
+ ch-ua-high-entropy-values
ch-ua-platform
ch-ua-model
ch-ua-mobile
Roll protocol to r1403989 — 2025-01-09T04:29:04.000Z
@@ browser_protocol.pdl:11295 @@ domain Target
parameters
# The initial URL the page will be navigated to. An empty string indicates about:blank.
string url
- # Frame left origin in DIP (headless chrome only).
+ # Frame left origin in DIP (requires newWindow to be true or headless shell).
experimental optional integer left
- # Frame top origin in DIP (headless chrome only).
+ # Frame top origin in DIP (requires newWindow to be true or headless shell).
experimental optional integer top
- # Frame width in DIP (headless chrome only).
+ # Frame width in DIP (requires newWindow to be true or headless shell).
optional integer width
- # Frame height in DIP (headless chrome only).
+ # Frame height in DIP (requires newWindow to be true or headless shell).
optional integer height
# The browser context to create the page in.
experimental optional Browser.BrowserContextID browserContextId
- # Whether BeginFrames for this target will be controlled via DevTools (headless chrome only,
+ # Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
# not supported on MacOS yet, false by default).
experimental optional boolean enableBeginFrameControl
- # Whether to create a new Window or Tab (chrome-only, false by default).
+ # Whether to create a new Window or Tab (false by default, not supported by headless shell).
optional boolean newWindow
- # Whether to create the target in background or foreground (chrome-only,
- # false by default).
+ # Whether to create the target in background or foreground (false by default, not supported
+ # by headless shell).
optional boolean background
# Whether to create the target of type "tab".
experimental optional boolean forTab
Roll protocol to r1403386 — 2025-01-08T04:29:00.000Z
@@ browser_protocol.pdl:992 @@ experimental domain Audits
InteractiveContentOptionChild
InteractiveContentLegendChild
- # This isue warns about errors in the select element content model.
+ # This issue warns about errors in the select element content model.
type SelectElementAccessibilityIssueDetails extends object
properties
DOM.BackendNodeId nodeId
SelectElementAccessibilityIssueReason selectElementAccessibilityIssueReason
boolean hasDisallowedAttributes
-
type StyleSheetLoadingIssueReason extends string
enum
LateImportRule
@@ -10261,7 +10260,6 @@ experimental domain Storage
# Enum of possible storage types.
type StorageType extends string
enum
- appcache
cookies
file_systems
indexeddb
Roll protocol to r1402790 — 2025-01-07T04:28:42.000Z
@@ browser_protocol.pdl:2327 @@ experimental domain CSS
returns
array of string results
+ experimental command getLonghandProperties
+ parameters
+ string shorthandName
+ string value
+ returns
+ array of CSSProperty longhandProperties
+
# Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
# attributes) for a DOM node identified by `nodeId`.
command getInlineStylesForNode
@@ -7429,6 +7436,7 @@ domain Network
InternalError
UnknownError
FulfilledLocally
+ SiteIssuerLimit
TrustTokenOperationType type
RequestId requestId
# Top level origin. The context in which the operation was attempted.
Roll protocol to r1402036 — 2025-01-04T04:28:29.000Z
@@ browser_protocol.pdl:7639 @@ domain Network
returns
LoadNetworkResourcePageResult resource
+ # Sets Controls for third-party cookie access
+ # Page reload is required before the new cookie bahavior will be observed
+ experimental command setCookieControls
+ parameters
+ # Whether 3pc restriction is enabled.
+ boolean enableThirdPartyCookieRestriction
+
+ # Whether 3pc grace period exception should be enabled; false by default.
+ boolean disableThirdPartyCookieMetadata
+
+ # Whether 3pc heuristics exceptions should be enabled; false by default.
+ boolean disableThirdPartyCookieHeuristics
+
# This domain provides various functionality related to drawing atop the inspected page.
experimental domain Overlay
depends on DOM
Roll protocol to r1400418 — 2024-12-27T04:28:57.000Z
@@ browser_protocol.pdl:984 @@ experimental domain Audits
string failureMessage
optional Network.RequestId requestId
+ type SelectElementAccessibilityIssueReason extends string
+ enum
+ DisallowedSelectChild
+ DisallowedOptGroupChild
+ NonPhrasingContentOptionChild
+ InteractiveContentOptionChild
+ InteractiveContentLegendChild
+
+ # This isue warns about errors in the select element content model.
+ type SelectElementAccessibilityIssueDetails extends object
+ properties
+ DOM.BackendNodeId nodeId
+ SelectElementAccessibilityIssueReason selectElementAccessibilityIssueReason
+ boolean hasDisallowedAttributes
+
+
type StyleSheetLoadingIssueReason extends string
enum
LateImportRule
@@ -1044,6 +1060,7 @@ experimental domain Audits
FederatedAuthUserInfoRequestIssue
PropertyRuleIssue
SharedDictionaryIssue
+ SelectElementAccessibilityIssue
# 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
@@ -1071,6 +1088,7 @@ experimental domain Audits
optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
+ optional SelectElementAccessibilityIssueDetails selectElementAccessibilityIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
@@ -11258,6 +11276,10 @@ domain Target
parameters
# The initial URL the page will be navigated to. An empty string indicates about:blank.
string url
+ # Frame left origin in DIP (headless chrome only).
+ experimental optional integer left
+ # Frame top origin in DIP (headless chrome only).
+ experimental optional integer top
# Frame width in DIP (headless chrome only).
optional integer width
# Frame height in DIP (headless chrome only).
Roll protocol to r1399977 — 2024-12-24T04:29:08.000Z
@@ browser_protocol.pdl:499 @@ experimental domain Audits
type AffectedRequest extends object
properties
# The unique request id.
- Network.RequestId requestId
- optional string url
+ optional Network.RequestId requestId
+ string url
# Information about the frame affected by an inspector issue.
type AffectedFrame extends object
Roll protocol to r1396320 — 2024-12-14T04:29:52.000Z
@@ browser_protocol.pdl:2255 @@ experimental domain CSS
# Element pseudo classes to force when computing the element's style.
array of string forcedPseudoClasses
+ # Ensures that the given node is in its starting-style state.
+ command forceStartingStyle
+ parameters
+ # The element id for which to force the starting-style state.
+ DOM.NodeId nodeId
+ # Boolean indicating if this is on or off.
+ boolean forced
+
command getBackgroundColors
parameters
# Id of the node to get background colors for.
Roll protocol to r1395251 — 2024-12-12T04:30:26.000Z
@@ browser_protocol.pdl:1701 @@ experimental domain CSS
# Matches of CSS rules applicable to the pseudo style.
array of RuleMatch matches
+ # CSS style coming from animations with the name of the animation.
+ type CSSAnimationStyle extends object
+ properties
+ # The name of the animation.
+ optional string name
+ # The style coming from the animation.
+ CSSStyle style
+
# Inherited CSS rule collection from ancestor node.
type InheritedStyleEntry extends object
properties
@@ -1709,6 +1717,14 @@ experimental domain CSS
# Matches of CSS rules matching the ancestor node in the style inheritance chain.
array of RuleMatch matchedCSSRules
+ # Inherited CSS style collection for animated styles from ancestor node.
+ type InheritedAnimatedStyleEntry extends object
+ properties
+ # Styles coming from the animations of the ancestor, if any, in the style inheritance chain.
+ optional array of CSSAnimationStyle animationStyles
+ # The style coming from the transitions of the ancestor, if any, in the style inheritance chain.
+ optional CSSStyle transitionsStyle
+
# Inherited pseudo element matches from pseudos of an ancestor node.
type InheritedPseudoElementMatches extends object
properties
@@ -2296,6 +2312,20 @@ experimental domain CSS
# Attribute-defined element style (e.g. resulting from "width=20 height=100%").
optional CSSStyle attributesStyle
+ # Returns the styles coming from animations & transitions
+ # including the animation & transition styles coming from inheritance chain.
+ experimental command getAnimatedStylesForNode
+ parameters
+ DOM.NodeId nodeId
+ returns
+ # Styles coming from animations.
+ optional array of CSSAnimationStyle animationStyles
+ # Style coming from transitions.
+ optional CSSStyle transitionsStyle
+ # Inherited style entries for animationsStyle and transitionsStyle from
+ # the inheritance chain of the element.
+ optional array of InheritedAnimatedStyleEntry inherited
+
# Returns requested styles for a DOM node identified by `nodeId`.
command getMatchedStylesForNode
parameters
Roll protocol to r1393284 — 2024-12-07T04:30:05.000Z
@@ js_protocol.pdl:641 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
+ # For Wasm modules, the content of the `build_id` custom section.
+ string buildId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
# URL of source map associated with script (if any).
@@ -680,6 +682,8 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
+ # For Wasm modules, the content of the `build_id` custom section.
+ string buildId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
# True, if this script is generated as a result of the live edit operation.
Roll protocol to r1392711 — 2024-12-06T04:30:32.000Z
@@ browser_protocol.pdl:2264 @@ experimental domain CSS
# Computed style for the specified DOM node.
array of CSSComputedStyleProperty computedStyle
+ # Resolve the specified values in the context of the provided element.
+ # For example, a value of '1em' is evaluated according to the computed
+ # 'font-size' of the element and a value 'calc(1px + 2px)' will be
+ # resolved to '3px'.
+ command resolveValues
+ parameters
+ # Substitution functions (var()/env()/attr()) and cascade-dependent
+ # keywords (revert/revert-layer) do not work.
+ array of string values
+ # Id of the node in whose context the expression is evaluated
+ DOM.NodeId nodeId
+ # Only longhands and custom property names are accepted.
+ optional string propertyName
+ # Pseudo element type, only works for pseudo elements that generate
+ # elements in the tree, such as ::before and ::after.
+ experimental optional DOM.PseudoType pseudoType
+ # Pseudo element custom ident.
+ experimental optional string pseudoIdentifier
+ returns
+ array of string results
+
# Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
# attributes) for a DOM node identified by `nodeId`.
command getInlineStylesForNode
@@ -7293,6 +7314,9 @@ domain Network
# are represented by the invalid cookie line string instead of a proper cookie.
array of BlockedSetCookieWithReason blockedCookies
# Raw response headers as they were received over the wire.
+ # Duplicate headers in the response are represented as a single key with their values
+ # concatentated using `\n` as the separator.
+ # See also `headersText` that contains verbatim text for HTTP/1.*.
Headers headers
# The IP address space of the resource. The address space can only be determined once the transport
# established the connection, so we can't send it in `requestWillBeSentExtraInfo`.
@@ -7321,6 +7345,9 @@ domain Network
# Request identifier. Used to match this information to another responseReceived event.
RequestId requestId
# Raw response headers as they were received over the wire.
+ # Duplicate headers in the response are represented as a single key with their values
+ # concatentated using `\n` as the separator.
+ # See also `headersText` that contains verbatim text for HTTP/1.*.
Headers headers
# Fired exactly once for each Trust Token operation. Depending on
Roll protocol to r1392070 — 2024-12-05T04:30:37.000Z
@@ browser_protocol.pdl:12424 @@ experimental domain Preload
array of RuleSetId ruleSetIds
array of DOM.BackendNodeId nodeIds
+ # Chrome manages different types of preloads together using a
+ # concept of preloading pipeline. For example, if a site uses a
+ # SpeculationRules for prerender, Chrome first starts a prefetch and
+ # then upgrades it to prerender.
+ #
+ # CDP events for them are emitted separately but they share
+ # `PreloadPipelineId`.
+ type PreloadPipelineId extends string
+
command enable
command disable
@@ -12580,6 +12589,7 @@ experimental domain Preload
event prefetchStatusUpdated
parameters
PreloadingAttemptKey key
+ PreloadPipelineId pipelineId
# The frame id of the frame initiating prefetch.
Page.FrameId initiatingFrameId
string prefetchUrl
@@ -12598,6 +12608,7 @@ experimental domain Preload
event prerenderStatusUpdated
parameters
PreloadingAttemptKey key
+ PreloadPipelineId pipelineId
PreloadingStatus status
optional PrerenderFinalStatus prerenderStatus
# This is used to give users more information about the name of Mojo interface
Roll protocol to r1391447 — 2024-12-04T04:30:22.000Z
@@ browser_protocol.pdl:2743 @@ domain DOM
checkmark
before
after
- select-arrow
+ picker-icon
marker
backdrop
column
Roll protocol to r1389614 — 2024-11-29T04:30:26.000Z
@@ browser_protocol.pdl:654 @@ experimental domain Audits
CorpNotSameOriginAfterDefaultedToSameOriginByDip
CorpNotSameOriginAfterDefaultedToSameOriginByCoepAndDip
CorpNotSameSite
+ SRIMessageSignatureMismatch
# 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
@@ -5991,6 +5992,7 @@ domain Network
corp-not-same-origin-after-defaulted-to-same-origin-by-dip
corp-not-same-origin-after-defaulted-to-same-origin-by-coep-and-dip
corp-not-same-site
+ sri-message-signature-mismatch
# The reason why request was blocked.
type CorsError extends string
Roll protocol to r1388031 — 2024-11-26T04:30:08.000Z
@@ browser_protocol.pdl:1393 @@ domain Browser
experimental type PermissionType extends string
enum
- accessibilityEvents
+ ar
audioCapture
- backgroundSync
+ automaticFullscreen
backgroundFetch
+ backgroundSync
+ cameraPanTiltZoom
capturedSurfaceControl
clipboardReadWrite
clipboardSanitizedWrite
displayCapture
durableStorage
- flash
geolocation
+ handTracking
idleDetection
+ keyboardLock
localFonts
midi
midiSysex
@@ -1412,16 +1415,19 @@ domain Browser
notifications
paymentHandler
periodicBackgroundSync
+ pointerLock
protectedMediaIdentifier
sensors
- storageAccess
+ smartCard
speakerSelection
+ storageAccess
topLevelStorageAccess
videoCapture
- videoCapturePanTiltZoom
+ vr
wakeLockScreen
wakeLockSystem
webAppInstallation
+ webPrinting
windowManagement
experimental type PermissionSetting extends string
Roll protocol to r1387316 — 2024-11-24T04:29:22.000Z
@@ browser_protocol.pdl:2733 @@ domain DOM
enum
first-line
first-letter
- check
+ checkmark
before
after
select-arrow
Roll protocol to r1387216 — 2024-11-23T04:29:30.000Z
@@ browser_protocol.pdl:2749 @@ domain DOM
first-line-inherited
scroll-marker
scroll-marker-group
- scroll-next-button
- scroll-prev-button
+ scroll-button
scrollbar
scrollbar-thumb
scrollbar-button
Roll protocol to r1386619 — 2024-11-22T04:29:55.000Z
@@ browser_protocol.pdl:543 @@ experimental domain Audits
SetCookie
ReadCookie
+ # Represents the category of insight that a cookie issue falls under.
+ type InsightType extends string
+ enum
+ # Cookie domain has an entry in third-party cookie migration readiness
+ # list:
+ # https://github.com/privacysandbox/privacy-sandbox-dev-support/blob/main/3pc-migration-readiness.md
+ GitHubResource
+ # Cookie is exempted due to a grace period:
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
+ GracePeriod
+ # Cookie is exempted due a heuristics-based exemptiuon:
+ # https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/heuristics-based-exception
+ Heuristics
+
+ # Information about the suggested solution to a cookie issue.
+ type CookieIssueInsight extends object
+ properties
+ InsightType type
+ # Link to table entry in third-party cookie migration readiness list.
+ optional string tableEntryUrl
+
# 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.
@@ -562,6 +583,8 @@ experimental domain Audits
optional string siteForCookies
optional string cookieUrl
optional AffectedRequest request
+ # The recommended solution to the issue.
+ optional CookieIssueInsight insight
type MixedContentResolutionStatus extends string
enum
Roll protocol to r1383960 — 2024-11-16T04:30:17.000Z
@@ browser_protocol.pdl:8130 @@ domain Page
controlled-frame
cross-origin-isolated
deferred-fetch
+ deferred-fetch-minimal
digital-credentials-get
direct-sockets
direct-sockets-private
Roll protocol to r1380148 — 2024-11-08T04:28:53.000Z
@@ browser_protocol.pdl:2322 @@ experimental domain CSS
# Starts tracking the given node for the computed style updates
# and whenever the computed style is updated for node, it queues
# a `computedStyleUpdated` event with throttling.
+ # There can only be 1 node tracked for computed style updates
+ # so passing a new node id removes tracking from the previous node.
+ # Pass `undefined` to disable tracking.
experimental command trackComputedStyleUpdatesForNode
parameters
optional DOM.NodeId nodeId
@@ -5704,7 +5707,9 @@ domain Network
# Unique loader identifier.
type LoaderId extends string
- # Unique request identifier.
+ # Unique network request identifier.
+ # Note that this does not identify individual HTTP requests that are part of
+ # a network request.
type RequestId extends string
# Unique intercepted request identifier.
@@ -6218,6 +6223,7 @@ domain Network
preflight
other
# Initiator JavaScript stack trace, set for Script only.
+ # Requires the Debugger domain to be enabled.
optional Runtime.StackTrace stack
# Initiator URL, set for Parser type or for Script type (when script is importing module) or for SignedExchange type.
optional string url
@@ -11503,6 +11509,8 @@ domain Fetch
depends on Page
# Unique request identifier.
+ # Note that this does not identify individual HTTP requests that are part of
+ # a network request.
type RequestId extends string
# Stages of the request to handle. Request will intercept before the request is
Roll protocol to r1379457 — 2024-11-07T04:29:07.000Z
@@ browser_protocol.pdl:6397 @@ domain Network
# The cookie's name/value pair size exceeded the size limit defined in
# RFC6265bis.
NameValuePairExceedsMaxSize
+ # The cookie's source port value does not match the request origin's port.
+ PortMismatch
+ # The cookie's source scheme value does not match the request origin's scheme.
+ SchemeMismatch
# Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
experimental type CookieExemptionReason extends string
@@ -9397,7 +9401,8 @@ domain Page
# Default dialog prompt.
optional string defaultPrompt
- # Fired for top level page lifecycle events such as navigation, load, paint, etc.
+ # Fired for lifecycle events (navigation, load, paint, etc) in the current
+ # target (including local frames).
event lifecycleEvent
parameters
# Id of the frame.
@@ -10859,6 +10864,7 @@ experimental domain Storage
excessiveReportingOrigins
noHistograms
insufficientBudget
+ insufficientNamedBudget
noMatchingSourceFilterData
notRegistered
prohibitedByBrowserPolicy
Roll protocol to r1378738 — 2024-11-06T04:29:39.000Z
@@ browser_protocol.pdl:2319 @@ experimental domain CSS
returns
array of SourceRange ranges
+ # Starts tracking the given node for the computed style updates
+ # and whenever the computed style is updated for node, it queues
+ # a `computedStyleUpdated` event with throttling.
+ experimental command trackComputedStyleUpdatesForNode
+ parameters
+ optional DOM.NodeId nodeId
+
# Starts tracking the given computed styles for updates. The specified array of properties
# replaces the one previously specified. Pass empty array to disable tracking.
# Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
@@ -2486,6 +2493,11 @@ experimental domain CSS
# Identifier of the removed stylesheet.
StyleSheetId styleSheetId
+ experimental event computedStyleUpdated
+ parameters
+ # The node id that has updated computed styles.
+ DOM.NodeId nodeId
+
experimental domain CacheStorage
depends on Storage
Roll protocol to r1377232 — 2024-11-02T04:29:34.000Z
@@ browser_protocol.pdl:117 @@ experimental domain Accessibility
# - from 'activedescendant' to 'owns' - relationships between elements other than parent/child/sibling.
type AXPropertyName extends string
enum
+ actions
busy
disabled
editable
@@ -517,6 +518,8 @@ experimental domain Audits
ExcludeDomainNonASCII
ExcludeThirdPartyCookieBlockedInFirstPartySet
ExcludeThirdPartyPhaseout
+ ExcludePortMismatch
+ ExcludeSchemeMismatch
type CookieWarningReason extends string
enum
@@ -2695,6 +2698,7 @@ domain DOM
check
before
after
+ select-arrow
marker
backdrop
column
Roll protocol to r1376744 — 2024-11-01T04:29:19.000Z
@@ browser_protocol.pdl:1798 @@ experimental domain CSS
experimental optional array of CSSScope scopes
# The array keeps the types of ancestor CSSRules from the innermost going outwards.
experimental optional array of CSSRuleType ruleTypes
+ # @starting-style CSS at-rule array.
+ # The array enumerates @starting-style at-rules starting with the innermost one, going outwards.
+ experimental optional array of CSSStartingStyle startingStyles
# Enum indicating the type of a CSS rule, used to represent the order of a style rule's ancestors.
# This list only contains rule types that are collected during the ancestor rule collection.
@@ -1809,6 +1812,7 @@ experimental domain CSS
LayerRule
ScopeRule
StyleRule
+ StartingStyleRule
# CSS coverage information.
type RuleUsage extends object
@@ -1951,6 +1955,8 @@ experimental domain CSS
optional DOM.PhysicalAxes physicalAxes
# Optional logical axes queried for the container.
optional DOM.LogicalAxes logicalAxes
+ # true if the query contains scroll-state() queries.
+ optional boolean queriesScrollState
# CSS Supports at-rule descriptor.
experimental type CSSSupports extends object
@@ -1987,6 +1993,15 @@ experimental domain CSS
# Identifier of the stylesheet containing this object (if exists).
optional StyleSheetId styleSheetId
+ # CSS Starting Style at-rule descriptor.
+ experimental type CSSStartingStyle extends object
+ properties
+ # The associated rule header range in the enclosing stylesheet (if
+ # available).
+ optional SourceRange range
+ # Identifier of the stylesheet containing this object (if exists).
+ optional StyleSheetId styleSheetId
+
# CSS Layer data.
experimental type CSSLayerData extends object
properties
@@ -3387,15 +3402,17 @@ domain DOM
optional NodeId nodeId
# Returns the query container of the given node based on container query
- # conditions: containerName, physical, and logical axes. If no axes are
- # provided, the style container is returned, which is the direct parent or the
- # closest element with a matching container-name.
+ # conditions: containerName, physical and logical axes, and whether it queries
+ # scroll-state. If no axes are provided and queriesScrollState is false, the
+ # style container is returned, which is the direct parent or the closest
+ # element with a matching container-name.
experimental command getContainerForNode
parameters
NodeId nodeId
optional string containerName
optional PhysicalAxes physicalAxes
optional LogicalAxes logicalAxes
+ optional boolean queriesScrollState
returns
# The container node for the given node, or null if not found.
optional NodeId nodeId
Roll protocol to r1376096 — 2024-10-31T04:30:05.000Z
@@ browser_protocol.pdl:11720 @@ experimental domain WebAudio
suspended
running
closed
+ interrupted
# Enum of AudioNode types
type NodeType extends string
Roll protocol to r1375038 — 2024-10-29T04:29:43.000Z
@@ browser_protocol.pdl:10715 @@ experimental domain Storage
SignedInt64AsBase10 destinationLimitPriority
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
optional AttributionScopesData scopesData
+ integer maxEventLevelReports
experimental type AttributionReportingSourceRegistrationResult extends string
enum
Roll protocol to r1373723 — 2024-10-25T04:30:25.000Z
@@ browser_protocol.pdl:8095 @@ domain Page
encrypted-media
execution-while-out-of-viewport
execution-while-not-rendered
- fenced-frame-unpartitioned-data
+ fenced-unpartitioned-storage-read
focus-without-user-activation
fullscreen
frobulate
Roll protocol to r1371839 — 2024-10-22T04:29:59.000Z
@@ browser_protocol.pdl:2677 @@ domain DOM
enum
first-line
first-letter
+ check
before
after
marker
@@ -8094,6 +8095,7 @@ domain Page
encrypted-media
execution-while-out-of-viewport
execution-while-not-rendered
+ fenced-frame-unpartitioned-data
focus-without-user-activation
fullscreen
frobulate
Roll protocol to r1368592 — 2024-10-15T04:29:39.000Z
@@ browser_protocol.pdl:2709 @@ domain DOM
placeholder
file-selector-button
details-content
- select-fallback-button
- select-fallback-button-text
picker
# Shadow root type.
@@ -9520,6 +9518,7 @@ domain Page
EmbedderExtensionMessagingForOpenPort
EmbedderExtensionSentMessageToCachedFrame
RequestedByWebViewClient
+ PostMessageByWebViewClient
# Types of not restored reasons for back-forward cache.
experimental type BackForwardCacheNotRestoredReasonType extends string
Roll protocol to r1367902 — 2024-10-12T04:29:12.000Z
@@ browser_protocol.pdl:12431 @@ experimental domain Preload
SlowNetwork
OtherPrerenderedPageActivated
V8OptimizerDisabled
+ PrerenderFailedDuringPrefetch
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1366620 — 2024-10-10T04:29:17.000Z
@@ browser_protocol.pdl:918 @@ experimental domain Audits
ThirdPartyCookiesBlocked
NotSignedInWithIdp
MissingTransientUserActivation
- ReplacedByButtonMode
+ ReplacedByActiveMode
InvalidFieldsSpecified
RelyingPartyOriginIsOpaque
TypeNotMatching
Roll protocol to r1363470 — 2024-10-03T04:29:46.000Z
@@ browser_protocol.pdl:11993 @@ experimental domain WebAuthn
# flag set to this value. Defaults to the authenticator's
# defaultBackupState value.
optional boolean backupState
+ # The credential's user.name property. Equivalent to empty if not set.
+ # https://w3c.github.io/webauthn/#dom-publickeycredentialentity-name
+ optional string userName
+ # The credential's user.displayName property. Equivalent to empty if
+ # not set.
+ # https://w3c.github.io/webauthn/#dom-publickeycredentialuserentity-displayname
+ optional string userDisplayName
# Enable the WebAuthn domain and start intercepting credential storage and
# retrieval with a virtual authenticator.
@@ -12096,6 +12103,20 @@ experimental domain WebAuthn
AuthenticatorId authenticatorId
Credential credential
+ # Triggered when a credential is deleted, e.g. through
+ # PublicKeyCredential.signalUnknownCredential().
+ event credentialDeleted
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+
+ # Triggered when a credential is updated, e.g. through
+ # PublicKeyCredential.signalCurrentUserDetails().
+ event credentialUpdated
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
# Triggered when a credential is used in a webauthn assertion.
event credentialAsserted
parameters
@@ -12409,6 +12430,7 @@ experimental domain Preload
WindowClosed
SlowNetwork
OtherPrerenderedPageActivated
+ V8OptimizerDisabled
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1362837 — 2024-10-02T04:29:26.000Z
@@ js_protocol.pdl:369 @@ domain Debugger
# call stacks (default).
integer maxDepth
+ # Replace previous blackbox execution contexts with passed ones. Forces backend to skip
+ # stepping/pausing in scripts in these execution contexts. VM will try to leave blackboxed script by
+ # performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
+ experimental command setBlackboxExecutionContexts
+ parameters
+ # Array of execution context unique ids for the debugger to ignore.
+ array of string uniqueIds
+
# 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.
@@ -376,6 +384,8 @@ domain Debugger
parameters
# Array of regexps that will be used to check script url for blackbox state.
array of string patterns
+ # If true, also ignore scripts with no source url.
+ optional boolean skipAnonymous
# 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.
Roll protocol to r1359167 — 2024-09-24T04:29:20.000Z
@@ js_protocol.pdl:606 @@ domain Debugger
properties
# Type of the debug symbols.
enum type
- None
SourceMap
EmbeddedDWARF
ExternalDWARF
@@ -689,8 +688,8 @@ domain Debugger
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
+ # If the scriptLanguage is WebAssembly, the source of debug symbols for the module.
+ experimental optional array of Debugger.DebugSymbols debugSymbols
# The name the embedder supplied for this script.
experimental optional string embedderName
Roll protocol to r1358005 — 2024-09-20T04:28:44.000Z
@@ browser_protocol.pdl:8090 @@ domain Page
deferred-fetch
digital-credentials-get
direct-sockets
+ direct-sockets-private
display-capture
document-domain
encrypted-media
Roll protocol to r1356896 — 2024-09-18T04:29:10.000Z
@@ browser_protocol.pdl:7925 @@ experimental domain Overlay
# True for showing hit-test borders
boolean show
- # Request that backend shows an overlay with web vital metrics.
- command setShowWebVitals
+ # Deprecated, no longer has any effect.
+ deprecated command setShowWebVitals
parameters
boolean show
Roll protocol to r1356270 — 2024-09-17T04:27:33.000Z
@@ browser_protocol.pdl:532 @@ experimental domain Audits
WarnDomainNonASCII
WarnThirdPartyPhaseout
WarnCrossSiteRedirectDowngradeChangesInclusion
+ WarnDeprecationTrialMetadata
+ WarnThirdPartyCookieHeuristic
type CookieOperation extends string
enum
@@ -4221,7 +4223,6 @@ domain Emulation
gyroscope
linear-acceleration
magnetometer
- proximity
relative-orientation
experimental type SensorMetadata extends object
Roll protocol to r1354347 — 2024-09-12T04:29:25.000Z
@@ browser_protocol.pdl:2679 @@ domain DOM
after
marker
backdrop
+ column
selection
search-text
target-text
Roll protocol to r1352404 — 2024-09-07T04:28:15.000Z
@@ browser_protocol.pdl:6385 @@ domain Network
StorageAccess
# The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
TopLevelStorageAccess
- # The cookie should have been blocked by 3PCD but is exempted by CORS opt-in.
- CorsOptIn
# The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
Scheme
Roll protocol to r1351223 — 2024-09-05T04:28:35.000Z
@@ browser_protocol.pdl:2703 @@ domain DOM
view-transition-image-pair
view-transition-old
view-transition-new
+ placeholder
+ file-selector-button
+ details-content
+ select-fallback-button
+ select-fallback-button-text
+ picker
# Shadow root type.
type ShadowRootType extends string
@@ -8079,6 +8085,7 @@ domain Page
clipboard-read
clipboard-write
compute-pressure
+ controlled-frame
cross-origin-isolated
deferred-fetch
digital-credentials-get
Roll protocol to r1349977 — 2024-09-03T04:28:26.000Z
@@ browser_protocol.pdl:2807 @@ domain DOM
optional boolean isSVG
optional CompatibilityMode compatibilityMode
optional BackendNode assignedSlot
+ experimental optional boolean isScrollable
# A structure to hold the top-level node of a detached tree and an array of its retained descendants.
type DetachedElementInfo extends object
@@ -3496,6 +3497,14 @@ domain DOM
# Called when top layer elements are changed.
experimental event topLayerElementsUpdated
+ # Fired when a node's scrollability state changes.
+ experimental event scrollableFlagUpdated
+ parameters
+ # The id of the node.
+ DOM.NodeId nodeId
+ # If the node is scrollable.
+ boolean isScrollable
+
# Called when a pseudo element is removed from an element.
experimental event pseudoElementRemoved
parameters
Roll protocol to r1349043 — 2024-08-30T04:28:39.000Z
@@ browser_protocol.pdl:10668 @@ experimental domain Storage
array of AttributionReportingAggregatableDebugReportingData debugData
optional string aggregationCoordinatorOrigin
+ experimental type AttributionScopesData extends object
+ properties
+ array of string values
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number limit
+ number maxEventStates
+
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
@@ -10688,6 +10696,7 @@ experimental domain Storage
AttributionReportingTriggerDataMatching triggerDataMatching
SignedInt64AsBase10 destinationLimitPriority
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
+ optional AttributionScopesData scopesData
experimental type AttributionReportingSourceRegistrationResult extends string
enum
@@ -10764,6 +10773,7 @@ experimental domain Storage
AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
optional string triggerContextId
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
+ array of string scopes
experimental type AttributionReportingEventLevelResult extends string
enum
@@ -12415,7 +12425,6 @@ experimental domain Preload
PrefetchFailedMIMENotSupported
PrefetchFailedNetError
PrefetchFailedNon2XX
- PrefetchFailedPerPageLimitExceeded
PrefetchEvictedAfterCandidateRemoved
PrefetchEvictedForNewerPrefetch
PrefetchHeldback
Roll protocol to r1348440 — 2024-08-29T04:28:12.000Z
@@ browser_protocol.pdl:9220 @@ domain Page
# A new frame target will be created (see Target.attachedToTarget).
swap
+ # Fired before frame subtree is detached. Emitted before any frame of the
+ # subtree is actually detached.
+ experimental event frameSubtreeWillBeDetached
+ parameters
+ # Id of the frame that is the root of the subtree that will be detached.
+ FrameId frameId
+
# The type of a frameNavigated event.
experimental type NavigationType extends string
enum
Roll protocol to r1347815 — 2024-08-28T04:28:21.000Z
@@ browser_protocol.pdl:10696 @@ experimental domain Storage
destinationBothLimitsReached
reportingOriginsPerSiteLimitReached
exceedsMaxChannelCapacity
+ exceedsMaxScopesChannelCapacity
exceedsMaxTriggerStateCardinality
+ exceedsMaxEventStatesLimit
destinationPerDayReportingLimitReached
experimental event attributionReportingSourceRegistered
Roll protocol to r1347151 — 2024-08-27T04:29:22.000Z
@@ browser_protocol.pdl:743 @@ experimental domain Audits
NoRegisterTriggerHeader
NoRegisterOsSourceHeader
NoRegisterOsTriggerHeader
+ NavigationRegistrationUniqueScopeAlreadySet
type SharedDictionaryError extends string
enum
@@ -5523,12 +5524,21 @@ experimental domain Memory
moderate
critical
+ # Retruns current DOM object counters.
command getDOMCounters
returns
integer documents
integer nodes
integer jsEventListeners
+ # Retruns DOM object counters after preparing renderer for leak detection.
+ command getDOMCountersForLeakDetection
+ returns
+ # DOM object counters.
+ array of DOMCounter counters
+
+ # Prepares for leak detection by terminating workers, stopping spellcheckers,
+ # dropping non-essential internal caches, running garbage collections, etc.
command prepareForLeakDetection
# Simulate OomIntervention by purging V8 memory.
@@ -5604,6 +5614,15 @@ experimental domain Memory
# Size of the module in bytes.
number size
+ # DOM object counter data.
+ type DOMCounter extends object
+ properties
+ # Object name. Note: object names should be presumed volatile and clients should not expect
+ # the returned names to be consistent across runs.
+ string name
+ # Object count.
+ integer count
+
# 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.
domain Network
@@ -6341,6 +6360,8 @@ domain Network
TPCDMetadata
# The cookie should have been blocked by 3PCD but is exempted by Deprecation Trial mitigation.
TPCDDeprecationTrial
+ # The cookie should have been blocked by 3PCD but is exempted by Top-level Deprecation Trial mitigation.
+ TopLevelTPCDDeprecationTrial
# The cookie should have been blocked by 3PCD but is exempted by heuristics mitigation.
TPCDHeuristics
# The cookie should have been blocked by 3PCD but is exempted by Enterprise Policy.
Roll protocol to r1346313 — 2024-08-24T04:27:30.000Z
@@ browser_protocol.pdl:1392 @@ domain Browser
videoCapturePanTiltZoom
wakeLockScreen
wakeLockSystem
+ webAppInstallation
windowManagement
experimental type PermissionSetting extends string
@@ -8098,6 +8099,7 @@ domain Page
usb
usb-unrestricted
vertical-scroll
+ web-app-installation
web-printing
web-share
window-management
Roll protocol to r1345247 — 2024-08-22T04:27:41.000Z
@@ browser_protocol.pdl:8077 @@ domain Page
otp-credentials
payment
picture-in-picture
+ popins
private-aggregation
private-state-token-issuance
private-state-token-redemption
@@ -9453,6 +9454,7 @@ domain Page
ContentWebUSB
ContentMediaSessionService
ContentScreenReader
+ ContentDiscarded
# See components/back_forward_cache/back_forward_cache_disable.h for explanations.
EmbedderPopupBlockerTabHelper
Roll protocol to r1344581 — 2024-08-21T04:28:14.000Z
@@ browser_protocol.pdl:9453 @@ domain Page
ContentWebUSB
ContentMediaSessionService
ContentScreenReader
- ContentDiscarded
# See components/back_forward_cache/back_forward_cache_disable.h for explanations.
EmbedderPopupBlockerTabHelper
Roll protocol to r1343927 — 2024-08-20T04:30:10.000Z
@@ browser_protocol.pdl:9453 @@ domain Page
ContentWebUSB
ContentMediaSessionService
ContentScreenReader
+ ContentDiscarded
# See components/back_forward_cache/back_forward_cache_disable.h for explanations.
EmbedderPopupBlockerTabHelper
Roll protocol to r1342118 — 2024-08-15T04:27:44.000Z
@@ browser_protocol.pdl:1151 @@ experimental domain Extensions
string id
# StorageArea to remove data from.
StorageArea storageArea
+ # Sets `values` in extension storage in the given `storageArea`. The provided `values`
+ # will be merged with existing values in the storage area.
+ command setStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to set data in.
+ StorageArea storageArea
+ # Values to set.
+ object values
# Defines commands and events for Autofill.
experimental domain Autofill
Roll protocol to r1341448 — 2024-08-14T04:27:41.000Z
@@ browser_protocol.pdl:1123 @@ experimental domain Extensions
returns
# Extension id.
string id
- # Gets data from extension storage in the given `area`. If `keys` is
+ # Gets data from extension storage in the given `storageArea`. If `keys` is
# specified, these are used to filter the result.
command getStorageItems
parameters
@@ -1135,6 +1135,22 @@ experimental domain Extensions
optional array of string keys
returns
object data
+ # Removes `keys` from extension storage in the given `storageArea`.
+ command removeStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to remove data from.
+ StorageArea storageArea
+ # Keys to remove.
+ array of string keys
+ # Clears extension storage in the given `storageArea`.
+ command clearStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to remove data from.
+ StorageArea storageArea
# Defines commands and events for Autofill.
experimental domain Autofill
Roll protocol to r1340018 — 2024-08-10T04:28:25.000Z
@@ browser_protocol.pdl:9512 @@ domain Page
FrameId frameId
# Frame's new url.
string url
+ # Navigation type
+ enum navigationType
+ # Navigation due to fragment navigation.
+ fragment
+ # Navigation due to history API usage.
+ historyApi
+ # Navigation due to other reasons.
+ other
+
# Compressed image data requested by the `startScreencast`.
experimental event screencastFrame
Roll protocol to r1339468 — 2024-08-09T04:27:55.000Z
@@ browser_protocol.pdl:2780 @@ domain DOM
optional CompatibilityMode compatibilityMode
optional BackendNode assignedSlot
+ # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
+ type DetachedElementInfo extends object
+ properties
+ Node treeNode
+ array of NodeId retainedNodeIds
+
# A structure holding an RGBA color.
type RGBA extends object
properties
@@ -3290,6 +3296,12 @@ domain DOM
returns
string path
+ # Returns list of detached nodes
+ experimental command getDetachedDomNodes
+ returns
+ # The list of detached nodes
+ array of DetachedElementInfo detachedNodes
+
# Enables console to refer to the node with given id via $x (see Command Line API for more details
# $x functions).
experimental command setInspectedNode
Roll protocol to r1338866 — 2024-08-08T04:29:00.000Z
@@ browser_protocol.pdl:2660 @@ domain DOM
first-line-inherited
scroll-marker
scroll-marker-group
+ scroll-next-button
+ scroll-prev-button
scrollbar
scrollbar-thumb
scrollbar-button
Roll protocol to r1338258 — 2024-08-07T04:28:16.000Z
@@ browser_protocol.pdl:8369 @@ domain Page
experimental type ClientNavigationReason extends string
enum
+ anchorClick
formSubmissionGet
formSubmissionPost
httpHeaderRefresh
- scriptInitiated
+ initialFrameNavigation
metaTagRefresh
+ other
pageBlockInterstitial
reload
- anchorClick
+ scriptInitiated
experimental type ClientNavigationDisposition extends string
enum
Roll protocol to r1337664 — 2024-08-06T04:28:23.000Z
@@ browser_protocol.pdl:12612 @@ experimental domain PWA
# supported yet.
optional boolean linkCapturing
optional DisplayMode displayMode
+
+# This domain allows configuring virtual Bluetooth devices to test
+# the web-bluetooth API.
+experimental domain BluetoothEmulation
+ # Indicates the various states of Central.
+ type CentralState extends string
+ enum
+ absent
+ powered-off
+ powered-on
+
+ # Stores the manufacturer data
+ type ManufacturerData extends object
+ properties
+ # Company identifier
+ # https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
+ # https://usb.org/developers
+ integer key
+ # Manufacturer-specific data
+ binary data
+
+ # Stores the byte data of the advertisement packet sent by a Bluetooth device.
+ type ScanRecord extends object
+ properties
+ optional string name
+ optional array of string uuids
+ # Stores the external appearance description of the device.
+ optional integer appearance
+ # Stores the transmission power of a broadcasting device.
+ optional integer txPower
+ # Key is the company identifier and the value is an array of bytes of
+ # manufacturer specific data.
+ optional array of ManufacturerData manufacturerData
+
+ # Stores the advertisement packet information that is sent by a Bluetooth device.
+ type ScanEntry extends object
+ properties
+ string deviceAddress
+ integer rssi
+ ScanRecord scanRecord
+
+ # Enable the BluetoothEmulation domain.
+ command enable
+ parameters
+ # State of the simulated central.
+ CentralState state
+
+ # Disable the BluetoothEmulation domain.
+ command disable
+
+ # Simulates a peripheral with |address|, |name| and |knownServiceUuids|
+ # that has already been connected to the system.
+ command simulatePreconnectedPeripheral
+ parameters
+ string address
+ string name
+ array of ManufacturerData manufacturerData
+ array of string knownServiceUuids
+
+ # Simulates an advertisement packet described in |entry| being received by
+ # the central.
+ command simulateAdvertisement
+ parameters
+ ScanEntry entry
Roll protocol to r1336433 — 2024-08-02T04:28:52.000Z
@@ browser_protocol.pdl:2030 @@ experimental domain CSS
# Associated style declaration.
CSSStyle style
- # CSS position-fallback rule representation.
- deprecated type CSSPositionFallbackRule extends object
- properties
- Value name
- # List of keyframes.
- array of CSSTryRule tryRules
-
# CSS @position-try rule representation.
type CSSPositionTryRule extends object
properties
@@ -2223,8 +2216,6 @@ experimental domain CSS
optional array of InheritedPseudoElementMatches inheritedPseudoElements
# A list of CSS keyframed animations matching this node.
optional array of CSSKeyframesRule cssKeyframesRules
- # A list of CSS position fallbacks matching this node.
- deprecated optional array of CSSPositionFallbackRule cssPositionFallbackRules
# A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
optional array of CSSPositionTryRule cssPositionTryRules
# Index of the active fallback in the applied position-try-fallback property,
Roll protocol to r1335233 — 2024-07-31T04:25:01.000Z
@@ browser_protocol.pdl:1102 @@ experimental domain Audits
parameters
InspectorIssue issue
-# Defines commands and events for browser extensions. Available if the client
-# is connected using the --remote-debugging-pipe flag and
-# the --enable-unsafe-extension-debugging flag is set.
+# Defines commands and events for browser extensions.
experimental domain Extensions
+ # Storage areas.
+ type StorageArea extends string
+ enum
+ session
+ local
+ sync
+ managed
# Installs an unpacked extension from the filesystem similar to
# --load-extension CLI flags. Returns extension ID once the extension
- # has been installed.
+ # has been installed. Available if the client is connected using the
+ # --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
+ # flag is set.
command loadUnpacked
parameters
# Absolute file path.
@@ -1116,6 +1123,18 @@ experimental domain Extensions
returns
# Extension id.
string id
+ # Gets data from extension storage in the given `area`. If `keys` is
+ # specified, these are used to filter the result.
+ command getStorageItems
+ parameters
+ # ID of extension.
+ string id
+ # StorageArea to retrieve data from.
+ StorageArea storageArea
+ # Keys to retrieve.
+ optional array of string keys
+ returns
+ object data
# Defines commands and events for Autofill.
experimental domain Autofill
@@ -7964,6 +7983,7 @@ domain Page
experimental type PermissionsPolicyFeature extends string
enum
accelerometer
+ all-screens-capture
ambient-light-sensor
attribution-reporting
autoplay
@@ -12285,6 +12305,7 @@ experimental domain Preload
AllPrerenderingCanceled
WindowClosed
SlowNetwork
+ OtherPrerenderedPageActivated
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1334619 — 2024-07-30T04:27:32.000Z
@@ browser_protocol.pdl:12284 @@ experimental domain Preload
JavaScriptInterfaceRemoved
AllPrerenderingCanceled
WindowClosed
+ SlowNetwork
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1333880 — 2024-07-27T04:27:46.000Z
@@ browser_protocol.pdl:8020 @@ domain Page
keyboard-map
local-fonts
magnetometer
+ media-playback-while-not-visible
microphone
midi
otp-credentials
Roll protocol to r1330662 — 2024-07-20T04:28:07.000Z
@@ browser_protocol.pdl:4185 @@ domain Emulation
optional SensorReadingXYZ xyz
optional SensorReadingQuaternion quaternion
+ experimental type PressureSource extends string
+ enum
+ cpu
+
+ experimental type PressureState extends string
+ enum
+ nominal
+ fair
+ serious
+ critical
+
+ experimental type PressureMetadata extends object
+ properties
+ optional boolean available
+
# Tells whether emulation is supported.
deprecated command canEmulate
returns
@@ -4354,6 +4369,24 @@ domain Emulation
SensorType type
SensorReading reading
+ # Overrides a pressure source of a given type, as used by the Compute
+ # Pressure API, so that updates to PressureObserver.observe() are provided
+ # via setPressureStateOverride instead of being retrieved from
+ # platform-provided telemetry data.
+ experimental command setPressureSourceOverrideEnabled
+ parameters
+ boolean enabled
+ PressureSource source
+ optional PressureMetadata metadata
+
+ # Provides a given pressure state that will be processed and eventually be
+ # delivered to PressureObserver users. |source| must have been previously
+ # overridden by setPressureSourceOverrideEnabled.
+ experimental command setPressureStateOverride
+ parameters
+ PressureSource source
+ PressureState state
+
# Overrides the Idle state.
command setIdleOverride
parameters
Roll protocol to r1327118 — 2024-07-13T04:27:09.000Z
@@ browser_protocol.pdl:10523 @@ experimental domain Storage
exact
modulus
+ experimental type AttributionReportingAggregatableDebugReportingData extends object
+ properties
+ UnsignedInt128AsBase16 keyPiece
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number value
+ array of string types
+
+ experimental type AttributionReportingAggregatableDebugReportingConfig extends object
+ properties
+ # number instead of integer because not all uint32 can be represented by
+ # int, only present for source registrations
+ optional number budget
+ UnsignedInt128AsBase16 keyPiece
+ array of AttributionReportingAggregatableDebugReportingData debugData
+ optional string aggregationCoordinatorOrigin
+
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
@@ -10542,6 +10559,7 @@ experimental domain Storage
optional UnsignedInt64AsBase10 debugKey
AttributionReportingTriggerDataMatching triggerDataMatching
SignedInt64AsBase10 destinationLimitPriority
+ AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
experimental type AttributionReportingSourceRegistrationResult extends string
enum
@@ -10615,6 +10633,7 @@ experimental domain Storage
optional string aggregationCoordinatorOrigin
AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
optional string triggerContextId
+ AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
experimental type AttributionReportingEventLevelResult extends string
enum
Roll protocol to r1326544 — 2024-07-12T04:27:03.000Z
@@ browser_protocol.pdl:10541 @@ experimental domain Storage
array of AttributionReportingAggregationKeysEntry aggregationKeys
optional UnsignedInt64AsBase10 debugKey
AttributionReportingTriggerDataMatching triggerDataMatching
+ SignedInt64AsBase10 destinationLimitPriority
experimental type AttributionReportingSourceRegistrationResult extends string
enum
Roll protocol to r1325906 — 2024-07-11T04:28:25.000Z
@@ browser_protocol.pdl:2208 @@ experimental domain CSS
deprecated optional array of CSSPositionFallbackRule cssPositionFallbackRules
# A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
optional array of CSSPositionTryRule cssPositionTryRules
+ # Index of the active fallback in the applied position-try-fallback property,
+ # will not be set if there is no active position-try fallback.
+ optional integer activePositionFallbackIndex
# A list of CSS at-property rules matching this node.
optional array of CSSPropertyRule cssPropertyRules
# A list of CSS property registrations matching this node.
@@ -7215,6 +7218,7 @@ domain Network
UnsafeNone
SameOriginPlusCoep
RestrictPropertiesPlusCoep
+ NoopenerAllowPopups
experimental type CrossOriginOpenerPolicyStatus extends object
properties
Roll protocol to r1325288 — 2024-07-10T04:27:56.000Z
@@ browser_protocol.pdl:803 @@ experimental domain Audits
type GenericIssueErrorType extends string
enum
- CrossOriginPortalPostMessageError
FormLabelForNameError
FormDuplicateIdForInputError
FormInputWithNoLabelError
@@ -9331,7 +9330,6 @@ domain Page
Printing
WebDatabase
PictureInPicture
- Portal
SpeechRecognizer
IdleManager
PaymentManager
@@ -10839,7 +10837,7 @@ domain Target
experimental optional Page.FrameId openerFrameId
experimental optional Browser.BrowserContextID browserContextId
# Provides additional details for specific target types. For example, for
- # the type of "page", this may be set to "portal" or "prerender".
+ # the type of "page", this may be set to "prerender".
experimental optional string subtype
# A filter used by target query/discovery/auto-attach operations.
@@ -12227,6 +12225,7 @@ experimental domain Preload
JavaScriptInterfaceAdded
JavaScriptInterfaceRemoved
AllPrerenderingCanceled
+ WindowClosed
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1324661 — 2024-07-09T04:27:20.000Z
@@ browser_protocol.pdl:4560 @@ domain IO
# UUID of the specified Blob.
string uuid
+experimental domain FileSystem
+ depends on Network
+ depends on Storage
+
+ type File extends object
+ properties
+ string name
+ # Timestamp
+ Network.TimeSinceEpoch lastModified
+ # Size in bytes
+ number size
+ string type
+
+ type Directory extends object
+ properties
+ string name
+ array of string nestedDirectories
+ # Files that are directly nested under this directory.
+ array of File nestedFiles
+
+ type BucketFileSystemLocator extends object
+ properties
+ # Storage key
+ Storage.SerializedStorageKey storageKey
+ # Bucket name. Not passing a `bucketName` will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
+ optional string bucketName
+ # Path to the directory using each path component as an array item.
+ array of string pathComponents
+
+ command getDirectory
+ parameters
+ BucketFileSystemLocator bucketFileSystemLocator
+ returns
+ # Returns the directory object at the path.
+ Directory directory
+
experimental domain IndexedDB
depends on Runtime
depends on Storage
@@ -10537,6 +10573,8 @@ experimental domain Storage
# number instead of integer because not all uint32 can be represented by
# int
number value
+ UnsignedInt64AsBase10 filteringId
+
experimental type AttributionReportingAggregatableValueEntry extends object
properties
@@ -10569,6 +10607,7 @@ experimental domain Storage
array of AttributionReportingEventTriggerData eventTriggerData
array of AttributionReportingAggregatableTriggerData aggregatableTriggerData
array of AttributionReportingAggregatableValueEntry aggregatableValues
+ integer aggregatableFilteringIdMaxBytes
boolean debugReporting
optional string aggregationCoordinatorOrigin
AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
Roll protocol to r1323829 — 2024-07-06T04:27:22.000Z
@@ browser_protocol.pdl:7927 @@ domain Page
compute-pressure
cross-origin-isolated
deferred-fetch
+ digital-credentials-get
direct-sockets
display-capture
document-domain
Roll protocol to r1323532 — 2024-07-05T04:28:00.000Z
@@ browser_protocol.pdl:2207 @@ experimental domain CSS
optional array of CSSKeyframesRule cssKeyframesRules
# A list of CSS position fallbacks matching this node.
deprecated optional array of CSSPositionFallbackRule cssPositionFallbackRules
- # A list of CSS @position-try rules matching this node, based on the position-try-options property.
+ # A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
optional array of CSSPositionTryRule cssPositionTryRules
# A list of CSS at-property rules matching this node.
optional array of CSSPropertyRule cssPropertyRules
Roll protocol to r1323165 — 2024-07-04T04:27:18.000Z
@@ browser_protocol.pdl:2031 @@ experimental domain CSS
StyleSheetOrigin origin
# Associated style declaration.
CSSStyle style
+ boolean active
# CSS keyframes rule representation.
type CSSKeyframesRule extends object
Roll protocol to r1319565 — 2024-06-26T04:28:01.000Z
@@ browser_protocol.pdl:12426 @@ experimental domain PWA
# manifestId.
optional string installUrlOrBundleUrl
- # Uninstals the given manifest_id and closes any opened app windows.
+ # Uninstalls the given manifest_id and closes any opened app windows.
command uninstall
parameters
string manifestId
@@ -12448,7 +12448,7 @@ experimental domain PWA
# used to attach to via Target.attachToTarget or similar APIs.
# If some files in the parameters cannot be handled by the web app, they will
# be ignored. If none of the files can be handled, this API returns an error.
- # If no files provided as the parameter, this API also returns an error.
+ # If no files are provided as the parameter, this API also returns an error.
#
# According to the definition of the file handlers in the manifest file, one
# Target.TargetID may represent a page handling one or more files. The order
@@ -12465,7 +12465,39 @@ experimental domain PWA
# Opens the current page in its web app identified by the manifest id, needs
# to be called on a page target. This function returns immediately without
- # waiting for the app finishing loading.
+ # waiting for the app to finish loading.
command openCurrentPageInApp
parameters
string manifestId
+
+ # If user prefers opening the app in browser or an app window.
+ type DisplayMode extends string
+ enum
+ standalone
+ browser
+
+ # Changes user settings of the web app identified by its manifestId. If the
+ # app was not installed, this command returns an error. Unset parameters will
+ # be ignored; unrecognized values will cause an error.
+ #
+ # Unlike the ones defined in the manifest files of the web apps, these
+ # settings are provided by the browser and controlled by the users, they
+ # impact the way the browser handling the web apps.
+ #
+ # See the comment of each parameter.
+ command changeAppUserSettings
+ parameters
+ string manifestId
+ # If user allows the links clicked on by the user in the app's scope, or
+ # extended scope if the manifest has scope extensions and the flags
+ # `DesktopPWAsLinkCapturingWithScopeExtensions` and
+ # `WebAppEnableScopeExtensions` are enabled.
+ #
+ # Note, the API does not support resetting the linkCapturing to the
+ # initial value, uninstalling and installing the web app again will reset
+ # it.
+ #
+ # TODO(crbug.com/339453269): Setting this value on ChromeOS is not
+ # supported yet.
+ optional boolean linkCapturing
+ optional DisplayMode displayMode
Roll protocol to r1317765 — 2024-06-21T04:27:31.000Z
@@ browser_protocol.pdl:892 @@ experimental domain Audits
ClientMetadataNoResponse
ClientMetadataInvalidResponse
ClientMetadataInvalidContentType
+ IdpNotPotentiallyTrustworthy
DisabledInSettings
+ DisabledInFlags
ErrorFetchingSignin
InvalidSigninResponse
AccountsHttpNotFound
@@ -915,6 +917,7 @@ experimental domain Audits
NotSignedInWithIdp
MissingTransientUserActivation
ReplacedByButtonMode
+ InvalidFieldsSpecified
RelyingPartyOriginIsOpaque
TypeNotMatching
@@ -7121,6 +7124,9 @@ domain Network
# The number of obtained Trust Tokens on a successful "Issuance" operation.
optional integer issuedTokenCount
+ # Fired once security policy has been updated.
+ experimental event policyUpdated
+
# Fired once when parsing the .wbn file has succeeded.
# The event contains the information about the web bundle contents.
experimental event subresourceWebBundleMetadataReceived
Roll protocol to r1317198 — 2024-06-20T04:26:46.000Z
@@ browser_protocol.pdl:1367 @@ domain Browser
optional boolean userVisibleOnly
# For "clipboard" permission, may specify allowWithoutSanitization.
optional boolean allowWithoutSanitization
+ # For "fullscreen" permission, must specify allowWithoutGesture:true.
+ optional boolean allowWithoutGesture
# For "camera" permission, may specify panTiltZoom.
optional boolean panTiltZoom
@@ -7119,9 +7121,6 @@ domain Network
# The number of obtained Trust Tokens on a successful "Issuance" operation.
optional integer issuedTokenCount
- # Fired once security policy has been updated.
- experimental event policyUpdated
-
# Fired once when parsing the .wbn file has succeeded.
# The event contains the information about the web bundle contents.
experimental event subresourceWebBundleMetadataReceived
Roll protocol to r1316850 — 2024-06-19T04:27:32.000Z
@@ browser_protocol.pdl:7119 @@ domain Network
# The number of obtained Trust Tokens on a successful "Issuance" operation.
optional integer issuedTokenCount
+ # Fired once security policy has been updated.
+ experimental event policyUpdated
+
# Fired once when parsing the .wbn file has succeeded.
# The event contains the information about the web bundle contents.
experimental event subresourceWebBundleMetadataReceived
Roll protocol to r1315554 — 2024-06-15T04:28:24.000Z
@@ browser_protocol.pdl:156 @@ experimental domain Accessibility
flowto
labelledby
owns
+ url
# A node in the accessibility tree.
type AXNode extends object
@@ -10508,6 +10509,7 @@ experimental domain Storage
reportingOriginsPerSiteLimitReached
exceedsMaxChannelCapacity
exceedsMaxTriggerStateCardinality
+ destinationPerDayReportingLimitReached
experimental event attributionReportingSourceRegistered
parameters
Roll protocol to r1312386 — 2024-06-08T04:27:15.000Z
@@ browser_protocol.pdl:915 @@ experimental domain Audits
MissingTransientUserActivation
ReplacedByButtonMode
RelyingPartyOriginIsOpaque
+ TypeNotMatching
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -6075,7 +6076,7 @@ domain Network
# An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
# This is a temporary ability and it will be removed in the future.
experimental integer sourcePort
- # Cookie partition key.
+ # Cookie partition key.
experimental optional CookiePartitionKey partitionKey
# True if cookie partition key is opaque.
experimental optional boolean partitionKeyOpaque
@@ -6496,8 +6497,8 @@ domain Network
optional string domain
# If specified, deletes only cookies with the exact path.
optional string path
- # If specified, deletes only cookies with the the given name and partitionKey where
- # where all partition key attributes match the cookie partition key attribute.
+ # If specified, deletes only cookies with the the given name and partitionKey where
+ # all partition key attributes match the cookie partition key attribute.
experimental optional CookiePartitionKey partitionKey
# Disables network tracking, prevents network events from being sent to the client.
@@ -9248,6 +9249,11 @@ domain Page
HTTPAuthRequired
CookieFlushed
BroadcastChannelOnMessage
+ WebViewSettingsChanged
+ WebViewJavaScriptObjectChanged
+ WebViewMessageListenerInjected
+ WebViewSafeBrowsingAllowlistChanged
+ WebViewDocumentStartJavascriptChanged
#Blocklisted features
WebSocket
WebTransport
Roll protocol to r1311068 — 2024-06-06T04:27:10.000Z
@@ browser_protocol.pdl:6032 @@ domain Network
# Set if another request triggered this request (e.g. preflight).
optional RequestId requestId
+ # cookiePartitionKey object
+ # The representation of the components of the key that are created by the cookiePartitionKey class contained in net/cookies/cookie_partition_key.h.
+ experimental type CookiePartitionKey extends object
+ properties
+ # The site of the top-level URL the browser was visiting at the start
+ # of the request to the endpoint that set the cookie.
+ string topLevelSite
+ # Indicates if the cookie has any ancestors that are cross-site to the topLevelSite.
+ boolean hasCrossSiteAncestor
+
# Cookie object
type Cookie extends object
properties
@@ -6065,9 +6075,8 @@ domain Network
# An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
# This is a temporary ability and it will be removed in the future.
experimental integer sourcePort
- # Cookie partition key. The site of the top-level URL the browser was visiting at the start
- # of the request to the endpoint that set the cookie.
- experimental optional string partitionKey
+ # Cookie partition key.
+ experimental optional CookiePartitionKey partitionKey
# True if cookie partition key is opaque.
experimental optional boolean partitionKeyOpaque
@@ -6283,10 +6292,8 @@ domain Network
# An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
# This is a temporary ability and it will be removed in the future.
experimental optional integer sourcePort
- # Cookie partition key. The site of the top-level URL the browser was visiting at the start
- # of the request to the endpoint that set the cookie.
- # If not set, the cookie will be set as not partitioned.
- experimental optional string partitionKey
+ # Cookie partition key. If not set, the cookie will be set as not partitioned.
+ experimental optional CookiePartitionKey partitionKey
# Authorization challenge for HTTP status code 401 or 407.
experimental type AuthChallenge extends object
@@ -6489,9 +6496,9 @@ domain Network
optional string domain
# If specified, deletes only cookies with the exact path.
optional string path
- # If specified, deletes only cookies with the the given name and partitionKey where domain
- # matches provided URL.
- experimental optional string partitionKey
+ # If specified, deletes only cookies with the the given name and partitionKey where
+ # where all partition key attributes match the cookie partition key attribute.
+ experimental optional CookiePartitionKey partitionKey
# Disables network tracking, prevents network events from being sent to the client.
command disable
@@ -6668,10 +6675,8 @@ domain Network
# An unspecified port value allows protocol clients to emulate legacy cookie scope for the port.
# This is a temporary ability and it will be removed in the future.
experimental optional integer sourcePort
- # Cookie partition key. The site of the top-level URL the browser was visiting at the start
- # of the request to the endpoint that set the cookie.
- # If not set, the cookie will be set as not partitioned.
- experimental optional string partitionKey
+ # Cookie partition key. If not set, the cookie will be set as not partitioned.
+ experimental optional CookiePartitionKey partitionKey
returns
# Always set to true. If an error occurs, the response indicates protocol error.
deprecated boolean success
@@ -7063,7 +7068,7 @@ domain Network
optional string headersText
# The cookie partition key that will be used to store partitioned cookies set in this response.
# Only sent when partitioned cookies are enabled.
- optional string cookiePartitionKey
+ experimental optional CookiePartitionKey cookiePartitionKey
# True if partitioned cookies are enabled, but the partition key is not serializable to string.
optional boolean cookiePartitionKeyOpaque
# A list of cookies which should have been blocked by 3PCD but are exempted and stored from
@@ -7910,6 +7915,7 @@ domain Page
clipboard-write
compute-pressure
cross-origin-isolated
+ deferred-fetch
direct-sockets
display-capture
document-domain
Roll protocol to r1310407 — 2024-06-05T04:28:24.000Z
@@ browser_protocol.pdl:622 @@ experimental domain Audits
CoopSandboxedIFrameCannotNavigateToCoopPage
CorpNotSameOrigin
CorpNotSameOriginAfterDefaultedToSameOriginByCoep
+ CorpNotSameOriginAfterDefaultedToSameOriginByDip
+ CorpNotSameOriginAfterDefaultedToSameOriginByCoepAndDip
CorpNotSameSite
# Details for a request that has been blocked with the BLOCKED_BY_RESPONSE
@@ -5755,6 +5757,8 @@ domain Network
coop-sandboxed-iframe-cannot-navigate-to-coop-page
corp-not-same-origin
corp-not-same-origin-after-defaulted-to-same-origin-by-coep
+ corp-not-same-origin-after-defaulted-to-same-origin-by-dip
+ corp-not-same-origin-after-defaulted-to-same-origin-by-coep-and-dip
corp-not-same-site
# The reason why request was blocked.
Roll protocol to r1309774 — 2024-06-04T04:27:00.000Z
@@ browser_protocol.pdl:12406 @@ experimental domain PWA
string manifestId
# Launches the installed web app, or an url in the same web app instead of the
- # default start url if it is provided. Returns a tab / web contents based
- # Target.TargetID which can be used to attach to via Target.attachToTarget or
- # similar APIs.
+ # default start url if it is provided. Returns a page Target.TargetID which
+ # can be used to attach to via Target.attachToTarget or similar APIs.
command launch
parameters
string manifestId
@@ -12419,16 +12418,15 @@ experimental domain PWA
# Opens one or more local files from an installed web app identified by its
# manifestId. The web app needs to have file handlers registered to process
- # the files. The API returns one or more tabs / web contents' based
- # Target.TargetIDs which can be used to attach to via Target.attachToTarget or
- # similar APIs.
+ # the files. The API returns one or more page Target.TargetIDs which can be
+ # used to attach to via Target.attachToTarget or similar APIs.
# If some files in the parameters cannot be handled by the web app, they will
# be ignored. If none of the files can be handled, this API returns an error.
# If no files provided as the parameter, this API also returns an error.
#
# According to the definition of the file handlers in the manifest file, one
- # Target.TargetID may represent a tab handling one or more files. The order of
- # the returned Target.TargetIDs is also not guaranteed.
+ # Target.TargetID may represent a page handling one or more files. The order
+ # of the returned Target.TargetIDs is not guaranteed.
#
# TODO(crbug.com/339454034): Check the existences of the input files.
command launchFilesInApp
@@ -12438,3 +12436,10 @@ experimental domain PWA
returns
# IDs of the tab targets created as the result.
array of Target.TargetID targetIds
+
+ # Opens the current page in its web app identified by the manifest id, needs
+ # to be called on a page target. This function returns immediately without
+ # waiting for the app finishing loading.
+ command openCurrentPageInApp
+ parameters
+ string manifestId
Roll protocol to r1308459 — 2024-05-31T04:27:42.000Z
@@ browser_protocol.pdl:7093 @@ domain Network
FailedPrecondition
ResourceExhausted
AlreadyExists
- Unavailable
+ ResourceLimited
Unauthorized
BadResponse
InternalError
Roll protocol to r1306150 — 2024-05-26T04:28:00.000Z
@@ browser_protocol.pdl:3337 @@ domain DOM
# Descendant nodes with container queries against the given container.
array of NodeId nodeIds
+ # Returns the target anchor element of the given anchor query according to
+ # https://www.w3.org/TR/css-anchor-position-1/#target.
+ experimental command getAnchorElement
+ parameters
+ # Id of the positioned element from which to find the anchor.
+ NodeId nodeId
+ # An optional anchor specifier, as defined in
+ # https://www.w3.org/TR/css-anchor-position-1/#anchor-specifier.
+ # If not provided, it will return the implicit anchor element for
+ # the given positioned element.
+ optional string anchorSpecifier
+ returns
+ # The anchor element of the given anchor query.
+ NodeId nodeId
+
# Fired when `Element`'s attribute is modified.
event attributeModified
parameters
Roll protocol to r1305504 — 2024-05-24T04:27:22.000Z
@@ browser_protocol.pdl:12401 @@ experimental domain PWA
returns
# ID of the tab target created as a result.
Target.TargetID targetId
+
+ # Opens one or more local files from an installed web app identified by its
+ # manifestId. The web app needs to have file handlers registered to process
+ # the files. The API returns one or more tabs / web contents' based
+ # Target.TargetIDs which can be used to attach to via Target.attachToTarget or
+ # similar APIs.
+ # If some files in the parameters cannot be handled by the web app, they will
+ # be ignored. If none of the files can be handled, this API returns an error.
+ # If no files provided as the parameter, this API also returns an error.
+ #
+ # According to the definition of the file handlers in the manifest file, one
+ # Target.TargetID may represent a tab handling one or more files. The order of
+ # the returned Target.TargetIDs is also not guaranteed.
+ #
+ # TODO(crbug.com/339454034): Check the existences of the input files.
+ command launchFilesInApp
+ parameters
+ string manifestId
+ array of string files
+ returns
+ # IDs of the tab targets created as the result.
+ array of Target.TargetID targetIds
Roll protocol to r1304863 — 2024-05-23T04:26:40.000Z
@@ browser_protocol.pdl:851 @@ experimental domain Audits
array of string allowedSites
number optOutPercentage
boolean isOptOutTopLevel
+ CookieOperation operation
type ClientHintIssueReason extends string
enum
@@ -5589,6 +5590,10 @@ domain Network
experimental number workerFetchStart
# Settled fetch event respondWith promise.
experimental number workerRespondWithSettled
+ # Started ServiceWorker static routing source evaluation.
+ experimental optional number workerRouterEvaluationStart
+ # Started cache lookup when the source was evaluated to `cache`.
+ experimental optional number workerCacheLookupStart
# Started sending request.
number sendStart
# Finished sending request.
@@ -5874,6 +5879,8 @@ domain Network
# The router source of the matched rule. If there is a matched rule, this
# field will be set, otherwise no value will be set.
optional ServiceWorkerRouterSource matchedSourceType
+ # The actual router source used.
+ optional ServiceWorkerRouterSource actualSourceType
# HTTP response data.
type Response extends object
Roll protocol to r1304228 — 2024-05-22T04:27:23.000Z
@@ browser_protocol.pdl:911 @@ experimental domain Audits
NotSignedInWithIdp
MissingTransientUserActivation
ReplacedByButtonMode
+ RelyingPartyOriginIsOpaque
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
Roll protocol to r1302984 — 2024-05-18T04:26:58.000Z
@@ browser_protocol.pdl:8710 @@ domain Page
# If set, the script will be injected into all frames of the inspected page after reload.
# Argument will be ignored if reloading dataURL origin.
optional string scriptToEvaluateOnLoad
+ # If set, an error will be thrown if the target page's main frame's
+ # loader id does not match the provided id. This prevents accidentally
+ # reloading an unintended target in case there's a racing navigation.
+ experimental optional Network.LoaderId loaderId
# Deprecated, please use removeScriptToEvaluateOnNewDocument instead.
experimental deprecated command removeScriptToEvaluateOnLoad
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index ee14676c..8dad9c98 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -1297,10 +1297,6 @@ domain Runtime
# Id of an execution context.
type ExecutionContextId extends integer
- # Id of an execution context that is unique across processes
- # (unlike ExecutionContextId).
- type ExecutionContextUniqueId extends string
-
# Description of an isolated world.
type ExecutionContextDescription extends object
properties
@@ -1314,7 +1310,7 @@ domain Runtime
# 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 ExecutionContextUniqueId uniqueId
+ experimental string uniqueId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object auxData
@@ -1675,8 +1671,7 @@ domain Runtime
# 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`
- # and `executionContextUniqueId`.
+ # 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.
@@ -1685,12 +1680,8 @@ domain Runtime
# 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`
- # and `executionContextUniqueId`.
+ # This parameter is mutually exclusive with `executionContextId`.
optional string executionContextName
- # This parameter is mutually exclusive with `executionContextId`
- # and `executionContextName`.
- experimental optional ExecutionContextUniqueId executionContextUniqueId
# This method does not remove binding function from global object but
# unsubscribes current runtime agent from Runtime.bindingCalled notifications.
@@ -1717,7 +1708,6 @@ domain Runtime
string payload
# Identifier of the context where the call was made.
ExecutionContextId executionContextId
- experimental ExecutionContextUniqueId executionContextUniqueId
# Issued when console API was called.
event consoleAPICalled
@@ -1746,7 +1736,6 @@ domain Runtime
array of RemoteObject args
# Identifier of the context where the call was made.
ExecutionContextId executionContextId
- experimental ExecutionContextUniqueId executionContextUniqueId
# Call timestamp.
Timestamp timestamp
# Stack trace captured when the call was made. The async stack chain is automatically reported for
@@ -1785,7 +1774,7 @@ domain Runtime
# Id of the destroyed context
deprecated ExecutionContextId executionContextId
# Unique Id of the destroyed context
- experimental ExecutionContextUniqueId executionContextUniqueId
+ experimental string executionContextUniqueId
# Issued when all executionContexts were cleared in browser
event executionContextsCleared
Roll protocol to r1302401 — 2024-05-17T04:26:51.000Z
@@ browser_protocol.pdl:849 @@ experimental domain Audits
type CookieDeprecationMetadataIssueDetails extends object
properties
array of string allowedSites
+ number optOutPercentage
+ boolean isOptOutTopLevel
type ClientHintIssueReason extends string
enum
Roll protocol to r1301748 — 2024-05-16T04:24:35.000Z
@@ browser_protocol.pdl:6183 @@ domain Network
TopLevelStorageAccess
# The cookie should have been blocked by 3PCD but is exempted by CORS opt-in.
CorsOptIn
+ # The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
+ Scheme
# A cookie which was not stored from a response with the corresponding reason.
experimental type BlockedSetCookieWithReason extends object
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index 8dad9c98..ee14676c 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -1297,6 +1297,10 @@ domain Runtime
# Id of an execution context.
type ExecutionContextId extends integer
+ # Id of an execution context that is unique across processes
+ # (unlike ExecutionContextId).
+ type ExecutionContextUniqueId extends string
+
# Description of an isolated world.
type ExecutionContextDescription extends object
properties
@@ -1310,7 +1314,7 @@ domain Runtime
# 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
+ experimental ExecutionContextUniqueId uniqueId
# Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object auxData
@@ -1671,7 +1675,8 @@ domain Runtime
# 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`.
+ # This parameter is mutually exclusive with `executionContextName`
+ # and `executionContextUniqueId`.
# 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.
@@ -1680,8 +1685,12 @@ domain Runtime
# 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`.
+ # This parameter is mutually exclusive with `executionContextId`
+ # and `executionContextUniqueId`.
optional string executionContextName
+ # This parameter is mutually exclusive with `executionContextId`
+ # and `executionContextName`.
+ experimental optional ExecutionContextUniqueId executionContextUniqueId
# This method does not remove binding function from global object but
# unsubscribes current runtime agent from Runtime.bindingCalled notifications.
@@ -1708,6 +1717,7 @@ domain Runtime
string payload
# Identifier of the context where the call was made.
ExecutionContextId executionContextId
+ experimental ExecutionContextUniqueId executionContextUniqueId
# Issued when console API was called.
event consoleAPICalled
@@ -1736,6 +1746,7 @@ domain Runtime
array of RemoteObject args
# Identifier of the context where the call was made.
ExecutionContextId executionContextId
+ experimental ExecutionContextUniqueId executionContextUniqueId
# Call timestamp.
Timestamp timestamp
# Stack trace captured when the call was made. The async stack chain is automatically reported for
@@ -1774,7 +1785,7 @@ domain Runtime
# Id of the destroyed context
deprecated ExecutionContextId executionContextId
# Unique Id of the destroyed context
- experimental string executionContextUniqueId
+ experimental ExecutionContextUniqueId executionContextUniqueId
# Issued when all executionContexts were cleared in browser
event executionContextsCleared
Roll protocol to r1301093 — 2024-05-15T04:27:06.000Z
@@ browser_protocol.pdl:2633 @@ domain DOM
highlight
first-line-inherited
scroll-marker
- scroll-markers
+ scroll-marker-group
scrollbar
scrollbar-thumb
scrollbar-button
Roll protocol to r1300426 — 2024-05-14T04:26:18.000Z
@@ browser_protocol.pdl:2626 @@ domain DOM
marker
backdrop
selection
+ search-text
target-text
spelling-error
grammar-error
Roll protocol to r1299070 — 2024-05-10T04:26:27.000Z
@@ browser_protocol.pdl:12127 @@ experimental domain Preload
ActivationUrlHasEffectiveUrl
JavaScriptInterfaceAdded
JavaScriptInterfaceRemoved
+ AllPrerenderingCanceled
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1298513 — 2024-05-09T04:28:16.000Z
@@ browser_protocol.pdl:12371 @@ experimental domain PWA
command uninstall
parameters
string manifestId
+
+ # Launches the installed web app, or an url in the same web app instead of the
+ # default start url if it is provided. Returns a tab / web contents based
+ # Target.TargetID which can be used to attach to via Target.attachToTarget or
+ # similar APIs.
+ command launch
+ parameters
+ string manifestId
+ optional string url
+ returns
+ # ID of the tab target created as a result.
+ Target.TargetID targetId
Roll protocol to r1297943 — 2024-05-08T04:25:54.000Z
@@ browser_protocol.pdl:12125 @@ experimental domain Preload
PrerenderingUrlHasEffectiveUrl
RedirectedPrerenderingUrlHasEffectiveUrl
ActivationUrlHasEffectiveUrl
+ JavaScriptInterfaceAdded
+ JavaScriptInterfaceRemoved
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
Roll protocol to r1297280 — 2024-05-07T04:27:12.000Z
@@ browser_protocol.pdl:6459 @@ domain Network
optional string path
# If specified, deletes only cookies with the the given name and partitionKey where domain
# matches provided URL.
- optional string partitionKey
+ experimental optional string partitionKey
# Disables network tracking, prevents network events from being sent to the client.
command disable
Roll protocol to r1294763 — 2024-05-01T04:26:34.000Z
@@ browser_protocol.pdl:12355 @@ experimental domain PWA
# requirement.
# IWA-specific install description: If the manifest_id is isolated-app://,
# install_url_or_bundle_url is required, and can be either an http(s) URL or
- # file:// URL pointing to a signed web bundle (.swbn). The .swbn file’s
+ # file:// URL pointing to a signed web bundle (.swbn). The .swbn file's
# signing key must correspond to manifest_id. If Chrome is not in IWA dev
# mode, the installation will fail, regardless of the state of the allowlist.
command install
Roll protocol to r1294156 — 2024-04-30T04:26:41.000Z
@@ browser_protocol.pdl:5864 @@ domain Network
experimental type ServiceWorkerRouterInfo extends object
properties
- integer ruleIdMatched
- ServiceWorkerRouterSource matchedSourceType
+ # ID of the rule matched. If there is a matched rule, this field will
+ # be set, otherwiser no value will be set.
+ optional integer ruleIdMatched
+ # The router source of the matched rule. If there is a matched rule, this
+ # field will be set, otherwise no value will be set.
+ optional ServiceWorkerRouterSource matchedSourceType
# HTTP response data.
type Response extends object
@@ -5904,7 +5908,10 @@ domain Network
optional boolean fromPrefetchCache
# Specifies that the request was served from the prefetch cache.
optional boolean fromEarlyHints
- # Information about how Service Worker Static Router was used.
+ # Information about how ServiceWorker Static Router API was used. If this
+ # field is set with `matchedSourceType` field, a matching rule is found.
+ # If this field is set without `matchedSource`, no matching rule is found.
+ # Otherwise, the API is not used.
experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
# Total number of bytes received for this request so far.
number encodedDataLength
@@ -7918,9 +7925,7 @@ domain Page
vertical-scroll
web-printing
web-share
- # Alias for 'window-placement' (crbug.com/1328581).
window-management
- window-placement
xr-spatial-tracking
# Reason for a permissions policy feature to be disabled.
@@ -12343,3 +12348,24 @@ experimental domain PWA
integer badgeCount
array of FileHandler fileHandlers
+ # Installs the given manifest identity, optionally using the given install_url
+ # or IWA bundle location.
+ #
+ # TODO(crbug.com/337872319) Support IWA to meet the following specific
+ # requirement.
+ # IWA-specific install description: If the manifest_id is isolated-app://,
+ # install_url_or_bundle_url is required, and can be either an http(s) URL or
+ # file:// URL pointing to a signed web bundle (.swbn). The .swbn file’s
+ # signing key must correspond to manifest_id. If Chrome is not in IWA dev
+ # mode, the installation will fail, regardless of the state of the allowlist.
+ command install
+ parameters
+ string manifestId
+ # The location of the app or bundle overriding the one derived from the
+ # manifestId.
+ optional string installUrlOrBundleUrl
+
+ # Uninstals the given manifest_id and closes any opened app windows.
+ command uninstall
+ parameters
+ string manifestId
Roll protocol to r1292262 — 2024-04-25T04:26:20.000Z
@@ browser_protocol.pdl:3132 @@ domain DOM
# NodeIds of top layer elements
array of NodeId nodeIds
+ # Returns the NodeId of the matched element according to certain relations.
+ experimental command getElementByRelation
+ parameters
+ # Id of the node from which to query the relation.
+ NodeId nodeId
+ # Type of relation to get.
+ enum relation
+ # Get the popover target for a given element. In this case, this given
+ # element can only be an HTMLFormControlElement (<input>, <button>).
+ PopoverTarget
+ returns
+ # NodeId of the element matching the queried relation.
+ NodeId nodeId
+
# Re-does the last undone action.
experimental command redo
@@ -9267,6 +9281,7 @@ domain Page
EmbedderExtensionMessaging
EmbedderExtensionMessagingForOpenPort
EmbedderExtensionSentMessageToCachedFrame
+ RequestedByWebViewClient
# Types of not restored reasons for back-forward cache.
experimental type BackForwardCacheNotRestoredReasonType extends string
Roll protocol to r1291694 — 2024-04-24T04:26:06.000Z
@@ browser_protocol.pdl:741 @@ experimental domain Audits
NoRegisterOsSourceHeader
NoRegisterOsTriggerHeader
+ type SharedDictionaryError extends string
+ enum
+ UseErrorCrossOriginNoCorsRequest
+ UseErrorDictionaryLoadFailure
+ UseErrorMatchingDictionaryNotUsed
+ UseErrorUnexpectedContentDictionaryHeader
+ WriteErrorCossOriginNoCorsRequest
+ WriteErrorDisallowedBySettings
+ WriteErrorExpiredResponse
+ WriteErrorFeatureDisabled
+ WriteErrorInsufficientResources
+ WriteErrorInvalidMatchField
+ WriteErrorInvalidStructuredHeader
+ WriteErrorNavigationRequest
+ WriteErrorNoMatchField
+ WriteErrorNonListMatchDestField
+ WriteErrorNonSecureContext
+ WriteErrorNonStringIdField
+ WriteErrorNonStringInMatchDestList
+ WriteErrorNonStringMatchField
+ WriteErrorNonTokenTypeField
+ WriteErrorRequestAborted
+ WriteErrorShuttingDown
+ WriteErrorTooLongIdField
+ WriteErrorUnsupportedType
+
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
@@ -767,6 +793,11 @@ experimental domain Audits
string url
optional SourceCodeLocation location
+ type SharedDictionaryIssueDetails extends object
+ properties
+ SharedDictionaryError sharedDictionaryError
+ AffectedRequest request
+
type GenericIssueErrorType extends string
enum
CrossOriginPortalPostMessageError
@@ -972,6 +1003,7 @@ experimental domain Audits
StylesheetLoadingIssue
FederatedAuthUserInfoRequestIssue
PropertyRuleIssue
+ SharedDictionaryIssue
# 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
@@ -998,6 +1030,7 @@ experimental domain Audits
optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
+ optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
Roll protocol to r1289136 — 2024-04-18T04:26:02.000Z
@@ browser_protocol.pdl:1059 @@ experimental domain Audits
parameters
InspectorIssue issue
+# Defines commands and events for browser extensions. Available if the client
+# is connected using the --remote-debugging-pipe flag and
+# the --enable-unsafe-extension-debugging flag is set.
+experimental domain Extensions
+ # Installs an unpacked extension from the filesystem similar to
+ # --load-extension CLI flags. Returns extension ID once the extension
+ # has been installed.
+ command loadUnpacked
+ parameters
+ # Absolute file path.
+ string path
+ returns
+ # Extension id.
+ string id
+
# Defines commands and events for Autofill.
experimental domain Autofill
type CreditCard extends object
@@ -8440,7 +8455,7 @@ domain Page
# This API always waits for the manifest to be loaded.
# If manifestId is provided, and it does not match the manifest of the
# current document, this API errors out.
- # If there isn’t a loaded page, this API errors out immediately.
+ # If there is not a loaded page, this API errors out immediately.
command getAppManifest
parameters
optional string manifestId
Roll protocol to r1286932 — 2024-04-13T04:24:25.000Z
@@ browser_protocol.pdl:876 @@ experimental domain Audits
SilentMediationFailure
ThirdPartyCookiesBlocked
NotSignedInWithIdp
+ MissingTransientUserActivation
+ ReplacedByButtonMode
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -8325,15 +8327,132 @@ domain Page
# Enables page domain notifications.
command enable
+ # The manifest of a webapp, see
+ # https://www.w3.org/TR/appmanifest/#dfn-manifest.
+ # Some fields do not appear in the standard since the API is designed to
+ # expose more browser internal states.
+
+ experimental type FileFilter extends object
+ properties
+ optional string name
+ optional array of string accepts
+
+ experimental type FileHandler extends object
+ properties
+ string action
+ string name
+ optional array of ImageResource icons
+ # Mimic a map, name is the key, accepts is the value.
+ optional array of FileFilter accepts
+ # Won't repeat the enums, using string for easy comparison. Same as the
+ # other enums below.
+ string launchType
+
+ # The image definition used in both icon and screenshot.
+ experimental type ImageResource extends object
+ properties
+ # The src field in the definition, but changing to url in favor of
+ # consistency.
+ string url
+ optional string sizes
+ optional string type
+
+ experimental type LaunchHandler extends object
+ properties
+ string clientMode
+
+ experimental type ProtocolHandler extends object
+ properties
+ string protocol
+ string url
+
+ experimental type RelatedApplication extends object
+ properties
+ optional string id
+ string url
+
+ experimental type ScopeExtension extends object
+ properties
+ # Instead of using tuple, this field always returns the serialized string
+ # for easy understanding and comparison.
+ string origin
+ boolean hasOriginWildcard
+
+ experimental type Screenshot extends object
+ properties
+ ImageResource image
+ string formFactor
+ optional string label
+
+ experimental type ShareTarget extends object
+ properties
+ string action
+ string method
+ string enctype
+ # Embed the ShareTargetParams
+ optional string title
+ optional string text
+ optional string url
+ optional array of FileFilter files
+
+ experimental type Shortcut extends object
+ properties
+ string name
+ string url
+
+ experimental type WebAppManifest extends object
+ properties
+ optional string backgroundColor
+ # The extra description provided by the manifest.
+ optional string description
+ optional string dir
+ optional string display
+ # The overrided display mode controlled by the user.
+ optional array of string displayOverrides
+ # The handlers to open files.
+ optional array of FileHandler fileHandlers
+ optional array of ImageResource icons
+ optional string id
+ optional string lang
+ # TODO(crbug.com/1231886): This field is non-standard and part of a Chrome
+ # experiment. See:
+ # https://github.com/WICG/web-app-launch/blob/main/launch_handler.md
+ optional LaunchHandler launchHandler
+ optional string name
+ optional string orientation
+ optional boolean preferRelatedApplications
+ # The handlers to open protocols.
+ optional array of ProtocolHandler protocolHandlers
+ optional array of RelatedApplication relatedApplications
+ optional string scope
+ # Non-standard, see
+ # https://github.com/WICG/manifest-incubations/blob/gh-pages/scope_extensions-explainer.md
+ optional array of ScopeExtension scopeExtensions
+ # The screenshots used by chromium.
+ optional array of Screenshot screenshots
+ optional ShareTarget shareTarget
+ optional string shortName
+ optional array of Shortcut shortcuts
+ optional string startUrl
+ optional string themeColor
+
+ # Gets the processed manifest for this current document.
+ # This API always waits for the manifest to be loaded.
+ # If manifestId is provided, and it does not match the manifest of the
+ # current document, this API errors out.
+ # If there isn’t a loaded page, this API errors out immediately.
command getAppManifest
+ parameters
+ optional string manifestId
returns
# Manifest location.
string url
array of AppManifestError errors
# Manifest content.
optional string data
- # Parsed manifest properties
- experimental optional AppManifestParsedProperties parsed
+ # Parsed manifest properties. Deprecated, use manifest instead.
+ experimental deprecated optional AppManifestParsedProperties parsed
+ experimental WebAppManifest manifest
experimental command getInstallabilityErrors
returns
@@ -12160,3 +12279,4 @@ experimental domain PWA
returns
integer badgeCount
array of FileHandler fileHandlers
+
Roll protocol to r1285609 — 2024-04-11T04:26:18.000Z
@@ browser_protocol.pdl:475 @@ experimental domain Animation
# Animation that was started.
Animation animation
+ # Event for animation that has been updated.
+ event animationUpdated
+ parameters
+ # Animation that was updated.
+ Animation animation
+
# Audits domain allows investigation of page violations and possible improvements.
experimental domain Audits
depends on Network
Roll protocol to r1284279 — 2024-04-09T04:26:29.000Z
@@ browser_protocol.pdl:2575 @@ domain DOM
grammar-error
highlight
first-line-inherited
+ scroll-marker
+ scroll-markers
scrollbar
scrollbar-thumb
scrollbar-button
Roll protocol to r1282316 — 2024-04-04T04:27:08.000Z
@@ browser_protocol.pdl:12123 @@ experimental domain FedCm
# Resets the cooldown time, if any, to allow the next FedCM call to show
# a dialog even if one was recently dismissed by the user.
command resetCooldown
+
+# This domain allows interacting with the browser to control PWAs.
+experimental domain PWA
+
+ # The following types are the replica of
+ # https://crsrc.org/c/chrome/browser/web_applications/proto/web_app_os_integration_state.proto;drc=9910d3be894c8f142c977ba1023f30a656bc13fc;l=67
+ type FileHandlerAccept extends object
+ properties
+ # New name of the mimetype according to
+ # https://www.iana.org/assignments/media-types/media-types.xhtml
+ string mediaType
+ array of string fileExtensions
+
+ type FileHandler extends object
+ properties
+ string action
+ array of FileHandlerAccept accepts
+ string displayName
+
+ # Returns the following OS state for the given manifest id.
+ command getOsAppState
+ parameters
+ # The id from the webapp's manifest file, commonly it's the url of the
+ # site installing the webapp. See
+ # https://web.dev/learn/pwa/web-app-manifest.
+ string manifestId
+ returns
+ integer badgeCount
+ array of FileHandler fileHandlers
Roll protocol to r1281655 — 2024-04-03T04:26:30.000Z
@@ browser_protocol.pdl:6123 @@ domain Network
properties
# The reason the cookie was exempted.
CookieExemptionReason exemptionReason
+ # The string representing this individual cookie as it would appear in the header.
+ string cookieLine
# The cookie object representing the cookie.
Cookie cookie
@@ -6957,6 +6959,16 @@ domain Network
# the response with the corresponding reason.
optional array of ExemptedSetCookieWithReason exemptedCookies
+ # Fired when 103 Early Hints headers is received in addition to the common response.
+ # Not every responseReceived event will have an responseReceivedEarlyHints fired.
+ # Only one responseReceivedEarlyHints may be fired for eached responseReceived event.
+ experimental event responseReceivedEarlyHints
+ parameters
+ # Request identifier. Used to match this information to another responseReceived event.
+ RequestId requestId
+ # Raw response headers as they were received over the wire.
+ Headers headers
+
# 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
Roll protocol to r1280070 — 2024-03-29T04:26:49.000Z
@@ browser_protocol.pdl:4159 @@ domain Emulation
experimental optional DisplayFeature displayFeature
# If set, the posture of a foldable device. If not set the posture is set
# to continuous.
- experimental optional DevicePosture devicePosture
+ # Deprecated, use Emulation.setDevicePostureOverride.
+ experimental deprecated optional DevicePosture devicePosture
+
+ # Start reporting the given posture value to the Device Posture API.
+ # This override can also be set in setDeviceMetricsOverride().
+ experimental command setDevicePostureOverride
+ parameters
+ DevicePosture posture
+
+ # Clears a device posture override set with either setDeviceMetricsOverride()
+ # or setDevicePostureOverride() and starts using posture information from the
+ # platform again.
+ # Does nothing if no override is set.
+ experimental command clearDevicePostureOverride
experimental command setScrollbarsHidden
parameters
@@ -5817,6 +5830,8 @@ domain Network
optional boolean fromServiceWorker
# Specifies that the request was served from the prefetch cache.
optional boolean fromPrefetchCache
+ # Specifies that the request was served from the prefetch cache.
+ optional boolean fromEarlyHints
# Information about how Service Worker Static Router was used.
experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
# Total number of bytes received for this request so far.
Roll protocol to r1279463 — 2024-03-28T04:25:51.000Z
@@ browser_protocol.pdl:10237 @@ experimental domain Storage
destinationBothLimitsReached
reportingOriginsPerSiteLimitReached
exceedsMaxChannelCapacity
+ exceedsMaxTriggerStateCardinality
experimental event attributionReportingSourceRegistered
parameters
Roll protocol to r1275388 — 2024-03-20T04:26:38.000Z
@@ browser_protocol.pdl:10148 @@ experimental domain Storage
parameters
boolean enable
+ # Sends all pending Attribution Reports immediately, regardless of their
+ # scheduled report time.
+ experimental command sendPendingAttributionReports
+ returns
+ # The number of reports that were sent.
+ integer numSent
+
experimental type AttributionReportingSourceType extends string
enum
navigation
Roll protocol to r1273771 — 2024-03-16T04:26:55.000Z
@@ browser_protocol.pdl:5539 @@ domain Network
# HTTP request headers.
Headers headers
# HTTP POST request data.
- optional string postData
+ # Use postDataEntries instead.
+ deprecated optional string postData
# True when the request has POST data. Note that postData might still be omitted when this flag is true when the data is too long.
optional boolean hasPostData
- # Request body elements. This will be converted from base64 to binary
+ # Request body elements (post data broken into individual entries).
experimental optional array of PostDataEntry postDataEntries
# The mixed content type of the request.
optional Security.MixedContentType mixedContentType
Roll protocol to r1273222 — 2024-03-15T04:26:20.000Z
@@ browser_protocol.pdl:1944 @@ experimental domain CSS
CSSStyle style
# CSS position-fallback rule representation.
- type CSSPositionFallbackRule extends object
+ deprecated type CSSPositionFallbackRule extends object
properties
Value name
# List of keyframes.
array of CSSTryRule tryRules
+ # CSS @position-try rule representation.
+ type CSSPositionTryRule extends object
+ properties
+ # The prelude dashed-ident name
+ Value name
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated style declaration.
+ CSSStyle style
+
# CSS keyframes rule representation.
type CSSKeyframesRule extends object
properties
@@ -2123,7 +2136,9 @@ experimental domain CSS
# A list of CSS keyframed animations matching this node.
optional array of CSSKeyframesRule cssKeyframesRules
# A list of CSS position fallbacks matching this node.
- optional array of CSSPositionFallbackRule cssPositionFallbackRules
+ deprecated optional array of CSSPositionFallbackRule cssPositionFallbackRules
+ # A list of CSS @position-try rules matching this node, based on the position-try-options property.
+ optional array of CSSPositionTryRule cssPositionTryRules
# A list of CSS at-property rules matching this node.
optional array of CSSPropertyRule cssPropertyRules
# A list of CSS property registrations matching this node.
@@ -9674,6 +9689,7 @@ experimental domain Storage
documentAppend
documentDelete
documentClear
+ documentGet
workletSet
workletAppend
workletDelete
Roll protocol to r1272579 — 2024-03-14T04:25:42.000Z
@@ browser_protocol.pdl:2165 @@ experimental domain CSS
returns
CSSLayerData rootLayer
+ # Given a CSS selector text and a style sheet ID, getLocationForSelector
+ # returns an array of locations of the CSS selector in the style sheet.
+ experimental command getLocationForSelector
+ parameters
+ StyleSheetId styleSheetId
+ string selectorText
+ returns
+ array of SourceRange ranges
+
# Starts tracking the given computed styles for updates. The specified array of properties
# replaces the one previously specified. Pass empty array to disable tracking.
# Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
@@ -10303,6 +10312,22 @@ experimental domain Storage
AttributionReportingEventLevelResult eventLevel
AttributionReportingAggregatableResult aggregatable
+ # A single Related Website Set object.
+ experimental type RelatedWebsiteSet extends object
+ properties
+ # The primary site of this set, along with the ccTLDs if there is any.
+ array of string primarySites
+ # The associated sites of this set, along with the ccTLDs if there is any.
+ array of string associatedSites
+ # The service sites of this set, along with the ccTLDs if there is any.
+ array of string serviceSites
+
+ # Returns the effective Related Website Sets in use by this profile for the browser
+ # session. The effective Related Website Sets will not change during a browser session.
+ experimental command getRelatedWebsiteSets
+ returns
+ array of RelatedWebsiteSet sets
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1271979 — 2024-03-13T04:25:43.000Z
@@ browser_protocol.pdl:7735 @@ domain Page
ch-ua-platform
ch-ua-model
ch-ua-mobile
- ch-ua-form-factor
+ ch-ua-form-factors
ch-ua-full-version
ch-ua-full-version-list
ch-ua-platform-version
@@ -9655,28 +9655,6 @@ experimental domain Storage
bidderTrustedSignals
sellerTrustedSignals
- # Ad advertising element inside an interest group.
- type InterestGroupAd extends object
- properties
- string renderURL
- optional string metadata
-
- # The full details of an interest group.
- type InterestGroupDetails extends object
- properties
- string ownerOrigin
- string name
- Network.TimeSinceEpoch expirationTime
- string joiningOrigin
- optional string biddingLogicURL
- optional string biddingWasmHelperURL
- optional string updateURL
- optional string trustedBiddingSignalsURL
- array of string trustedBiddingSignalsKeys
- optional string userBiddingSignals
- array of InterestGroupAd ads
- array of InterestGroupAd adComponents
-
# Enum of shared storage access types.
type SharedStorageAccessType extends string
enum
@@ -9696,6 +9674,10 @@ experimental domain Storage
workletEntries
workletLength
workletRemainingBudget
+ headerSet
+ headerAppend
+ headerDelete
+ headerClear
# Struct for a single key-value pair in an origin's shared storage.
type SharedStorageEntry extends object
@@ -9754,18 +9736,24 @@ experimental domain Storage
# SharedStorageAccessType.documentDelete,
# SharedStorageAccessType.workletSet,
# SharedStorageAccessType.workletAppend,
- # SharedStorageAccessType.workletDelete, and
- # SharedStorageAccessType.workletGet.
+ # SharedStorageAccessType.workletDelete,
+ # SharedStorageAccessType.workletGet,
+ # SharedStorageAccessType.headerSet,
+ # SharedStorageAccessType.headerAppend, and
+ # SharedStorageAccessType.headerDelete.
optional string key
# Value for a specific entry in an origin's shared storage.
# Present only for SharedStorageAccessType.documentSet,
# SharedStorageAccessType.documentAppend,
- # SharedStorageAccessType.workletSet, and
- # SharedStorageAccessType.workletAppend.
+ # SharedStorageAccessType.workletSet,
+ # SharedStorageAccessType.workletAppend,
+ # SharedStorageAccessType.headerSet, and
+ # SharedStorageAccessType.headerAppend.
optional string value
# Whether or not to set an entry for a key if that key is already present.
- # Present only for SharedStorageAccessType.documentSet and
- # SharedStorageAccessType.workletSet.
+ # Present only for SharedStorageAccessType.documentSet,
+ # SharedStorageAccessType.workletSet, and
+ # SharedStorageAccessType.headerSet.
optional boolean ignoreIfPresent
type StorageBucketsDurability extends string
@@ -9933,7 +9921,11 @@ experimental domain Storage
string ownerOrigin
string name
returns
- InterestGroupDetails details
+ # This largely corresponds to:
+ # https://wicg.github.io/turtledove/#dictdef-generatebidinterestgroup
+ # but has absolute expirationTime instead of relative lifetimeMs and
+ # also adds joiningOrigin.
+ object details
# Enables/Disables issuing of interestGroupAccessed events.
experimental command setInterestGroupTracking
Roll protocol to r1271365 — 2024-03-12T04:27:11.000Z
@@ browser_protocol.pdl:6356 @@ domain Network
number uploadThroughput
# Connection type if known.
optional ConnectionType connectionType
+ # WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
+ experimental optional number packetLoss
+ # WebRTC packet queue length (packet). 0 removes any queue length limitations.
+ experimental optional integer packetQueueLength
+ # WebRTC packetReordering feature.
+ experimental optional boolean packetReordering
# Enables network tracking, network events will now be delivered to the client.
command enable
Roll protocol to r1269399 — 2024-03-07T04:25:11.000Z
@@ browser_protocol.pdl:8953 @@ domain Page
CookieDisabled
HTTPAuthRequired
CookieFlushed
+ BroadcastChannelOnMessage
#Blocklisted features
WebSocket
WebTransport
Roll protocol to r1266816 — 2024-02-29T04:26:20.000Z
@@ browser_protocol.pdl:9003 @@ domain Page
SmartCard
LiveMediaStreamTrack
UnloadHandler
+ ParserAborted
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1266247 — 2024-02-28T04:26:37.000Z
@@ browser_protocol.pdl:729 @@ experimental domain Audits
WebAndOsHeaders
NoWebOrOsSupport
NavigationRegistrationWithoutTransientUserActivation
+ InvalidInfoHeader
+ NoRegisterSourceHeader
+ NoRegisterTriggerHeader
+ NoRegisterOsSourceHeader
+ NoRegisterOsTriggerHeader
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
Roll protocol to r1263784 — 2024-02-22T04:25:35.000Z
@@ browser_protocol.pdl:4053 @@ domain Emulation
optional SensorReadingQuaternion quaternion
# Tells whether emulation is supported.
- command canEmulate
+ deprecated command canEmulate
returns
# True if emulation is supported.
boolean result
@@ -4272,7 +4272,7 @@ domain Emulation
# Overrides default host system timezone with the specified one.
command setTimezoneOverride
parameters
- # The timezone identifier. List of supported timezones:
+ # The timezone identifier. List of supported timezones:
# https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt
# If empty, disables the override and restores default host system timezone.
string timezoneId
Roll protocol to r1263133 — 2024-02-21T04:25:55.000Z
@@ browser_protocol.pdl:8872 @@ domain Page
string message
# Dialog type.
DialogType type
- # True if browser is capable showing or acting on the given dialog. When browser has no
+ # True iff browser is capable showing or acting on the given dialog. When browser has no
# dialog handler for given target, calling alert while Page domain is engaged will stall
# the page execution. Execution can be resumed via calling Page.handleJavaScriptDialog.
boolean hasBrowserHandler
@@ -10449,8 +10449,8 @@ domain Target
type TargetInfo extends object
properties
TargetID targetId
- string type
# List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22
+ string type
string title
string url
# Whether the target has an attached client.
@@ -11718,7 +11718,7 @@ experimental domain Preload
optional string url
optional Network.RequestId requestId
# Error information
- # `errorMessage` is null if `errorType` is null.
+ # `errorMessage` is null iff `errorType` is null.
optional RuleSetErrorType errorType
# TODO(https://crbug.com/1425354): Replace this property with structured error.
deprecated optional string errorMessage
Roll protocol to r1262535 — 2024-02-20T04:27:19.000Z
@@ browser_protocol.pdl:217 @@ experimental domain Accessibility
# If omitted, the full tree is returned.
optional integer depth
# The frame for whose document the AX tree should be retrieved.
- # If omited, the root frame is used.
+ # If omitted, the root frame is used.
optional Page.FrameId frameId
returns
array of AXNode nodes
@@ -258,7 +258,7 @@ experimental domain Accessibility
# Query a DOM node's accessibility subtree for accessible name and role.
# This command computes the name and role for all nodes in the subtree, including those that are
- # ignored for accessibility, and returns those that mactch the specified name and role. If no DOM
+ # ignored for accessibility, and returns those that match the specified name and role. If no DOM
# node is specified, or the DOM node does not exist, the command returns an error. If neither
# `accessibleName` or `role` is specified, it returns all the accessibility nodes in the subtree.
experimental command queryAXTree
@@ -1087,7 +1087,7 @@ experimental domain Autofill
# Munich 81456
type AddressUI extends object
properties
- # A two dimension array containing the repesentation of values from an address profile.
+ # A two dimension array containing the representation of values from an address profile.
array of AddressFields addressFields
# Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
@@ -1339,7 +1339,7 @@ domain Browser
parameters
# Whether to allow all or deny all download requests, or use default Chrome behavior if
# available (otherwise deny). |allowAndName| allows download and names files according to
- # their dowmload guids.
+ # their download guids.
enum behavior
deny
allow
@@ -1606,7 +1606,7 @@ experimental domain CSS
# Owner frame identifier.
Page.FrameId frameId
# Stylesheet resource URL. Empty if this is a constructed stylesheet created using
- # new CSSStyleSheet() (but non-empty if this is a constructed sylesheet imported
+ # new CSSStyleSheet() (but non-empty if this is a constructed stylesheet imported
# as a CSS module script).
string sourceURL
# URL of source map associated with the stylesheet (if any).
@@ -2818,7 +2818,7 @@ domain DOM
# Returns attributes for the specified node.
command getAttributes
parameters
- # Id of the node to retrieve attibutes for.
+ # Id of the node to retrieve attributes for.
NodeId nodeId
returns
# An interleaved array of node attribute names and values.
@@ -3986,13 +3986,13 @@ domain Emulation
pause
pauseIfNetworkFetchesPending
- # Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints
+ # Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
experimental type UserAgentBrandVersion extends object
properties
string brand
string version
- # Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints
+ # Used to specify User Agent Client 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.
experimental type UserAgentMetadata extends object
properties
@@ -4201,7 +4201,7 @@ domain Emulation
SensorType type
optional SensorMetadata metadata
- # Updates the sensor readings reported by a sensor type previously overriden
+ # Updates the sensor readings reported by a sensor type previously overridden
# by setSensorOverrideEnabled.
experimental command setSensorOverrideReadings
parameters
@@ -4272,8 +4272,9 @@ domain Emulation
# Overrides default host system timezone with the specified one.
command setTimezoneOverride
parameters
- # The timezone identifier. If empty, disables the override and
- # restores default host system timezone.
+ # The timezone identifier. List of supported timezones:
+ # https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt
+ # If empty, disables the override and restores default host system timezone.
string timezoneId
# Resizes the frame/viewport of the page. Note that this does not affect the frame's container
@@ -4306,6 +4307,7 @@ domain Emulation
integer hardwareConcurrency
# Allows overriding user agent with the given string.
+ # `userAgentMetadata` must be set for Client Hint headers to be sent.
command setUserAgentOverride
parameters
# User agent to use.
@@ -4392,7 +4394,7 @@ domain IO
parameters
# Handle of the stream to read.
StreamHandle handle
- # Seek to the specified offset before reading (if not specificed, proceed with offset
+ # Seek to the specified offset before reading (if not specified, proceed with offset
# following the last read). Some types of streams may only support sequential reads.
optional integer offset
# Maximum number of bytes to read (left upon the agent discretion if not specified).
@@ -4776,7 +4778,7 @@ domain Input
# The text to insert.
string text
- # This method sets the current candidate text for ime.
+ # This method sets the current candidate text for IME.
# Use imeCommitComposition to commit the final text.
# Use imeSetComposition with empty string as text to cancel composition.
experimental command imeSetComposition
@@ -5156,7 +5158,7 @@ experimental domain LayerTree
event layerTreeDidChange
parameters
- # Layer tree, absent if not in the comspositing mode.
+ # Layer tree, absent if not in the compositing mode.
optional array of Layer layers
# Provides access to log entries.
@@ -5533,7 +5535,7 @@ domain Network
# passed by the developer (e.g. via "fetch") as understood by the backend.
experimental optional TrustTokenParams trustTokenParams
# True if this resource request is considered to be the 'same site' as the
- # request correspondinfg to the main frame.
+ # request corresponding to the main frame.
experimental optional boolean isSameSite
# Details of a signed certificate timestamp (SCT).
@@ -5785,7 +5787,7 @@ domain Network
optional boolean fromServiceWorker
# Specifies that the request was served from the prefetch cache.
optional boolean fromPrefetchCache
- # Infomation about how Service Worker Static Router was used.
+ # Information about how Service Worker Static Router was used.
experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
# Total number of bytes received for this request so far.
number encodedDataLength
@@ -5921,7 +5923,7 @@ domain Network
# The cookie had the "Secure" attribute but was not received over a secure connection.
SecureOnly
# The cookie had the "SameSite=Strict" attribute but came from a cross-origin response.
- # This includes navigation requests intitiated by other origins.
+ # This includes navigation requests initiated by other origins.
SameSiteStrict
# The cookie had the "SameSite=Lax" attribute but came from a cross-origin response.
SameSiteLax
@@ -5955,7 +5957,7 @@ domain Network
UnknownError
# The cookie had the "SameSite=Strict" attribute but came from a response
# with the same registrable domain but a different scheme.
- # This includes navigation requests intitiated by other origins.
+ # This includes navigation requests initiated by other origins.
# This is the "Schemeful Same-Site" version of the blocked reason.
SchemefulSameSiteStrict
# The cookie had the "SameSite=Lax" attribute but came from a response
@@ -6017,7 +6019,7 @@ domain Network
UnknownError
# The cookie had the "SameSite=Strict" attribute but came from a response
# with the same registrable domain but a different scheme.
- # This includes navigation requests intitiated by other origins.
+ # This includes navigation requests initiated by other origins.
# This is the "Schemeful Same-Site" version of the blocked reason.
SchemefulSameSiteStrict
# The cookie had the "SameSite=Lax" attribute but came from a response
@@ -6244,7 +6246,7 @@ domain Network
optional SignedExchangeHeader header
# Security details for the signed exchange header.
optional SecurityDetails securityDetails
- # Errors occurred while handling the signed exchagne.
+ # Errors occurred while handling the signed exchange.
optional array of SignedExchangeError errors
# List of content encodings supported by the backend.
@@ -6597,7 +6599,7 @@ domain Network
MonotonicTime timestamp
# Resource type.
ResourceType type
- # User friendly error message.
+ # Error message. List of network errors: https://cs.chromium.org/chromium/src/net/base/net_error_list.h
string errorText
# True if loading was canceled.
optional boolean canceled
@@ -6898,7 +6900,7 @@ domain Network
# The cookie partition key that will be used to store partitioned cookies set in this response.
# Only sent when partitioned cookies are enabled.
optional string cookiePartitionKey
- # True if partitioned cookies are enabled, but the partition key is not serializeable to string.
+ # True if partitioned cookies are enabled, but the partition key is not serializable to string.
optional boolean cookiePartitionKeyOpaque
# A list of cookies which should have been blocked by 3PCD but are exempted and stored from
# the response with the corresponding reason.
@@ -7142,7 +7144,7 @@ experimental domain Overlay
# Configuration data for drawing the source order of an elements children.
type SourceOrderConfig extends object
properties
- # the color to outline the givent element in.
+ # the color to outline the given element in.
DOM.RGBA parentOutlineColor
# the color to outline the child elements in.
DOM.RGBA childOutlineColor
@@ -7342,7 +7344,7 @@ experimental domain Overlay
properties
# Whether the title bar CSS should be shown when emulating the Window Controls Overlay.
boolean showCSS
- # Seleted platforms to show the overlay.
+ # Selected platforms to show the overlay.
string selectedPlatform
# The theme color defined in app manifest.
string themeColor
@@ -7430,8 +7432,8 @@ experimental domain Overlay
command hideHighlight
# Highlights owner element of the frame with given id.
- # Deprecated: Doesn't work reliablity and cannot be fixed due to process
- # separatation (the owner node might be in a different process). Determine
+ # Deprecated: Doesn't work reliably and cannot be fixed due to process
+ # separation (the owner node might be in a different process). Determine
# the owner node in the client and use highlightNode.
deprecated command highlightFrame
parameters
@@ -7998,7 +8000,7 @@ domain Page
properties
# Error message.
string message
- # If criticial, this is a non-recoverable parse error.
+ # If critical, this is a non-recoverable parse error.
integer critical
# Error line.
integer line
@@ -8655,7 +8657,7 @@ domain Page
experimental command stopScreencast
# Requests backend to produce compilation cache for the specified scripts.
- # `scripts` are appeneded to the list of scripts for which the cache
+ # `scripts` are appended to the list of scripts for which the cache
# would be produced. The list may be reset during page navigation.
# When script with a matching URL is encountered, the cache is optionally
# produced upon backend discretion, based on internal heuristics.
@@ -8675,7 +8677,7 @@ domain Page
# Clears seeded compilation cache.
experimental command clearCompilationCache
- # Enum of possible auto-reponse for permisison / prompt dialogs.
+ # Enum of possible auto-response for permission / prompt dialogs.
experimental type AutoResponseMode extends string
enum
none
@@ -8870,7 +8872,7 @@ domain Page
string message
# Dialog type.
DialogType type
- # True iff browser is capable showing or acting on the given dialog. When browser has no
+ # True if browser is capable showing or acting on the given dialog. When browser has no
# dialog handler for given target, calling alert while Page domain is engaged will stall
# the page execution. Execution can be resumed via calling Page.handleJavaScriptDialog.
boolean hasBrowserHandler
@@ -8956,7 +8958,6 @@ domain Page
SubresourceHasCacheControlNoCache
ContainsPlugins
DocumentLoaded
- DedicatedWorkerOrWorklet
OutstandingNetworkRequestOthers
RequestedMIDIPermission
RequestedAudioCapturePermission
@@ -9073,7 +9074,7 @@ domain Page
# when bfcache navigation fails.
experimental event backForwardCacheNotUsed
parameters
- # The loader id for the associated navgation.
+ # The loader id for the associated navigation.
Network.LoaderId loaderId
# The frame id of the associated frame.
FrameId frameId
@@ -9230,7 +9231,7 @@ experimental domain PerformanceTimeline
# Identifies the frame that this event is related to. Empty for non-frame targets.
Page.FrameId frameId
# The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
- # This determines which of the optional "details" fiedls is present.
+ # This determines which of the optional "details" fields is present.
string type
# Name may be empty depending on the type.
string name
@@ -9306,7 +9307,7 @@ domain Security
Network.TimeSinceEpoch validTo
# The highest priority network error code, if the certificate has an error.
optional string certificateNetworkError
- # True if the certificate uses a weak signature aglorithm.
+ # True if the certificate uses a weak signature algorithm.
boolean certificateHasWeakSignature
# True if the certificate has a SHA1 signature in the chain.
boolean certificateHasSha1Signature
@@ -10093,7 +10094,7 @@ experimental domain Storage
Page.FrameId mainFrameId
# Serialized origin for the context that invoked the Shared Storage API.
string ownerOrigin
- # The sub-parameters warapped by `params` are all optional and their
+ # The sub-parameters wrapped by `params` are all optional and their
# presence/absence depends on `type`.
SharedStorageAccessParams params
@@ -10449,6 +10450,7 @@ domain Target
properties
TargetID targetId
string type
+ # List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22
string title
string url
# Whether the target has an attached client.
@@ -10467,7 +10469,7 @@ domain Target
# A filter used by target query/discovery/auto-attach operations.
experimental type FilterEntry extends object
properties
- # If set, causes exclusion of mathcing targets from the list.
+ # If set, causes exclusion of matching targets from the list.
optional boolean exclude
# If not present, matches any type.
optional string type
@@ -10521,7 +10523,7 @@ domain Target
#
# Injected object will be available as `window[bindingName]`.
#
- # The object has the follwing API:
+ # The object has the following API:
# - `binding.send(json)` - a method to send messages over the remote debugging protocol
# - `binding.onmessage = json => handleMessage(json)` - a callback that will be called for the protocol notifications and command responses.
experimental command exposeDevToolsProtocol
@@ -11716,7 +11718,7 @@ experimental domain Preload
optional string url
optional Network.RequestId requestId
# Error information
- # `errorMessage` is null iff `errorType` is null.
+ # `errorMessage` is null if `errorType` is null.
optional RuleSetErrorType errorType
# TODO(https://crbug.com/1425354): Replace this property with structured error.
deprecated optional string errorMessage
@@ -11758,7 +11760,7 @@ experimental domain Preload
# that had a speculation rule that triggered the attempt, and the
# BackendNodeIds of <a href> or <area href> elements that triggered the
# attempt (in the case of attempts triggered by a document rule). It is
- # possible for mulitple rule sets and links to trigger a single attempt.
+ # possible for multiple rule sets and links to trigger a single attempt.
type PreloadingAttemptSource extends object
properties
PreloadingAttemptKey key
Roll protocol to r1262051 — 2024-02-17T04:27:02.000Z
@@ browser_protocol.pdl:1270 @@ domain Browser
protectedMediaIdentifier
sensors
storageAccess
+ speakerSelection
topLevelStorageAccess
videoCapture
videoCapturePanTiltZoom
@@ -5736,9 +5737,18 @@ domain Network
# This value is used when the reason is unknown.
unspecifiedReason
+ # Source of service worker router.
+ type ServiceWorkerRouterSource extends string
+ enum
+ network
+ cache
+ fetch-event
+ race-network-and-fetch-handler
+
experimental type ServiceWorkerRouterInfo extends object
properties
integer ruleIdMatched
+ ServiceWorkerRouterSource matchedSourceType
# HTTP response data.
type Response extends object
@@ -7761,6 +7771,7 @@ domain Page
shared-storage
shared-storage-select-url
smart-card
+ speaker-selection
storage-access
sub-apps
sync-xhr
Roll protocol to r1261483 — 2024-02-16T04:25:37.000Z
@@ browser_protocol.pdl:10198 @@ experimental domain Storage
include
exclude
- experimental type AttributionReportingAggregatableValueEntry extends object
+ experimental type AttributionReportingAggregatableValueDictEntry extends object
properties
string key
# number instead of integer because not all uint32 can be represented by
# int
number value
+ experimental type AttributionReportingAggregatableValueEntry extends object
+ properties
+ array of AttributionReportingAggregatableValueDictEntry values
+ AttributionReportingFilterPair filters
+
experimental type AttributionReportingEventTriggerData extends object
properties
UnsignedInt64AsBase10 data
Roll protocol to r1260888 — 2024-02-15T04:26:01.000Z
@@ browser_protocol.pdl:1110 @@ experimental domain Autofill
string autofillType
# The filling strategy
FillingStrategy fillingStrategy
+ # The frame the field belongs to
+ Page.FrameId frameId
# The form field's DOM node
DOM.BackendNodeId fieldId
Roll protocol to r1260275 — 2024-02-14T04:26:03.000Z
@@ browser_protocol.pdl:11410 @@ experimental domain WebAuthn
# The large blob associated with the credential.
# See https://w3c.github.io/webauthn/#sctn-large-blob-extension
optional binary largeBlob
+ # Assertions returned by this credential will have the backup eligibility
+ # (BE) flag set to this value. Defaults to the authenticator's
+ # defaultBackupEligibility value.
+ optional boolean backupEligibility
+ # Assertions returned by this credential will have the backup state (BS)
+ # flag set to this value. Defaults to the authenticator's
+ # defaultBackupState value.
+ optional boolean backupState
# Enable the WebAuthn domain and start intercepting credential storage and
# retrieval with a virtual authenticator.
@@ -11498,6 +11506,15 @@ experimental domain WebAuthn
AuthenticatorId authenticatorId
boolean enabled
+ # Allows setting credential properties.
+ # https://w3c.github.io/webauthn/#sctn-automation-set-credential-properties
+ command setCredentialProperties
+ parameters
+ AuthenticatorId authenticatorId
+ binary credentialId
+ optional boolean backupEligibility
+ optional boolean backupState
+
# Triggered when a credential is added to an authenticator.
event credentialAdded
parameters
Roll protocol to r1259648 — 2024-02-13T04:25:35.000Z
@@ browser_protocol.pdl:9679 @@ experimental domain Storage
# Details for an origin's shared storage.
type SharedStorageMetadata extends object
properties
+ # Time when the origin's shared storage was last created.
Network.TimeSinceEpoch creationTime
+ # Number of key-value pairs stored in origin's shared storage.
integer length
+ # Current amount of bits of entropy remaining in the navigation budget.
number remainingBudget
+ # Total number of bytes stored as key-value pairs in origin's shared
+ # storage.
+ integer bytesUsed
# Pair of reporting metadata details for a candidate URL for `selectURL()`.
type SharedStorageReportingMetadata extends object
Roll protocol to r1258865 — 2024-02-10T04:26:45.000Z
@@ browser_protocol.pdl:309 @@ experimental domain Animation
# `Animation`'s playback rate.
number playbackRate
# `Animation`'s start time.
+ # Milliseconds for time based animations and
+ # percentage [0 - 100] for scroll driven animations
+ # (i.e. when viewOrScrollTimeline exists).
number startTime
# `Animation`'s current time.
number currentTime
@@ -322,6 +325,26 @@ experimental domain Animation
# A unique ID for `Animation` representing the sources that triggered this CSS
# animation/transition.
optional string cssId
+ # View or scroll timeline
+ optional ViewOrScrollTimeline viewOrScrollTimeline
+
+ # Timeline instance
+ type ViewOrScrollTimeline extends object
+ properties
+ # Scroll container node
+ optional DOM.BackendNodeId sourceNodeId
+ # Represents the starting scroll position of the timeline
+ # as a length offset in pixels from scroll origin.
+ optional number startOffset
+ # Represents the ending scroll position of the timeline
+ # as a length offset in pixels from scroll origin.
+ optional number endOffset
+ # The element whose principal box's visibility in the
+ # scrollport defined the progress of the timeline.
+ # Does not exist for animations with ScrollTimeline
+ optional DOM.BackendNodeId subjectNodeId
+ # Orientation of the scroll
+ DOM.ScrollOrientation axis
# AnimationEffect instance
type AnimationEffect extends object
@@ -335,6 +358,9 @@ experimental domain Animation
# `AnimationEffect`'s iterations.
number iterations
# `AnimationEffect`'s iteration duration.
+ # Milliseconds for time based animations and
+ # percentage [0 - 100] for scroll driven animations
+ # (i.e. when viewOrScrollTimeline exists).
number duration
# `AnimationEffect`'s playback direction.
string direction
@@ -2559,6 +2585,12 @@ domain DOM
Block
Both
+ # Physical scroll orientation
+ type ScrollOrientation extends string
+ enum
+ horizontal
+ vertical
+
# DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes.
# DOMNode is a base node mirror type.
type Node extends object
Roll protocol to r1255431 — 2024-02-02T04:26:50.000Z
@@ browser_protocol.pdl:6010 @@ domain Network
StorageAccess
# The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
TopLevelStorageAccess
- # The cookie should have been blocked by 3PCD but is exempted by browser heuristics.
- BrowserHeuristics
+ # The cookie should have been blocked by 3PCD but is exempted by CORS opt-in.
+ CorsOptIn
# A cookie which was not stored from a response with the corresponding reason.
experimental type BlockedSetCookieWithReason extends object
Roll protocol to r1254350 — 2024-01-31T04:26:07.000Z
@@ browser_protocol.pdl:6273 @@ domain Network
# Response to a requestIntercepted with an authChallenge. Must not be set otherwise.
optional AuthChallengeResponse authChallengeResponse
- # Deletes browser cookies with matching name and url or domain/path pair.
+ # Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
command deleteCookies
parameters
# Name of the cookies to remove.
@@ -6285,6 +6285,9 @@ domain Network
optional string domain
# If specified, deletes only cookies with the exact path.
optional string path
+ # If specified, deletes only cookies with the the given name and partitionKey where domain
+ # matches provided URL.
+ optional string partitionKey
# Disables network tracking, prevents network events from being sent to the client.
command disable
Roll protocol to r1253724 — 2024-01-30T04:25:31.000Z
@@ browser_protocol.pdl:5991 @@ domain Network
# RFC6265bis.
NameValuePairExceedsMaxSize
+ # Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
+ experimental type CookieExemptionReason extends string
+ enum
+ # The default value. Cookie with this reason could either be blocked or included.
+ None
+ # The cookie should have been blocked by 3PCD but is exempted by explicit user setting.
+ UserSetting
+ # The cookie should have been blocked by 3PCD but is exempted by metadata mitigation.
+ TPCDMetadata
+ # The cookie should have been blocked by 3PCD but is exempted by Deprecation Trial mitigation.
+ TPCDDeprecationTrial
+ # The cookie should have been blocked by 3PCD but is exempted by heuristics mitigation.
+ TPCDHeuristics
+ # The cookie should have been blocked by 3PCD but is exempted by Enterprise Policy.
+ EnterprisePolicy
+ # The cookie should have been blocked by 3PCD but is exempted by Storage Access API.
+ StorageAccess
+ # The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
+ TopLevelStorageAccess
+ # The cookie should have been blocked by 3PCD but is exempted by browser heuristics.
+ BrowserHeuristics
+
# A cookie which was not stored from a response with the corresponding reason.
experimental type BlockedSetCookieWithReason extends object
properties
@@ -6004,13 +6026,26 @@ domain Network
# errors.
optional Cookie cookie
- # A cookie with was not sent with a request with the corresponding reason.
- experimental type BlockedCookieWithReason extends object
+ # A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
+ # corresponding reason. A cookie could only have at most one exemption reason.
+ experimental type ExemptedSetCookieWithReason extends object
+ properties
+ # The reason the cookie was exempted.
+ CookieExemptionReason exemptionReason
+ # The cookie object representing the cookie.
+ Cookie cookie
+
+ # A cookie associated with the request which may or may not be sent with it.
+ # Includes the cookies itself and reasons for blocking or exemption.
+ experimental type AssociatedCookie extends object
properties
- # The reason(s) the cookie was blocked.
- array of CookieBlockedReason blockedReasons
# The cookie object representing the cookie which was not sent.
Cookie cookie
+ # The reason(s) the cookie was blocked. If empty means the cookie is included.
+ array of CookieBlockedReason blockedReasons
+ # The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
+ # only have at most one exemption reason.
+ optional CookieExemptionReason exemptionReason
# Cookie parameter object
type CookieParam extends object
@@ -6779,8 +6814,8 @@ domain Network
# Request identifier. Used to match this information to an existing requestWillBeSent event.
RequestId requestId
# A list of cookies potentially associated to the requested URL. This includes both cookies sent with
- # the request and the ones not sent; the latter are distinguished by having blockedReason field set.
- array of BlockedCookieWithReason associatedCookies
+ # the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
+ array of AssociatedCookie associatedCookies
# Raw request headers as they will be sent over the wire.
Headers headers
# Connection timing information for the request.
@@ -6818,6 +6853,9 @@ domain Network
optional string cookiePartitionKey
# True if partitioned cookies are enabled, but the partition key is not serializeable to string.
optional boolean cookiePartitionKeyOpaque
+ # A list of cookies which should have been blocked by 3PCD but are exempted and stored from
+ # the response with the corresponding reason.
+ optional array of ExemptedSetCookieWithReason exemptedCookies
# Fired exactly once for each Trust Token operation. Depending on
# the type of the operation and whether the operation succeeded or
Roll protocol to r1253004 — 2024-01-27T04:25:19.000Z
@@ browser_protocol.pdl:10649 @@ experimental domain Tethering
# Connection id to be used.
string connectionId
-experimental domain Tracing
+domain Tracing
depends on IO
# Configuration for memory dump. Used only when "memory-infra" category is enabled.
- type MemoryDumpConfig extends object
+ experimental type MemoryDumpConfig extends object
type TraceConfig extends object
properties
# Controls how the trace buffer stores data.
- optional enum recordMode
+ experimental optional enum recordMode
recordUntilFull
recordContinuously
recordAsMuchAsPossible
echoToConsole
# Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value
# of 200 MB would be used.
- optional number traceBufferSizeInKb
+ experimental optional number traceBufferSizeInKb
# Turns on JavaScript stack sampling.
- optional boolean enableSampling
+ experimental optional boolean enableSampling
# Turns on system tracing.
- optional boolean enableSystrace
+ experimental optional boolean enableSystrace
# Turns on argument filter.
- optional boolean enableArgumentFilter
+ experimental optional boolean enableArgumentFilter
# Included category filters.
optional array of string includedCategories
# Excluded category filters.
optional array of string excludedCategories
# Configuration to synthesize the delays in tracing.
- optional array of string syntheticDelays
+ experimental optional array of string syntheticDelays
# Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
- optional MemoryDumpConfig memoryDumpConfig
+ experimental optional MemoryDumpConfig memoryDumpConfig
# Data format of a trace. Can be either the legacy JSON format or the
# protocol buffer format. Note that the JSON format will be deprecated soon.
- type StreamFormat extends string
+ experimental type StreamFormat extends string
enum
json
proto
# Compression type to use for traces returned via streams.
- type StreamCompression extends string
+ experimental type StreamCompression extends string
enum
none
gzip
@@ -10697,7 +10697,7 @@ experimental domain Tracing
# Details exposed when memory request explicitly declared.
# Keep consistent with memory_dump_request_args.h and
# memory_instrumentation.mojom
- type MemoryDumpLevelOfDetail extends string
+ experimental type MemoryDumpLevelOfDetail extends string
enum
background
light
@@ -10708,7 +10708,7 @@ experimental domain Tracing
# supported on Chrome OS and uses the Perfetto system tracing service.
# `auto` chooses `system` when the perfettoConfig provided to Tracing.start
# specifies at least one non-Chrome data source; otherwise uses `chrome`.
- type TracingBackend extends string
+ experimental type TracingBackend extends string
enum
auto
chrome
@@ -10718,19 +10718,19 @@ experimental domain Tracing
command end
# Gets supported tracing categories.
- command getCategories
+ experimental command getCategories
returns
# A list of supported tracing categories.
array of string categories
# Record a clock sync marker in the trace.
- command recordClockSyncMarker
+ experimental command recordClockSyncMarker
parameters
# The ID of this clock sync marker
string syncId
# Request a global memory dump.
- command requestMemoryDump
+ experimental command requestMemoryDump
parameters
# Enables more deterministic results by forcing garbage collection
optional boolean deterministic
@@ -10746,11 +10746,11 @@ experimental domain Tracing
command start
parameters
# Category/tag filter
- deprecated optional string categories
+ experimental deprecated optional string categories
# Tracing options
- deprecated optional string options
+ experimental deprecated optional string options
# If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
- optional number bufferUsageReportingInterval
+ experimental optional number bufferUsageReportingInterval
# Whether to report trace events as series of dataCollected events or to save trace to a
# stream (defaults to `ReportEvents`).
optional enum transferMode
@@ -10761,16 +10761,16 @@ experimental domain Tracing
optional StreamFormat streamFormat
# Compression format to use. This only applies when using `ReturnAsStream`
# transfer mode (defaults to `none`)
- optional StreamCompression streamCompression
+ experimental optional StreamCompression streamCompression
optional TraceConfig traceConfig
# Base64-encoded serialized perfetto.protos.TraceConfig protobuf message
# When specified, the parameters `categories`, `options`, `traceConfig`
# are ignored.
- optional binary perfettoConfig
+ experimental optional binary perfettoConfig
# Backend type (defaults to `auto`)
- optional TracingBackend tracingBackend
+ experimental optional TracingBackend tracingBackend
- event bufferUsage
+ experimental event bufferUsage
parameters
# A number in range [0..1] that indicates the used size of event buffer as a fraction of its
# total size.
@@ -10783,7 +10783,7 @@ experimental domain Tracing
# Contains a bucket of collected trace events. When tracing is stopped collected events will be
# sent as a sequence of dataCollected events followed by tracingComplete event.
- event dataCollected
+ experimental event dataCollected
parameters
array of object value
Roll protocol to r1252439 — 2024-01-26T04:26:56.000Z
@@ browser_protocol.pdl:9546 @@ experimental domain Storage
started
configResolved
+ # Enum of network fetches auctions can do.
+ type InterestGroupAuctionFetchType extends string
+ enum
+ bidderJs
+ bidderWasm
+ sellerJs
+ bidderTrustedSignals
+ sellerTrustedSignals
+
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
properties
@@ -9825,7 +9834,8 @@ experimental domain Storage
parameters
boolean enable
- # Enables/Disables issuing of interestGroupAuctionEvent events.
+ # Enables/Disables issuing of interestGroupAuctionEventOccurred and
+ # interestGroupAuctionNetworkRequestCreated.
experimental command setInterestGroupAuctionTracking
parameters
boolean enable
@@ -9966,6 +9976,19 @@ experimental domain Storage
# Set for started and configResolved
optional object auctionConfig
+ # Specifies which auctions a particular network fetch may be related to, and
+ # in what role. Note that it is not ordered with respect to
+ # Network.requestWillBeSent (but will happen before loadingFinished
+ # loadingFailed).
+ event interestGroupAuctionNetworkRequestCreated
+ parameters
+ InterestGroupAuctionFetchType type
+ Network.RequestId requestId
+ # This is the set of the auctions using the worklet that issued this
+ # request. In the case of trusted signals, it's possible that only some of
+ # them actually care about the keys being queried.
+ array of InterestGroupAuctionId auctions
+
# Shared storage was accessed by the associated page.
# The following parameters are included in all events.
event sharedStorageAccessed
Roll protocol to r1250650 — 2024-01-23T04:27:23.000Z
@@ browser_protocol.pdl:9546 @@ experimental domain Storage
started
configResolved
- # Enum of network fetches auctions can do.
- type InterestGroupAuctionFetchType extends string
- enum
- bidderJs
- bidderWasm
- sellerJs
- bidderTrustedSignals
- sellerTrustedSignals
-
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
properties
@@ -9834,8 +9825,7 @@ experimental domain Storage
parameters
boolean enable
- # Enables/Disables issuing of interestGroupAuctionEventOccurred and
- # interestGroupAuctionNetworkRequestCreated.
+ # Enables/Disables issuing of interestGroupAuctionEvent events.
experimental command setInterestGroupAuctionTracking
parameters
boolean enable
@@ -9976,19 +9966,6 @@ experimental domain Storage
# Set for started and configResolved
optional object auctionConfig
- # Specifies which auctions a particular network fetch may be related to, and
- # in what role. Note that it is not ordered with respect to
- # Network.requestWillBeSent (but will happen before loadingFinished
- # loadingFailed).
- event interestGroupAuctionNetworkRequestCreated
- parameters
- InterestGroupAuctionFetchType type
- Network.RequestId requestId
- # This is the set of the auctions using the worklet that issued this
- # request. In the case of trusted signals, it's possible that only some of
- # them actually care about the keys being queried.
- array of InterestGroupAuctionId auctions
-
# Shared storage was accessed by the associated page.
# The following parameters are included in all events.
event sharedStorageAccessed
@@ -11855,6 +11832,12 @@ experimental domain FedCm
ErrorGotIt
ErrorMoreDetails
+ # The URLs that each account has
+ type AccountUrlType extends string
+ enum
+ TermsOfService
+ PrivacyPolicy
+
# Corresponds to IdentityRequestAccount
type Account extends object
properties
@@ -11905,6 +11888,12 @@ experimental domain FedCm
string dialogId
DialogButton dialogButton
+ command openUrl
+ parameters
+ string dialogId
+ integer accountIndex
+ AccountUrlType accountUrlType
+
command dismissDialog
parameters
string dialogId
Roll protocol to r1249869 — 2024-01-21T04:26:44.000Z
@@ browser_protocol.pdl:545 @@ experimental domain Audits
Frame
Image
Import
+ JSON
Manifest
Ping
PluginData
Roll protocol to r1249784 — 2024-01-20T04:27:08.000Z
@@ browser_protocol.pdl:9521 @@ experimental domain Storage
string issuerOrigin
number count
+ # Protected audience interest group auction identifier.
+ type InterestGroupAuctionId extends string
+
# Enum of interest group access types.
type InterestGroupAccessType extends string
enum
@@ -9532,8 +9535,25 @@ experimental domain Storage
win
additionalBid
additionalBidWin
+ topLevelBid
+ topLevelAdditionalBid
clear
+ # Enum of auction events.
+ type InterestGroupAuctionEventType extends string
+ enum
+ started
+ configResolved
+
+ # Enum of network fetches auctions can do.
+ type InterestGroupAuctionFetchType extends string
+ enum
+ bidderJs
+ bidderWasm
+ sellerJs
+ bidderTrustedSignals
+ sellerTrustedSignals
+
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
properties
@@ -9813,6 +9833,12 @@ experimental domain Storage
parameters
boolean enable
+ # Enables/Disables issuing of interestGroupAuctionEventOccurred and
+ # interestGroupAuctionNetworkRequestCreated.
+ experimental command setInterestGroupAuctionTracking
+ parameters
+ boolean enable
+
# Gets metadata for an origin's shared storage.
experimental command getSharedStorageMetadata
parameters
@@ -9920,13 +9946,47 @@ experimental domain Storage
# Storage bucket to update.
string bucketId
- # One of the interest groups was accessed by the associated page.
+ # One of the interest groups was accessed. Note that these events are global
+ # to all targets sharing an interest group store.
event interestGroupAccessed
parameters
Network.TimeSinceEpoch accessTime
InterestGroupAccessType type
string ownerOrigin
string name
+ # For topLevelBid/topLevelAdditionalBid, and when appropriate,
+ # win and additionalBidWin
+ optional string componentSellerOrigin
+ # For bid or somethingBid event, if done locally and not on a server.
+ optional number bid
+ optional string bidCurrency
+ # For non-global events --- links to interestGroupAuctionEvent
+ optional InterestGroupAuctionId uniqueAuctionId
+
+ # An auction involving interest groups is taking place. These events are
+ # target-specific.
+ event interestGroupAuctionEventOccurred
+ parameters
+ Network.TimeSinceEpoch eventTime
+ InterestGroupAuctionEventType type
+ InterestGroupAuctionId uniqueAuctionId
+ # Set for child auctions.
+ optional InterestGroupAuctionId parentAuctionId
+ # Set for started and configResolved
+ optional object auctionConfig
+
+ # Specifies which auctions a particular network fetch may be related to, and
+ # in what role. Note that it is not ordered with respect to
+ # Network.requestWillBeSent (but will happen before loadingFinished
+ # loadingFailed).
+ event interestGroupAuctionNetworkRequestCreated
+ parameters
+ InterestGroupAuctionFetchType type
+ Network.RequestId requestId
+ # This is the set of the auctions using the worklet that issued this
+ # request. In the case of trusted signals, it's possible that only some of
+ # them actually care about the keys being queried.
+ array of InterestGroupAuctionId auctions
# Shared storage was accessed by the associated page.
# The following parameters are included in all events.
Roll protocol to r1248698 — 2024-01-18T12:05:32.000Z
@@ browser_protocol.pdl:1299 @@ domain Browser
optional BrowserContextID browserContextId
# Reset all permission management for all origins.
- experimental command resetPermissions
+ command resetPermissions
parameters
# BrowserContext to reset permissions. When omitted, default browser context is used.
optional BrowserContextID browserContextId
@@ -2737,7 +2737,7 @@ domain DOM
# Scrolls the specified rect of the given node into view if not already visible.
# Note: exactly one between nodeId, backendNodeId and objectId should be passed
# to identify the node.
- experimental command scrollIntoViewIfNeeded
+ command scrollIntoViewIfNeeded
parameters
# Identifier of the node.
optional NodeId nodeId
@@ -4045,7 +4045,7 @@ domain Emulation
optional boolean enabled
# Enables CPU throttling to emulate slow CPUs.
- experimental command setCPUThrottlingRate
+ command setCPUThrottlingRate
parameters
# Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
number rate
@@ -4124,7 +4124,7 @@ domain Emulation
optional array of MediaFeature features
# Emulates the given vision deficiency.
- experimental command setEmulatedVisionDeficiency
+ command setEmulatedVisionDeficiency
parameters
# Vision deficiency to emulate. Order: best-effort emulations come first, followed by any
# physiologically accurate emulations for medically recognized color vision deficiencies.
@@ -4173,7 +4173,7 @@ domain Emulation
SensorReading reading
# Overrides the Idle state.
- experimental command setIdleOverride
+ command setIdleOverride
parameters
# Mock isUserActive
boolean isUserActive
@@ -4181,7 +4181,7 @@ domain Emulation
boolean isScreenUnlocked
# Clears Idle state overrides.
- experimental command clearIdleOverride
+ command clearIdleOverride
# Overrides value returned by the javascript navigator object.
experimental deprecated command setNavigatorOverrides
@@ -4234,7 +4234,7 @@ domain Emulation
optional string locale
# Overrides default host system timezone with the specified one.
- experimental command setTimezoneOverride
+ command setTimezoneOverride
parameters
# The timezone identifier. If empty, disables the override and
# restores default host system timezone.
@@ -6376,7 +6376,7 @@ domain Network
array of string urls
# Toggles ignoring of service worker for each request.
- experimental command setBypassServiceWorker
+ command setBypassServiceWorker
parameters
# Bypass service worker and load from network.
boolean bypass
@@ -8400,7 +8400,7 @@ domain Page
boolean enabled
# Enable page Content Security Policy by-passing.
- experimental command setBypassCSP
+ command setBypassCSP
parameters
# Whether to bypass page CSP.
boolean enabled
@@ -8512,7 +8512,7 @@ domain Page
optional number accuracy
# Controls whether page will emit lifecycle events.
- experimental command setLifecycleEventsEnabled
+ command setLifecycleEventsEnabled
parameters
# If true, starts emitting lifecycle events.
boolean enabled
@@ -8552,7 +8552,7 @@ domain Page
experimental command crash
# Tries to close page, running its beforeunload hooks, if any.
- experimental command close
+ command close
# Tries to update the web lifecycle state of the page.
# It will transition the page to the given state according to:
@@ -8622,7 +8622,7 @@ domain Page
# Intercept file chooser requests and transfer control to protocol clients.
# When file chooser interception is enabled, native file chooser dialog is not shown.
# Instead, a protocol event `Page.fileChooserOpened` is emitted.
- experimental command setInterceptFileChooserDialog
+ command setInterceptFileChooserDialog
parameters
boolean enabled
@@ -9308,7 +9308,7 @@ domain Security
command enable
# Enable/disable whether all certificate errors should be ignored.
- experimental command setIgnoreCertificateErrors
+ command setIgnoreCertificateErrors
parameters
# If true, all certificate errors will be ignored.
boolean ignore
@@ -10374,23 +10374,23 @@ domain Target
# Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
# one.
- experimental command createBrowserContext
+ command createBrowserContext
parameters
# If specified, disposes this context when debugging session disconnects.
- optional boolean disposeOnDetach
+ experimental optional boolean disposeOnDetach
# Proxy server, similar to the one passed to --proxy-server
- optional string proxyServer
+ experimental optional string proxyServer
# Proxy bypass list, similar to the one passed to --proxy-bypass-list
- optional string proxyBypassList
+ experimental optional string proxyBypassList
# An optional list of origins to grant unlimited cross-origin access to.
# Parts of the URL other than those constituting origin are ignored.
- optional array of string originsWithUniversalNetworkAccess
+ experimental optional array of string originsWithUniversalNetworkAccess
returns
# The id of the context created.
Browser.BrowserContextID browserContextId
# Returns all browser contexts created with `Target.createBrowserContext` method.
- experimental command getBrowserContexts
+ command getBrowserContexts
returns
# An array of browser context ids.
array of Browser.BrowserContextID browserContextIds
@@ -10430,7 +10430,7 @@ domain Target
# Deletes a BrowserContext. All the belonging pages will be closed without calling their
# beforeunload hooks.
- experimental command disposeBrowserContext
+ command disposeBrowserContext
parameters
Browser.BrowserContextID browserContextId
@@ -10468,7 +10468,7 @@ domain Target
# automatically detaches from all currently attached targets.
# This also clears all targets added by `autoAttachRelated` from the list of targets to watch
# for creation of related targets.
- experimental command setAutoAttach
+ command setAutoAttach
parameters
# Whether to auto-attach to related targets.
boolean autoAttach
@@ -10478,7 +10478,7 @@ domain Target
# Enables "flat" access to the session via specifying sessionId attribute in the commands.
# We plan to make this the default, deprecate non-flattened mode,
# and eventually retire it. See crbug.com/991325.
- optional boolean flatten
+ experimental optional boolean flatten
# Only targets matching filter will be attached.
experimental optional TargetFilter filter
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index 4754f17c..8dad9c98 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -1665,7 +1665,7 @@ domain Runtime
# 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
+ command addBinding
parameters
string name
# If specified, the binding would only be exposed to the specified
@@ -1675,17 +1675,17 @@ domain Runtime
# 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
+ experimental 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
+ 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
+ command removeBinding
parameters
string name
Roll protocol to r1247362 — 2024-01-16T04:27:14.000Z
@@ browser_protocol.pdl:5720 @@ domain Network
deprecated optional string headersText
# Resource mimeType as determined by the browser.
string mimeType
+ # Resource charset as determined by the browser (if applicable).
+ string charset
# Refined HTTP request headers that were actually transmitted over the network.
optional Headers requestHeaders
# HTTP request headers text. This has been replaced by the headers in Network.requestWillBeSentExtraInfo.
Roll protocol to r1245094 — 2024-01-10T04:27:17.000Z
@@ browser_protocol.pdl:8907 @@ domain Page
WebSocketSticky
SmartCard
LiveMediaStreamTrack
+ UnloadHandler
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1239539 — 2023-12-20T04:24:43.000Z
@@ browser_protocol.pdl:1083 @@ experimental domain Autofill
string autofillType
# The filling strategy
FillingStrategy fillingStrategy
+ # The form field's DOM node
+ DOM.BackendNodeId fieldId
# Emitted when an address form is filled.
event addressFormFilled
Roll protocol to r1238944 — 2023-12-19T04:26:54.000Z
@@ browser_protocol.pdl:7672 @@ domain Page
private-aggregation
private-state-token-issuance
private-state-token-redemption
+ publickey-credentials-create
publickey-credentials-get
run-ad-auction
screen-wake-lock
@@ -8903,6 +8904,7 @@ domain Page
WebTransportSticky
WebSocketSticky
SmartCard
+ LiveMediaStreamTrack
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1237913 — 2023-12-15T04:26:59.000Z
@@ browser_protocol.pdl:7681 @@ domain Page
shared-storage-select-url
smart-card
storage-access
+ sub-apps
sync-xhr
unload
usb
Roll protocol to r1236148 — 2023-12-12T04:26:53.000Z
@@ browser_protocol.pdl:1221 @@ domain Browser
audioCapture
backgroundSync
backgroundFetch
+ capturedSurfaceControl
clipboardReadWrite
clipboardSanitizedWrite
displayCapture
@@ -1988,6 +1989,10 @@ experimental domain CSS
string ruleText
# Text position of a new rule in the target style sheet.
SourceRange location
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
+ # incorrect results if the declaration contains a var() for example.
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
returns
# The newly created rule.
CSSRule rule
@@ -2231,6 +2236,10 @@ experimental domain CSS
command setStyleTexts
parameters
array of StyleDeclarationEdit edits
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
+ # incorrect results if the declaration contains a var() for example.
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
returns
# The resulting styles after modification.
array of CSSStyle styles
@@ -7607,6 +7616,7 @@ domain Page
bluetooth
browsing-topics
camera
+ captured-surface-control
ch-dpr
ch-device-memory
ch-downlink
@@ -9959,6 +9969,17 @@ experimental domain Storage
string key
array of string values
+ experimental type AttributionReportingFilterConfig extends object
+ properties
+ array of AttributionReportingFilterDataEntry filterValues
+ # duration in seconds
+ optional integer lookbackWindow
+
+ experimental type AttributionReportingFilterPair extends object
+ properties
+ array of AttributionReportingFilterConfig filters
+ array of AttributionReportingFilterConfig notFilters
+
experimental type AttributionReportingAggregationKeysEntry extends object
properties
string key
@@ -10017,13 +10038,99 @@ experimental domain Storage
reportingOriginsPerSiteLimitReached
exceedsMaxChannelCapacity
- # TODO(crbug.com/1458532): Add other Attribution Reporting events, e.g.
- # trigger registration.
experimental event attributionReportingSourceRegistered
parameters
AttributionReportingSourceRegistration registration
AttributionReportingSourceRegistrationResult result
+ experimental type AttributionReportingSourceRegistrationTimeConfig extends string
+ enum
+ include
+ exclude
+
+ experimental type AttributionReportingAggregatableValueEntry extends object
+ properties
+ string key
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ number value
+
+ experimental type AttributionReportingEventTriggerData extends object
+ properties
+ UnsignedInt64AsBase10 data
+ SignedInt64AsBase10 priority
+ optional UnsignedInt64AsBase10 dedupKey
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingAggregatableTriggerData extends object
+ properties
+ UnsignedInt128AsBase16 keyPiece
+ array of string sourceKeys
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingAggregatableDedupKey extends object
+ properties
+ optional UnsignedInt64AsBase10 dedupKey
+ AttributionReportingFilterPair filters
+
+ experimental type AttributionReportingTriggerRegistration extends object
+ properties
+ AttributionReportingFilterPair filters
+ optional UnsignedInt64AsBase10 debugKey
+ array of AttributionReportingAggregatableDedupKey aggregatableDedupKeys
+ array of AttributionReportingEventTriggerData eventTriggerData
+ array of AttributionReportingAggregatableTriggerData aggregatableTriggerData
+ array of AttributionReportingAggregatableValueEntry aggregatableValues
+ boolean debugReporting
+ optional string aggregationCoordinatorOrigin
+ AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
+ optional string triggerContextId
+
+ experimental type AttributionReportingEventLevelResult extends string
+ enum
+ success
+ successDroppedLowerPriority
+ internalError
+ noCapacityForAttributionDestination
+ noMatchingSources
+ deduplicated
+ excessiveAttributions
+ priorityTooLow
+ neverAttributedSource
+ excessiveReportingOrigins
+ noMatchingSourceFilterData
+ prohibitedByBrowserPolicy
+ noMatchingConfigurations
+ excessiveReports
+ falselyAttributedSource
+ reportWindowPassed
+ notRegistered
+ reportWindowNotStarted
+ noMatchingTriggerData
+
+ experimental type AttributionReportingAggregatableResult extends string
+ enum
+ success
+ internalError
+ noCapacityForAttributionDestination
+ noMatchingSources
+ excessiveAttributions
+ excessiveReportingOrigins
+ noHistograms
+ insufficientBudget
+ noMatchingSourceFilterData
+ notRegistered
+ prohibitedByBrowserPolicy
+ deduplicated
+ reportWindowPassed
+ excessiveReports
+
+ experimental event attributionReportingTriggerRegistered
+ parameters
+ AttributionReportingTriggerRegistration registration
+ AttributionReportingEventLevelResult eventLevel
+ AttributionReportingAggregatableResult aggregatable
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1235375 — 2023-12-09T04:26:39.000Z
@@ browser_protocol.pdl:8891 @@ domain Page
WebRTCSticky
WebTransportSticky
WebSocketSticky
+ SmartCard
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1234845 — 2023-12-08T04:27:01.000Z
@@ browser_protocol.pdl:6465 @@ domain Network
integer dataLength
# Actual bytes received (might be less than dataLength for compressed encodings).
integer encodedDataLength
+ # Data that was received.
+ experimental optional binary data
+
+ # Enables streaming of the response for the given requestId.
+ # If enabled, the dataReceived event contains the data that was received during streaming.
+ experimental command streamResourceContent
+ parameters
+ # Identifier of the request to stream.
+ RequestId requestId
+ returns
+ # Data that has been buffered until streaming is enabled.
+ binary bufferedData
# Fired when EventSource message is received.
event eventSourceMessageReceived
Roll protocol to r1233758 — 2023-12-06T04:27:12.000Z
@@ browser_protocol.pdl:11577 @@ experimental domain Preload
PrefetchFailedNetError
PrefetchFailedNon2XX
PrefetchFailedPerPageLimitExceeded
- PrefetchEvicted
+ PrefetchEvictedAfterCandidateRemoved
+ PrefetchEvictedForNewerPrefetch
PrefetchHeldback
# A previous prefetch to the origin got a HTTP 503 response with an
# Retry-After header that has no elapsed yet.
Roll protocol to r1233178 — 2023-12-05T04:26:58.000Z
@@ browser_protocol.pdl:554 @@ experimental domain Audits
Script
ServiceWorker
SharedWorker
+ SpeculationRules
Stylesheet
Track
Video
Roll protocol to r1232444 — 2023-12-03T04:26:26.000Z
@@ browser_protocol.pdl:3916 @@ domain Emulation
# A display feature that only splits content will have a 0 mask_length.
integer maskLength
+ type DevicePosture extends object
+ properties
+ # Current posture of the device
+ enum type
+ continuous
+ folded
+
type MediaFeature extends object
properties
string name
@@ -4073,6 +4080,9 @@ domain Emulation
# If set, the display feature of a multi-segment screen. If not set, multi-segment support
# is turned-off.
experimental optional DisplayFeature displayFeature
+ # If set, the posture of a foldable device. If not set the posture is set
+ # to continuous.
+ experimental optional DevicePosture devicePosture
experimental command setScrollbarsHidden
parameters
Roll protocol to r1231733 — 2023-12-01T04:27:08.000Z
@@ browser_protocol.pdl:11103 @@ experimental domain WebAuthn
# Sets whether User Verification succeeds or fails for an authenticator.
# Defaults to false.
optional boolean isUserVerified
+ # Credentials created by this authenticator will have the backup
+ # eligibility (BE) flag set to this value. Defaults to false.
+ # https://w3c.github.io/webauthn/#sctn-credential-backup
+ optional boolean defaultBackupEligibility
+ # Credentials created by this authenticator will have the backup state
+ # (BS) flag set to this value. Defaults to false.
+ # https://w3c.github.io/webauthn/#sctn-credential-backup
+ optional boolean defaultBackupState
type Credential extends object
properties
@@ -11671,6 +11679,12 @@ experimental domain FedCm
string title
optional string subtitle
+ # Triggered when a dialog is closed, either by user action, JS abort,
+ # or a command below.
+ event dialogClosed
+ parameters
+ string dialogId
+
command enable
parameters
# Allows callers to disable the promise rejection delay that would
Roll protocol to r1231134 — 2023-11-30T04:27:01.000Z
@@ browser_protocol.pdl:7651 @@ domain Page
sync-xhr
unload
usb
+ usb-unrestricted
vertical-scroll
web-printing
web-share
@@ -11636,11 +11637,14 @@ experimental domain FedCm
AccountChooser
AutoReauthn
ConfirmIdpLogin
+ Error
# The buttons on the FedCM dialog.
type DialogButton extends string
enum
ConfirmIdpLoginContinue
+ ErrorGotIt
+ ErrorMoreDetails
# Corresponds to IdentityRequestAccount
type Account extends object
Roll protocol to r1227788 — 2023-11-22T04:27:05.000Z
@@ browser_protocol.pdl:5679 @@ domain Network
# This value is used when the reason is unknown.
unspecifiedReason
+ experimental type ServiceWorkerRouterInfo extends object
+ properties
+ integer ruleIdMatched
+
# HTTP response data.
type Response extends object
properties
@@ -5712,6 +5716,8 @@ domain Network
optional boolean fromServiceWorker
# Specifies that the request was served from the prefetch cache.
optional boolean fromPrefetchCache
+ # Infomation about how Service Worker Static Router was used.
+ experimental optional ServiceWorkerRouterInfo serviceWorkerRouterInfo
# Total number of bytes received for this request so far.
number encodedDataLength
# Timing information for the given request.
Roll protocol to r1227218 — 2023-11-21T04:27:08.000Z
@@ browser_protocol.pdl:5827 @@ domain Network
# Cookie Priority
experimental CookiePriority priority
# True if cookie is SameParty.
- experimental boolean sameParty
+ experimental deprecated boolean sameParty
# Cookie source scheme type.
experimental CookieSourceScheme sourceScheme
# Cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port.
@@ -8155,16 +8155,6 @@ domain Page
# as an ad. Only sent if frame is labelled as an ad and id is available.
optional AdScriptId adScriptId
- # Returns all browser cookies for the page and all of its subframes. Depending
- # on the backend support, will return detailed cookie information in the
- # `cookies` field.
- experimental deprecated command getCookies
- # Use 'Network.getCookies' instead
- redirect Network
- returns
- # Array of cookie objects.
- array of Network.Cookie cookies
-
# Returns present frame tree structure.
command getFrameTree
returns
Roll protocol to r1226504 — 2023-11-18T04:27:17.000Z
@@ browser_protocol.pdl:8307 @@ domain Page
ReturnAsStream
# Whether or not to generate tagged (accessible) PDF. Defaults to embedder choice.
experimental optional boolean generateTaggedPDF
+ # Whether or not to embed the document outline into the PDF.
+ experimental optional boolean generateDocumentOutline
returns
# Base64-encoded pdf data. Empty if |returnAsStream| is specified.
binary data
Roll protocol to r1225305 — 2023-11-16T04:27:11.000Z
@@ browser_protocol.pdl:1847 @@ experimental domain CSS
properties
# Font's family name reported by platform.
string familyName
+ # Font's PostScript name reported by platform.
+ string postScriptName
# Indicates if the font was downloaded or resolved locally.
boolean isCustomFont
# Amount of glyphs that were rendered with this font.
Roll protocol to r1224742 — 2023-11-15T04:26:44.000Z
@@ browser_protocol.pdl:4250 @@ domain Emulation
parameters
# User agent to use.
string userAgent
- # Browser langugage to emulate.
+ # Browser language to emulate.
optional string acceptLanguage
# The platform navigator.platform should return.
optional string platform
@@ -6427,7 +6427,7 @@ domain Network
parameters
# User agent to use.
string userAgent
- # Browser langugage to emulate.
+ # Browser language to emulate.
optional string acceptLanguage
# The platform navigator.platform should return.
optional string platform
Roll protocol to r1224083 — 2023-11-14T04:26:27.000Z
@@ browser_protocol.pdl:1926 @@ experimental domain CSS
string syntax
+ # CSS font-palette-values rule representation.
+ type CSSFontPaletteValuesRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated font palette name.
+ Value fontPaletteName
+ # Associated style declaration.
+ CSSStyle style
+
# CSS property at-rule representation.
type CSSPropertyRule extends object
properties
@@ -2070,6 +2083,8 @@ experimental domain CSS
optional array of CSSPropertyRule cssPropertyRules
# A list of CSS property registrations matching this node.
optional array of CSSPropertyRegistration cssPropertyRegistrations
+ # A font-palette-values rule matching this node.
+ optional CSSFontPaletteValuesRule cssFontPaletteValuesRule
# Id of the first parent element that does not have display: contents.
experimental optional DOM.NodeId parentLayoutNodeId
Roll protocol to r1222075 — 2023-11-09T04:26:36.000Z
@@ browser_protocol.pdl:11615 @@ experimental domain FedCm
SignIn
SignUp
- # Whether the dialog shown is an account chooser or an auto re-authentication dialog.
+ # The types of FedCM dialogs.
type DialogType extends string
enum
AccountChooser
AutoReauthn
ConfirmIdpLogin
+ # The buttons on the FedCM dialog.
+ type DialogButton extends string
+ enum
+ ConfirmIdpLoginContinue
+
# Corresponds to IdentityRequestAccount
type Account extends object
properties
@@ -11661,11 +11666,10 @@ experimental domain FedCm
string dialogId
integer accountIndex
- # Only valid if the dialog type is ConfirmIdpLogin. Acts as if the user had
- # clicked the continue button.
- command confirmIdpLogin
+ command clickDialogButton
parameters
string dialogId
+ DialogButton dialogButton
command dismissDialog
parameters
Roll protocol to r1220723 — 2023-11-07T04:26:31.000Z
@@ browser_protocol.pdl:9931 @@ experimental domain Storage
# duration in seconds
array of integer ends
+ experimental type AttributionReportingTriggerSpec extends object
+ properties
+ # number instead of integer because not all uint32 can be represented by
+ # int
+ array of number triggerData
+ AttributionReportingEventReportWindows eventReportWindows
+
experimental type AttributionReportingTriggerDataMatching extends string
enum
exact
@@ -9941,7 +9948,7 @@ experimental domain Storage
Network.TimeSinceEpoch time
# duration in seconds
integer expiry
- AttributionReportingEventReportWindows eventReportWindows
+ array of AttributionReportingTriggerSpec triggerSpecs
# duration in seconds
integer aggregatableReportWindow
AttributionReportingSourceType type
Roll protocol to r1219864 — 2023-11-04T04:26:10.000Z
@@ browser_protocol.pdl:827 @@ experimental domain Audits
IdTokenHttpNotFound
IdTokenNoResponse
IdTokenInvalidResponse
+ IdTokenIdpErrorResponse
+ IdTokenCrossSiteIdpErrorResponse
IdTokenInvalidRequest
IdTokenInvalidContentType
ErrorIdToken
@@ -1249,7 +1251,7 @@ domain Browser
prompt
# Definition of PermissionDescriptor defined in the Permissions API:
- # https://w3c.github.io/permissions/#dictdef-permissiondescriptor.
+ # https://w3c.github.io/permissions/#dom-permissiondescriptor.
experimental type PermissionDescriptor extends object
properties
# Name of permission.
@@ -7627,6 +7629,7 @@ domain Page
unload
usb
vertical-scroll
+ web-printing
web-share
# Alias for 'window-placement' (crbug.com/1328581).
window-management
Roll protocol to r1218079 — 2023-11-01T04:26:32.000Z
@@ browser_protocol.pdl:9344 @@ experimental domain ServiceWorker
optional number scriptResponseTime
optional array of Target.TargetID controlledClients
optional Target.TargetID targetId
+ optional string routerRules
# ServiceWorker error message.
type ServiceWorkerErrorMessage extends object
@@ -11571,6 +11572,13 @@ experimental domain Preload
PrefetchStatus prefetchStatus
Network.RequestId requestId
+ # Information of headers to be displayed when the header mismatch occurred.
+ type PrerenderMismatchedHeaders extends object
+ properties
+ string headerName
+ optional string initialValue
+ optional string activationValue
+
# Fired when a prerender attempt is updated.
event prerenderStatusUpdated
parameters
@@ -11580,6 +11588,7 @@ experimental domain Preload
# This is used to give users more information about the name of Mojo interface
# that is incompatible with prerender and has caused the cancellation of the attempt.
optional string disallowedMojoInterface
+ optional array of PrerenderMismatchedHeaders mismatchedHeaders
# Send a list of sources for all preloading attempts in a document.
event preloadingAttemptSourcesUpdated
Roll protocol to r1213968 — 2023-10-24T04:26:10.000Z
@@ browser_protocol.pdl:9927 @@ experimental domain Storage
# duration in seconds
array of integer ends
+ experimental type AttributionReportingTriggerDataMatching extends string
+ enum
+ exact
+ modulus
+
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
@@ -9944,6 +9949,7 @@ experimental domain Storage
array of AttributionReportingFilterDataEntry filterData
array of AttributionReportingAggregationKeysEntry aggregationKeys
optional UnsignedInt64AsBase10 debugKey
+ AttributionReportingTriggerDataMatching triggerDataMatching
experimental type AttributionReportingSourceRegistrationResult extends string
enum
Roll protocol to r1212569 — 2023-10-20T04:26:29.000Z
@@ browser_protocol.pdl:8886 @@ domain Page
PageSupportNeeded
Circumstantial
+ experimental type BackForwardCacheBlockingDetails extends object
+ properties
+ # Url of the file where blockage happened. Optional because of tests.
+ optional string url
+ # Function name where blockage happened. Optional because of anonymous functions and tests.
+ optional string function
+ # Line number in the script (0-based).
+ integer lineNumber
+ # Column number in the script (0-based).
+ integer columnNumber
+
experimental type BackForwardCacheNotRestoredExplanation extends object
properties
# Type of the reason
@@ -8897,6 +8908,7 @@ domain Page
# - EmbedderExtensionSentMessageToCachedFrame: the extension ID.
#
optional string context
+ optional array of BackForwardCacheBlockingDetails details
experimental type BackForwardCacheNotRestoredExplanationTree extends object
properties
Roll protocol to r1211954 — 2023-10-19T04:26:27.000Z
@@ browser_protocol.pdl:498 @@ experimental domain Audits
WarnAttributeValueExceedsMaxSize
WarnDomainNonASCII
WarnThirdPartyPhaseout
+ WarnCrossSiteRedirectDowngradeChangesInclusion
type CookieOperation extends string
enum
@@ -770,6 +771,15 @@ experimental domain Audits
properties
array of string trackingSites
+ # This issue warns about third-party sites that are accessing cookies on the
+ # current page, and have been permitted due to having a global metadata grant.
+ # Note that in this context 'site' means eTLD+1. For example, if the URL
+ # `https://example.test:80/web_page` was accessing cookies, the site reported
+ # would be `example.test`.
+ type CookieDeprecationMetadataIssueDetails extends object
+ properties
+ array of string allowedSites
+
type ClientHintIssueReason extends string
enum
# Items in the accept-ch meta tag allow list must be valid origins.
@@ -915,6 +925,7 @@ experimental domain Audits
ClientHintIssue
FederatedAuthRequestIssue
BounceTrackingIssue
+ CookieDeprecationMetadataIssue
StylesheetLoadingIssue
FederatedAuthUserInfoRequestIssue
PropertyRuleIssue
@@ -940,6 +951,7 @@ experimental domain Audits
optional ClientHintIssueDetails clientHintIssueDetails
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
optional BounceTrackingIssueDetails bounceTrackingIssueDetails
+ optional CookieDeprecationMetadataIssueDetails cookieDeprecationMetadataIssueDetails
optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
@@ -3923,6 +3935,49 @@ domain Emulation
optional string bitness
optional boolean wow64
+ # Used to specify sensor types to emulate.
+ # See https://w3c.github.io/sensors/#automation for more information.
+ experimental type SensorType extends string
+ enum
+ absolute-orientation
+ accelerometer
+ ambient-light
+ gravity
+ gyroscope
+ linear-acceleration
+ magnetometer
+ proximity
+ relative-orientation
+
+ experimental type SensorMetadata extends object
+ properties
+ optional boolean available
+ optional number minimumFrequency
+ optional number maximumFrequency
+
+ experimental type SensorReadingSingle extends object
+ properties
+ number value
+
+ experimental type SensorReadingXYZ extends object
+ properties
+ number x
+ number y
+ number z
+
+ experimental type SensorReadingQuaternion extends object
+ properties
+ number x
+ number y
+ number z
+ number w
+
+ experimental type SensorReading extends object
+ properties
+ optional SensorReadingSingle single
+ optional SensorReadingXYZ xyz
+ optional SensorReadingQuaternion quaternion
+
# Tells whether emulation is supported.
command canEmulate
returns
@@ -4052,6 +4107,30 @@ domain Emulation
# Mock accuracy
optional number accuracy
+ experimental command getOverriddenSensorInformation
+ parameters
+ SensorType type
+ returns
+ number requestedSamplingFrequency
+
+ # Overrides a platform sensor of a given type. If |enabled| is true, calls to
+ # Sensor.start() will use a virtual sensor as backend rather than fetching
+ # data from a real hardware sensor. Otherwise, existing virtual
+ # sensor-backend Sensor objects will fire an error event and new calls to
+ # Sensor.start() will attempt to use a real sensor instead.
+ experimental command setSensorOverrideEnabled
+ parameters
+ boolean enabled
+ SensorType type
+ optional SensorMetadata metadata
+
+ # Updates the sensor readings reported by a sensor type previously overriden
+ # by setSensorOverrideEnabled.
+ experimental command setSensorOverrideReadings
+ parameters
+ SensorType type
+ SensorReading reading
+
# Overrides the Idle state.
experimental command setIdleOverride
parameters
Roll protocol to r1209236 — 2023-10-13T04:26:43.000Z
@@ browser_protocol.pdl:7111 @@ experimental domain Overlay
# The content box highlight outline color (default: transparent).
optional DOM.RGBA outlineColor
+ # Configuration for Window Controls Overlay
+ type WindowControlsOverlayConfig extends object
+ properties
+ # Whether the title bar CSS should be shown when emulating the Window Controls Overlay.
+ boolean showCSS
+ # Seleted platforms to show the overlay.
+ string selectedPlatform
+ # The theme color defined in app manifest.
+ string themeColor
+
type ContainerQueryHighlightConfig extends object
properties
# A descriptor for the highlight appearance of container query containers.
@@ -7361,6 +7371,12 @@ experimental domain Overlay
# An array of node identifiers and descriptors for the highlight appearance.
array of IsolatedElementHighlightConfig isolatedElementHighlightConfigs
+ # Show Window Controls Overlay for PWA
+ command setShowWindowControlsOverlay
+ parameters
+ # Window Controls Overlay data, null means hide Window Controls Overlay
+ optional WindowControlsOverlayConfig windowControlsOverlayConfig
+
# Fired when the node should be inspected. This happens after call to `setInspectMode` or when
# user manually inspects an element.
event inspectNodeRequested
Roll protocol to r1208070 — 2023-10-11T04:26:19.000Z
@@ browser_protocol.pdl:11376 @@ experimental domain Preload
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
PrerenderingDisabledByDevTools
- ResourceLoadBlockedByClient
SpeculationRuleRemoved
ActivatedWithAuxiliaryBrowsingContexts
MaxNumOfRunningEagerPrerendersExceeded
Roll protocol to r1207450 — 2023-10-10T04:26:17.000Z
@@ browser_protocol.pdl:4499 @@ domain Input
# The normalized tangential pressure, which has a range of [-1,1] (default: 0).
experimental optional number tangentialPressure
# The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
- experimental optional integer tiltX
+ optional number tiltX
# The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
- experimental optional integer tiltY
+ optional number tiltY
# The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
experimental optional integer twist
# Identifier used to track touch sources between events, must be unique within an event.
@@ -4667,9 +4667,9 @@ domain Input
# The normalized tangential pressure, which has a range of [-1,1] (default: 0).
experimental optional number tangentialPressure
# The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0).
- experimental optional integer tiltX
+ optional number tiltX
# The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
- experimental optional integer tiltY
+ optional number tiltY
# The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
experimental optional integer twist
# X delta in CSS pixels for mouse wheel event (default: 0).
Roll protocol to r1206220 — 2023-10-06T04:26:22.000Z
@@ browser_protocol.pdl:9824 @@ experimental domain Storage
properties
Network.TimeSinceEpoch time
# duration in seconds
- optional integer expiry
- # eventReportWindow and eventReportWindows are mutually exclusive
+ integer expiry
+ AttributionReportingEventReportWindows eventReportWindows
# duration in seconds
- optional integer eventReportWindow
- optional AttributionReportingEventReportWindows eventReportWindows
- # duration in seconds
- optional integer aggregatableReportWindow
+ integer aggregatableReportWindow
AttributionReportingSourceType type
string sourceOrigin
string reportingOrigin
Roll protocol to r1205644 — 2023-10-05T04:26:19.000Z
@@ browser_protocol.pdl:824 @@ experimental domain Audits
RpPageNotVisible
SilentMediationFailure
ThirdPartyCookiesBlocked
+ NotSignedInWithIdp
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
@@ -3268,7 +3269,6 @@ domain DOM
# execution will stop on these operations as if there was a regular breakpoint set.
domain DOMDebugger
depends on DOM
- depends on Debugger
depends on Runtime
# DOM breakpoint type.
@@ -3340,7 +3340,8 @@ domain DOMDebugger
experimental optional string targetName
# Removes breakpoint on particular native event.
- experimental command removeInstrumentationBreakpoint
+ experimental deprecated command removeInstrumentationBreakpoint
+ redirect EventBreakpoints
parameters
# Instrumentation name to stop on.
string eventName
@@ -3375,7 +3376,8 @@ domain DOMDebugger
experimental optional string targetName
# Sets breakpoint on particular native event.
- experimental command setInstrumentationBreakpoint
+ experimental deprecated command setInstrumentationBreakpoint
+ redirect EventBreakpoints
parameters
# Instrumentation name to stop on.
string eventName
@@ -3386,10 +3388,9 @@ domain DOMDebugger
# Resource URL substring. All XHRs having this substring in the URL will get stopped upon.
string url
-# 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.
+# EventBreakpoints permits setting JavaScript breakpoints on operations and events
+# occurring in native code invoked from JavaScript. Once breakpoint is hit, it is
+# reported through Debugger domain, similarly to regular breakpoints being hit.
experimental domain EventBreakpoints
# Sets breakpoint on particular native event.
command setInstrumentationBreakpoint
@@ -3403,6 +3404,9 @@ experimental domain EventBreakpoints
# Instrumentation name to stop on.
string eventName
+ # Removes all breakpoints
+ command disable
+
# This domain facilitates obtaining document snapshots with DOM, layout, and style information.
experimental domain DOMSnapshot
depends on CSS
Roll protocol to r1204456 — 2023-10-03T04:26:51.000Z
@@ browser_protocol.pdl:9359 @@ experimental domain Storage
win
additionalBid
additionalBidWin
+ clear
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
@@ -11487,7 +11488,7 @@ experimental domain FedCm
enum
AccountChooser
AutoReauthn
- ConfirmIdpSignin
+ ConfirmIdpLogin
# Corresponds to IdentityRequestAccount
type Account extends object
@@ -11498,7 +11499,7 @@ experimental domain FedCm
string givenName
string pictureUrl
string idpConfigUrl
- string idpSigninUrl
+ string idpLoginUrl
LoginState loginState
# These two are only set if the loginState is signUp
optional string termsOfServiceUrl
@@ -11528,9 +11529,9 @@ experimental domain FedCm
string dialogId
integer accountIndex
- # Only valid if the dialog type is ConfirmIdpSignin. Acts as if the user had
+ # Only valid if the dialog type is ConfirmIdpLogin. Acts as if the user had
# clicked the continue button.
- command confirmIdpSignin
+ command confirmIdpLogin
parameters
string dialogId
Roll protocol to r1203626 — 2023-09-30T04:26:42.000Z
@@ browser_protocol.pdl:11322 @@ experimental domain Preload
LowEndDevice
InvalidSchemeRedirect
InvalidSchemeNavigation
- InProgressNavigation
NavigationRequestBlockedByCsp
MainFrameNavigation
MojoBinderPolicy
Roll protocol to r1203060 — 2023-09-29T04:26:12.000Z
@@ browser_protocol.pdl:9363 @@ experimental domain Storage
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
properties
- string renderUrl
+ string renderURL
optional string metadata
# The full details of an interest group.
@@ -9373,10 +9373,10 @@ experimental domain Storage
string name
Network.TimeSinceEpoch expirationTime
string joiningOrigin
- optional string biddingUrl
- optional string biddingWasmHelperUrl
- optional string updateUrl
- optional string trustedBiddingSignalsUrl
+ optional string biddingLogicURL
+ optional string biddingWasmHelperURL
+ optional string updateURL
+ optional string trustedBiddingSignalsURL
array of string trustedBiddingSignalsKeys
optional string userBiddingSignals
array of InterestGroupAd ads
@@ -11385,18 +11385,6 @@ experimental domain Preload
RedirectedPrerenderingUrlHasEffectiveUrl
ActivationUrlHasEffectiveUrl
- # Fired when a prerender attempt is completed.
- event prerenderAttemptCompleted
- parameters
- PreloadingAttemptKey key
- # The frame id of the frame initiating prerendering.
- Page.FrameId initiatingFrameId
- string prerenderingUrl
- PrerenderFinalStatus finalStatus
- # This is used to give users more information about the name of the API call
- # that is incompatible with prerender and has caused the cancellation of the attempt
- optional string disallowedApiMethod
-
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
parameters
Roll protocol to r1202299 — 2023-09-28T04:26:18.000Z
@@ js_protocol.pdl:1014 @@ domain Runtime
# Unique script identifier.
type ScriptId extends string
- # Represents options for serialization. Overrides `generatePreview`, `returnByValue` and
- # `generateWebDriverValue`.
+ # Represents options for serialization. Overrides `generatePreview` and `returnByValue`.
type SerializationOptions extends object
properties
enum serialization
@@ -1027,8 +1026,7 @@ domain Runtime
# `returnByValue: true`. Overrides `returnByValue`.
json
# Only remote object id is put in the result. Same bahaviour as if no
- # `serializationOptions`, `generatePreview`, `returnByValue` nor `generateWebDriverValue`
- # are provided.
+ # `serializationOptions`, `generatePreview` nor `returnByValue` are provided.
idOnly
# Deep serialization depth. Default is full depth. Respected only in `deep` serialization mode.
@@ -1126,8 +1124,6 @@ domain Runtime
optional UnserializableValue unserializableValue
# String representation of the object.
optional string description
- # Deprecated. Use `deepSerializedValue` instead. WebDriver BiDi representation of the value.
- deprecated optional DeepSerializedValue webDriverValue
# Deep serialized value.
experimental optional DeepSerializedValue deepSerializedValue
# Unique object identifier (for non-primitive values).
@@ -1443,13 +1439,8 @@ domain Runtime
# boundaries).
# This is mutually exclusive with `executionContextId`.
experimental optional string uniqueContextId
- # Deprecated. Use `serializationOptions: {serialization:"deep"}` instead.
- # 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.
- deprecated optional boolean generateWebDriverValue
# Specifies the result serialization. If provided, overrides
- # `generatePreview`, `returnByValue` and `generateWebDriverValue`.
+ # `generatePreview` and `returnByValue`.
experimental optional SerializationOptions serializationOptions
returns
@@ -1537,14 +1528,8 @@ domain Runtime
# boundaries).
# This is mutually exclusive with `contextId`.
experimental optional string uniqueContextId
- # Deprecated. Use `serializationOptions: {serialization:"deep"}` instead.
- # 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.
- deprecated optional boolean generateWebDriverValue
# Specifies the result serialization. If provided, overrides
- # `generatePreview`, `returnByValue` and `generateWebDriverValue`.
+ # `generatePreview` and `returnByValue`.
experimental optional SerializationOptions serializationOptions
returns
# Evaluation result.
Roll protocol to r1200039 — 2023-09-22T04:26:23.000Z
@@ browser_protocol.pdl:874 @@ experimental domain Audits
# Contains additional info when the failure was due to a request.
optional FailedRequestInfo failedRequestInfo
+ type PropertyRuleIssueReason extends string
+ enum
+ InvalidSyntax
+ InvalidInitialValue
+ InvalidInherits
+ InvalidName
+
+ # This issue warns about errors in property rules that lead to property
+ # registrations being ignored.
+ type PropertyRuleIssueDetails extends object
+ properties
+ # Source code position of the property rule.
+ SourceCodeLocation sourceCodeLocation
+ # Reason why the property rule was discarded.
+ PropertyRuleIssueReason propertyRuleIssueReason
+ # The value of the property rule property that failed to parse
+ optional string propertyValue
+
# 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.
@@ -898,6 +916,7 @@ experimental domain Audits
BounceTrackingIssue
StylesheetLoadingIssue
FederatedAuthUserInfoRequestIssue
+ PropertyRuleIssue
# 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
@@ -921,6 +940,7 @@ experimental domain Audits
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
optional BounceTrackingIssueDetails bounceTrackingIssueDetails
optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
+ optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
@@ -9337,6 +9357,8 @@ experimental domain Storage
loaded
bid
win
+ additionalBid
+ additionalBidWin
# Ad advertising element inside an interest group.
type InterestGroupAd extends object
Roll protocol to r1199410 — 2023-09-21T04:26:11.000Z
@@ browser_protocol.pdl:11324 @@ experimental domain Preload
TriggerBackgrounded
MemoryLimitExceeded
DataSaverEnabled
- HasEffectiveUrl
+ TriggerUrlHasEffectiveUrl
ActivatedBeforeStarted
InactivePageRestriction
StartFailed
@@ -11359,6 +11359,9 @@ experimental domain Preload
MaxNumOfRunningEagerPrerendersExceeded
MaxNumOfRunningNonEagerPrerendersExceeded
MaxNumOfRunningEmbedderPrerendersExceeded
+ PrerenderingUrlHasEffectiveUrl
+ RedirectedPrerenderingUrlHasEffectiveUrl
+ ActivationUrlHasEffectiveUrl
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1198794 — 2023-09-20T04:26:33.000Z
@@ browser_protocol.pdl:5736 @@ domain Network
SameSiteNoneInsecure
# The cookie was not stored due to user preferences.
UserPreferences
+ # The cookie was blocked due to third-party cookie phaseout.
+ ThirdPartyPhaseout
# The cookie was blocked by third-party cookie blocking between sites in
# the same First-Party Set.
ThirdPartyBlockedInFirstPartySet
@@ -5781,6 +5783,8 @@ domain Network
# character if it appears in the middle of the cookie name, value, an
# attribute name, or an attribute value.
DisallowedCharacter
+ # Cookie contains no content or only whitespace.
+ NoCookieContent
# Types of reasons why a cookie may not be sent with a request.
experimental type CookieBlockedReason extends string
@@ -5807,6 +5811,8 @@ domain Network
SameSiteNoneInsecure
# The cookie was not sent due to user preferences.
UserPreferences
+ # The cookie was blocked due to third-party cookie phaseout.
+ ThirdPartyPhaseout
# The cookie was blocked by third-party cookie blocking between sites in
# the same First-Party Set.
ThirdPartyBlockedInFirstPartySet
Roll protocol to r1196408 — 2023-09-14T04:25:59.000Z
@@ browser_protocol.pdl:2095 @@ experimental domain CSS
string propertyName
string value
+ # Modifies the property rule property name.
+ command setPropertyRulePropertyName
+ parameters
+ StyleSheetId styleSheetId
+ SourceRange range
+ string propertyName
+ returns
+ # The resulting key text after modification.
+ Value propertyName
+
# Modifies the keyframe rule key text.
command setKeyframeKey
parameters
@@ -11296,7 +11306,6 @@ experimental domain Preload
NavigationBadHttpStatus
ClientCertRequested
NavigationRequestNetworkError
- MaxNumOfRunningPrerendersExceeded
CancelAllHostsForTesting
DidFailLoad
Stop
@@ -11341,6 +11350,9 @@ experimental domain Preload
ResourceLoadBlockedByClient
SpeculationRuleRemoved
ActivatedWithAuxiliaryBrowsingContexts
+ MaxNumOfRunningEagerPrerendersExceeded
+ MaxNumOfRunningNonEagerPrerendersExceeded
+ MaxNumOfRunningEmbedderPrerendersExceeded
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1195796 — 2023-09-13T04:26:23.000Z
@@ js_protocol.pdl:1066 @@ domain Runtime
arraybuffer
node
window
+ generator
optional any value
optional string objectId
# Set if value reference met more then once during serialization. In such
Roll protocol to r1195207 — 2023-09-12T04:25:54.000Z
@@ browser_protocol.pdl:1015 @@ experimental domain Autofill
# fields and values defining an address.
array of AddressField fields
- # Defines how an address can be displayed like in chrome://settings/addresses.
+ # Defines how an address can be displayed like in chrome://settings/addresses.
# Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
# The following address UI for instance:
# [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
@@ -1053,7 +1053,7 @@ experimental domain Autofill
parameters
# Information about the fields that were filled
array of FilledField filledFields
- # An UI representation of the address used to fill the form.
+ # An UI representation of the address used to fill the form.
# Consists of a 2D array where each child represents an address/profile line.
AddressUI addressUi
Roll protocol to r1193409 — 2023-09-07T04:26:24.000Z
@@ browser_protocol.pdl:11308 @@ experimental domain Preload
MixedContent
TriggerBackgrounded
MemoryLimitExceeded
- # Prerenders can be cancelled when Chrome uses excessive memory. This is
- # recorded when it fails to get the memory usage.
- FailToGetMemoryUsage
DataSaverEnabled
HasEffectiveUrl
ActivatedBeforeStarted
Roll protocol to r1191157 — 2023-09-01T04:26:11.000Z
@@ browser_protocol.pdl:9770 @@ experimental domain Storage
string key
UnsignedInt128AsBase16 value
+ experimental type AttributionReportingEventReportWindows extends object
+ properties
+ # duration in seconds
+ integer start
+ # duration in seconds
+ array of integer ends
+
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
# duration in seconds
optional integer expiry
+ # eventReportWindow and eventReportWindows are mutually exclusive
# duration in seconds
optional integer eventReportWindow
+ optional AttributionReportingEventReportWindows eventReportWindows
# duration in seconds
optional integer aggregatableReportWindow
AttributionReportingSourceType type
Roll protocol to r1188743 — 2023-08-27T04:25:42.000Z
@@ browser_protocol.pdl:7430 @@ domain Page
ch-ect
ch-prefers-color-scheme
ch-prefers-reduced-motion
+ ch-prefers-reduced-transparency
ch-rtt
ch-save-data
ch-ua
Roll protocol to r1188649 — 2023-08-26T04:25:29.000Z
@@ browser_protocol.pdl:1002 @@ experimental domain Autofill
properties
# address field name, for example GIVEN_NAME.
string name
- # address field name, for example Jon Doe.
+ # address field value, for example Jon Doe.
string value
+ # A list of address fields.
+ type AddressFields extends object
+ properties
+ array of AddressField fields
+
type Address extends object
properties
- # fields and values defining a test address.
+ # fields and values defining an address.
array of AddressField fields
+ # Defines how an address can be displayed like in chrome://settings/addresses.
+ # Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
+ # The following address UI for instance:
+ # [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
+ # should allow the receiver to render:
+ # Jon Doe
+ # Munich 81456
+ type AddressUI extends object
+ properties
+ # A two dimension array containing the repesentation of values from an address profile.
+ array of AddressFields addressFields
+
+ # Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
+ type FillingStrategy extends string
+ enum
+ autocompleteAttribute
+ autofillInferred
+
+ type FilledField extends object
+ properties
+ # The type of the field, e.g text, password etc.
+ string htmlType
+ # the html id
+ string id
+ # the html name
+ string name
+ # the field value
+ string value
+ # The actual field type, e.g FAMILY_NAME
+ string autofillType
+ # The filling strategy
+ FillingStrategy fillingStrategy
+
+ # Emitted when an address form is filled.
+ event addressFormFilled
+ parameters
+ # Information about the fields that were filled
+ array of FilledField filledFields
+ # An UI representation of the address used to fill the form.
+ # Consists of a 2D array where each child represents an address/profile line.
+ AddressUI addressUi
+
# Trigger autofill on a form identified by the fieldId.
# If the field and related form cannot be autofilled, returns an error.
command trigger
Roll protocol to r1188167 — 2023-08-25T04:26:40.000Z
@@ browser_protocol.pdl:1027 @@ experimental domain Autofill
parameters
array of Address addresses
+ # Disables autofill domain notifications.
+ command disable
+
+ # Enables autofill domain notifications.
+ command enable
# Defines events for background web platform features.
experimental domain BackgroundService
@@ -11439,6 +11444,12 @@ experimental domain FedCm
string dialogId
integer accountIndex
+ # Only valid if the dialog type is ConfirmIdpSignin. Acts as if the user had
+ # clicked the continue button.
+ command confirmIdpSignin
+ parameters
+ string dialogId
+
command dismissDialog
parameters
string dialogId
Roll protocol to r1182435 — 2023-08-11T04:25:48.000Z
@@ browser_protocol.pdl:1830 @@ experimental domain CSS
# List of keyframes.
array of CSSKeyframeRule keyframes
+ # Representation of a custom property registration through CSS.registerProperty
+ type CSSPropertyRegistration extends object
+ properties
+ string propertyName
+ optional Value initialValue
+ boolean inherits
+ string syntax
+
+
+ # CSS property at-rule representation.
+ type CSSPropertyRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated property name.
+ Value propertyName
+ # Associated style declaration.
+ CSSStyle style
+
# CSS keyframe rule representation.
type CSSKeyframeRule extends object
properties
@@ -1957,6 +1979,10 @@ experimental domain CSS
optional array of CSSKeyframesRule cssKeyframesRules
# A list of CSS position fallbacks matching this node.
optional array of CSSPositionFallbackRule cssPositionFallbackRules
+ # A list of CSS at-property rules matching this node.
+ optional array of CSSPropertyRule cssPropertyRules
+ # A list of CSS property registrations matching this node.
+ optional array of CSSPropertyRegistration cssPropertyRegistrations
# Id of the first parent element that does not have display: contents.
experimental optional DOM.NodeId parentLayoutNodeId
@@ -11372,6 +11398,7 @@ experimental domain FedCm
enum
AccountChooser
AutoReauthn
+ ConfirmIdpSignin
# Corresponds to IdentityRequestAccount
type Account extends object
Roll protocol to r1181874 — 2023-08-10T04:26:30.000Z
@@ browser_protocol.pdl:483 @@ experimental domain Audits
ExcludeSamePartyCrossPartyContext
ExcludeDomainNonASCII
ExcludeThirdPartyCookieBlockedInFirstPartySet
+ ExcludeThirdPartyPhaseout
type CookieWarningReason extends string
enum
Roll protocol to r1179426 — 2023-08-04T04:26:28.000Z
@@ browser_protocol.pdl:8070 @@ domain Page
experimental optional enum transferMode
ReturnAsBase64
ReturnAsStream
+ # Whether or not to generate tagged (accessible) PDF. Defaults to embedder choice.
+ experimental optional boolean generateTaggedPDF
returns
# Base64-encoded pdf data. Empty if |returnAsStream| is specified.
binary data
@@ -9720,6 +9722,7 @@ experimental domain Storage
destinationGlobalLimitReached
destinationBothLimitsReached
reportingOriginsPerSiteLimitReached
+ exceedsMaxChannelCapacity
# TODO(crbug.com/1458532): Add other Attribution Reporting events, e.g.
# trigger registration.
Roll protocol to r1177611 — 2023-08-01T04:26:34.000Z
@@ browser_protocol.pdl:5688 @@ domain Network
# The cookie's name/value pair size exceeded the size limit defined in
# RFC6265bis.
NameValuePairExceedsMaxSize
+ # The cookie contained a forbidden ASCII control character, or the tab
+ # character if it appears in the middle of the cookie name, value, an
+ # attribute name, or an attribute value.
+ DisallowedCharacter
# Types of reasons why a cookie may not be sent with a request.
experimental type CookieBlockedReason extends string
Roll protocol to r1173815 — 2023-07-22T04:25:56.000Z
@@ browser_protocol.pdl:496 @@ experimental domain Audits
WarnSameSiteLaxCrossDowngradeLax
WarnAttributeValueExceedsMaxSize
WarnDomainNonASCII
+ WarnThirdPartyPhaseout
type CookieOperation extends string
enum
Roll protocol to r1173320 — 2023-07-21T04:26:31.000Z
@@ browser_protocol.pdl:72 @@ experimental domain Accessibility
optional AXValue attributeValue
# Whether this source is superseded by a higher priority source.
optional boolean superseded
- # The native markup source for this value, e.g. a <label> element.
+ # The native markup source for this value, e.g. a `<label>` element.
optional AXValueNativeSourceType nativeSource
# The value, such as a node or node list, of the native source.
optional AXValue nativeSourceValue
@@ -1503,7 +1503,7 @@ experimental domain CSS
boolean isInline
# Whether this stylesheet is mutable. Inline stylesheets become mutable
# after they have been modified via CSSOM API.
- # <link> element's stylesheets become mutable only if DevTools modifies them.
+ # `<link>` element's stylesheets become mutable only if DevTools modifies them.
# Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
boolean isMutable
# True if this stylesheet is created through new CSSStyleSheet() or imported as a
@@ -2326,8 +2326,8 @@ experimental domain Cast
# 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.<p>Note that `iframe` owner elements will return
-# corresponding document elements as their child nodes.</p>
+# the nodes that were sent to the client. Note that `iframe` owner elements will return
+# corresponding document elements as their child nodes.
domain DOM
depends on Runtime
@@ -4107,8 +4107,8 @@ experimental domain HeadlessExperimental
# Input/Output operations for streams produced by DevTools.
domain IO
- # This is either obtained from another method or specified as `blob:<uuid>` where
- # `<uuid>` is an UUID of a Blob.
+ # This is either obtained from another method or specified as `blob:<uuid>` where
+ # `<uuid>` is an UUID of a Blob.
type StreamHandle extends string
# Close the stream, discard any temporary backing storage.
@@ -5880,7 +5880,7 @@ domain Network
Headers responseHeaders
# Signed exchange response signature.
array of SignedExchangeSignature signatures
- # Signed exchange header integrity hash in the form of "sha256-<base64-hash-value>".
+ # Signed exchange header integrity hash in the form of `sha256-<base64-hash-value>`.
string headerIntegrity
# Field type for a signed exchange related error.
@@ -8359,7 +8359,7 @@ domain Page
enum mode
selectSingle
selectMultiple
- # Input node id. Only present for file choosers opened via an <input type="file"> element.
+ # Input node id. Only present for file choosers opened via an `<input type="file">` element.
experimental optional DOM.BackendNodeId backendNodeId
# Fired when frame has been attached to its parent.
@@ -11096,7 +11096,7 @@ experimental domain Preload
# Identifies a document which the rule set is associated with.
Network.LoaderId loaderId
# Source text of JSON representing the rule set. If it comes from
- # <script> tag, it is the textContent of the node. Note that it is
+ # `<script>` tag, it is the textContent of the node. Note that it is
# a JSON for valid case.
#
# See also:
@@ -11104,9 +11104,9 @@ experimental domain Preload
# - https://github.com/WICG/nav-speculation/blob/main/triggers.md
string sourceText
# A speculation rule set is either added through an inline
- # <script> tag or through an external resource via the
+ # `<script>` tag or through an external resource via the
# 'Speculation-Rules' HTTP header. For the first case, we include
- # the BackendNodeId of the relevant <script> tag. For the second
+ # the BackendNodeId of the relevant `<script>` tag. For the second
# case, we include the external URL where the rule set was loaded
# from, and also RequestId if Network domain is enabled.
#
@@ -11210,7 +11210,6 @@ experimental domain Preload
AudioOutputDeviceRequested
MixedContent
TriggerBackgrounded
- EmbedderTriggeredAndCrossOriginRedirected
MemoryLimitExceeded
# Prerenders can be cancelled when Chrome uses excessive memory. This is
# recorded when it fails to get the memory usage.
Roll protocol to r1172767 — 2023-07-20T04:26:30.000Z
@@ browser_protocol.pdl:11247 @@ experimental domain Preload
PrerenderingDisabledByDevTools
ResourceLoadBlockedByClient
SpeculationRuleRemoved
+ ActivatedWithAuxiliaryBrowsingContexts
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1170846 — 2023-07-15T04:27:50.000Z
@@ browser_protocol.pdl:10485 @@ domain Fetch
# takeResponseBodyForInterceptionAsStream. Calling other methods that
# affect the request or disabling fetch domain before body is received
# results in an undefined behavior.
+ # Note that the response body is not available for redirects. Requests
+ # paused in the _redirect received_ state may be differentiated by
+ # `responseCode` and presence of `location` response header, see
+ # comments to `requestPaused` for details.
command getResponseBody
parameters
# Identifier for the intercepted request to get body for.
@@ -10517,6 +10521,11 @@ domain Fetch
# 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.
+ # Redirect responses and subsequent requests are reported similarly to regular
+ # responses and requests. Redirect responses may be distinguished by the value
+ # of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
+ # presence of the `location` header. Requests resulting from a redirect will
+ # have `redirectedRequestId` field set.
event requestPaused
parameters
# Each request the page makes will have a unique id.
Roll protocol to r1170333 — 2023-07-14T04:28:05.000Z
@@ browser_protocol.pdl:6268 @@ domain Network
MonotonicTime timestamp
# Total number of bytes received for this request.
number encodedDataLength
- # Set when 1) response was blocked by Cross-Origin Read Blocking and also
- # 2) this needs to be reported to the DevTools console.
- optional boolean shouldReportCorbBlocking
# Details of an intercepted HTTP request, which must be either allowed, blocked, modified or
# mocked.
Roll protocol to r1169739 — 2023-07-13T04:27:48.000Z
@@ browser_protocol.pdl:8581 @@ domain Page
FencedFramesEmbedder
CookieDisabled
HTTPAuthRequired
+ CookieFlushed
#Blocklisted features
WebSocket
WebTransport
@@ -11239,6 +11240,7 @@ experimental domain Preload
MemoryPressureAfterTriggered
PrerenderingDisabledByDevTools
ResourceLoadBlockedByClient
+ SpeculationRuleRemoved
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1169132 — 2023-07-12T04:28:03.000Z
@@ browser_protocol.pdl:5921 @@ domain Network
deflate
gzip
br
+ zstd
# Sets a list of content encodings that will be accepted. Empty list means no encoding is accepted.
experimental command setAcceptedEncodings
Roll protocol to r1168520 — 2023-07-11T04:28:09.000Z
@@ browser_protocol.pdl:697 @@ experimental domain Audits
InvalidRegisterOsTriggerHeader
WebAndOsHeaders
NoWebOrOsSupport
+ NavigationRegistrationWithoutTransientUserActivation
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
@@ -4586,6 +4587,9 @@ domain Input
# Time at which the event occurred.
optional TimeSinceEpoch timestamp
+ # Cancels any active dragging in the page.
+ command cancelDragging
+
# Emulates touch event from the mouse event parameters.
experimental command emulateTouchFromMouseEvent
parameters
Roll protocol to r1167732 — 2023-07-08T04:27:37.000Z
@@ browser_protocol.pdl:9711 @@ experimental domain Storage
destinationReportingLimitReached
destinationGlobalLimitReached
destinationBothLimitsReached
+ reportingOriginsPerSiteLimitReached
# TODO(crbug.com/1458532): Add other Attribution Reporting events, e.g.
# trigger registration.
Roll protocol to r1166296 — 2023-07-06T04:28:50.000Z
@@ browser_protocol.pdl:1562 @@ experimental domain CSS
ContainerRule
LayerRule
ScopeRule
+ StyleRule
# CSS coverage information.
type RuleUsage extends object
@@ -9655,6 +9656,69 @@ experimental domain Storage
# If enabled, noise is suppressed and reports are sent immediately.
boolean enabled
+ # Enables/disables issuing of Attribution Reporting events.
+ experimental command setAttributionReportingTracking
+ parameters
+ boolean enable
+
+ experimental type AttributionReportingSourceType extends string
+ enum
+ navigation
+ event
+
+ experimental type UnsignedInt64AsBase10 extends string
+ experimental type UnsignedInt128AsBase16 extends string
+ experimental type SignedInt64AsBase10 extends string
+
+ experimental type AttributionReportingFilterDataEntry extends object
+ properties
+ string key
+ array of string values
+
+ experimental type AttributionReportingAggregationKeysEntry extends object
+ properties
+ string key
+ UnsignedInt128AsBase16 value
+
+ experimental type AttributionReportingSourceRegistration extends object
+ properties
+ Network.TimeSinceEpoch time
+ # duration in seconds
+ optional integer expiry
+ # duration in seconds
+ optional integer eventReportWindow
+ # duration in seconds
+ optional integer aggregatableReportWindow
+ AttributionReportingSourceType type
+ string sourceOrigin
+ string reportingOrigin
+ array of string destinationSites
+ UnsignedInt64AsBase10 eventId
+ SignedInt64AsBase10 priority
+ array of AttributionReportingFilterDataEntry filterData
+ array of AttributionReportingAggregationKeysEntry aggregationKeys
+ optional UnsignedInt64AsBase10 debugKey
+
+ experimental type AttributionReportingSourceRegistrationResult extends string
+ enum
+ success
+ internalError
+ insufficientSourceCapacity
+ insufficientUniqueDestinationCapacity
+ excessiveReportingOrigins
+ prohibitedByBrowserPolicy
+ successNoised
+ destinationReportingLimitReached
+ destinationGlobalLimitReached
+ destinationBothLimitsReached
+
+ # TODO(crbug.com/1458532): Add other Attribution Reporting events, e.g.
+ # trigger registration.
+ experimental event attributionReportingSourceRegistered
+ parameters
+ AttributionReportingSourceRegistration registration
+ AttributionReportingSourceRegistrationResult result
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1165779 — 2023-07-05T04:28:56.000Z
@@ browser_protocol.pdl:1550 @@ experimental domain CSS
# @scope CSS at-rule array.
# The array enumerates @scope at-rules starting with the innermost one, going outwards.
experimental optional array of CSSScope scopes
+ # The array keeps the types of ancestor CSSRules from the innermost going outwards.
+ experimental optional array of CSSRuleType ruleTypes
+
+ # Enum indicating the type of a CSS rule, used to represent the order of a style rule's ancestors.
+ # This list only contains rule types that are collected during the ancestor rule collection.
+ experimental type CSSRuleType extends string
+ enum
+ MediaRule
+ SupportsRule
+ ContainerRule
+ LayerRule
+ ScopeRule
# CSS coverage information.
type RuleUsage extends object
Roll protocol to r1165014 — 2023-07-01T04:27:51.000Z
@@ browser_protocol.pdl:719 @@ experimental domain Audits
Page.FrameId frameId
Network.LoaderId loaderId
- type NavigatorUserAgentIssueDetails extends object
+ deprecated type NavigatorUserAgentIssueDetails extends object
properties
string url
optional SourceCodeLocation location
@@ -737,6 +737,7 @@ experimental domain Audits
FormLabelHasNeitherForNorNestedInput
FormLabelForMatchesNonExistingIdError
FormInputHasWrongButWellIntendedAutocompleteValueError
+ ResponseWasBlockedByORB
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
@@ -746,6 +747,7 @@ experimental domain Audits
optional Page.FrameId frameId
optional DOM.BackendNodeId violatingNodeId
optional string violatingNodeAttribute
+ optional AffectedRequest request
# This issue tracks information needed to print a deprecation message.
# https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
@@ -884,6 +886,7 @@ experimental domain Audits
CorsIssue
AttributionReportingIssue
QuirksModeIssue
+ # Deprecated
NavigatorUserAgentIssue
GenericIssue
DeprecationIssue
@@ -908,7 +911,7 @@ experimental domain Audits
optional CorsIssueDetails corsIssueDetails
optional AttributionReportingIssueDetails attributionReportingIssueDetails
optional QuirksModeIssueDetails quirksModeIssueDetails
- optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
+ deprecated optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
optional GenericIssueDetails genericIssueDetails
optional DeprecationIssueDetails deprecationIssueDetails
optional ClientHintIssueDetails clientHintIssueDetails
Roll protocol to r1163380 — 2023-06-28T04:28:21.000Z
@@ browser_protocol.pdl:9634 @@ experimental domain Storage
parameters
string bucketId
+ # https://wicg.github.io/attribution-reporting-api/
+ experimental command setAttributionReportingLocalTestingMode
+ parameters
+ # If enabled, noise is suppressed and reports are sent immediately.
+ boolean enabled
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1162774 — 2023-06-27T04:28:23.000Z
@@ browser_protocol.pdl:7773 @@ domain Page
# Specifies whether command line API should be available to the script, defaults
# to false.
experimental optional boolean includeCommandLineAPI
+ # If true, runs the script immediately on existing execution contexts or worlds.
+ # Default: false.
+ experimental optional boolean runImmediately
returns
# Identifier of the added script.
ScriptIdentifier identifier
@@ -11164,6 +11167,8 @@ experimental domain Preload
boolean disabledByPreference
boolean disabledByDataSaver
boolean disabledByBatterySaver
+ boolean disabledByHoldbackPrefetchSpeculationRules
+ boolean disabledByHoldbackPrerenderSpeculationRules
# Preloading status values, see also PreloadingTriggeringOutcome. This
# status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
@@ -11227,6 +11232,7 @@ experimental domain Preload
string prefetchUrl
PreloadingStatus status
PrefetchStatus prefetchStatus
+ Network.RequestId requestId
# Fired when a prerender attempt is updated.
event prerenderStatusUpdated
@@ -11234,6 +11240,9 @@ experimental domain Preload
PreloadingAttemptKey key
PreloadingStatus status
optional PrerenderFinalStatus prerenderStatus
+ # This is used to give users more information about the name of Mojo interface
+ # that is incompatible with prerender and has caused the cancellation of the attempt.
+ optional string disallowedMojoInterface
# Send a list of sources for all preloading attempts in a document.
event preloadingAttemptSourcesUpdated
Roll protocol to r1161598 — 2023-06-23T04:28:28.000Z
@@ browser_protocol.pdl:7336 @@ domain Page
ch-ua-platform
ch-ua-model
ch-ua-mobile
+ ch-ua-form-factor
ch-ua-full-version
ch-ua-full-version-list
ch-ua-platform-version
@@ -8568,14 +8569,12 @@ domain Page
DocumentLoaded
DedicatedWorkerOrWorklet
OutstandingNetworkRequestOthers
- OutstandingIndexedDBTransaction
RequestedMIDIPermission
RequestedAudioCapturePermission
RequestedVideoCapturePermission
RequestedBackForwardCacheBlockedSensors
RequestedBackgroundWorkPermission
BroadcastChannel
- IndexedDBConnection
WebXR
SharedWorker
WebLocks
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index 7a3c772c..ed622630 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -1034,6 +1034,11 @@ domain Runtime
# Deep serialization depth. Default is full depth. Respected only in `deep` serialization mode.
optional integer maxDepth
+ # Embedder-specific parameters. For example if connected to V8 in Chrome these control DOM
+ # serialization via `maxNodeDepth: integer` and `includeShadowTree: "none" | "open" | "all"`.
+ # Values can be only of type string or integer.
+ optional object additionalParameters
+
# Represents deep serialized value.
type DeepSerializedValue extends object
properties
Roll protocol to r1161029 — 2023-06-22T04:26:26.000Z
@@ browser_protocol.pdl:5368 @@ domain Network
# address space.
UnexpectedPrivateNetworkAccess
NoCorsRedirectModeNotFollow
+ # Request was a private network request and needed user permission yet did
+ # not carry `Private-Network-Access-Id` in the preflight response.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PreflightMissingPrivateNetworkAccessId
+ # Request was a private network request and needed user permission yet did
+ # not carry `Private-Network-Access-Name` in the preflight response.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PreflightMissingPrivateNetworkAccessName
+ # Request was a private network request and needed user permission yet not
+ # able to request for permission.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PrivateNetworkAccessPermissionUnavailable
+ # Request was a private network request and is denied by user permission.
+ # https://github.com/WICG/private-network-access/blob/main/permission_prompt/explainer.md
+ PrivateNetworkAccessPermissionDenied
type CorsErrorStatus extends object
properties
@@ -8540,6 +8555,7 @@ domain Page
ErrorDocument
FencedFramesEmbedder
CookieDisabled
+ HTTPAuthRequired
#Blocklisted features
WebSocket
WebTransport
Roll protocol to r1159816 — 2023-06-20T04:26:35.000Z
@@ browser_protocol.pdl:8587 @@ domain Page
IndexedDBEvent
Dummy
JsNetworkRequestReceivedCacheControlNoStoreResource
+ WebRTCSticky
+ WebTransportSticky
+ WebSocketSticky
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1158625 — 2023-06-16T04:26:28.000Z
@@ browser_protocol.pdl:992 @@ experimental domain Autofill
# 3-digit card verification code.
string cvc
+ type AddressField extends object
+ properties
+ # address field name, for example GIVEN_NAME.
+ string name
+ # address field name, for example Jon Doe.
+ string value
+
+ type Address extends object
+ properties
+ # fields and values defining a test address.
+ array of AddressField fields
+
# Trigger autofill on a form identified by the fieldId.
# If the field and related form cannot be autofilled, returns an error.
command trigger
@@ -1003,6 +1015,13 @@ experimental domain Autofill
# Credit card information to fill out the form. Credit card data is not saved.
CreditCard card
+ # Set addresses so that developers can verify their forms implementation.
+ command setAddresses
+ # Test addresses for the available countries.
+ parameters
+ array of Address addresses
+
+
# Defines events for background web platform features.
experimental domain BackgroundService
# The Background Service that will be associated with the commands/events.
Roll protocol to r1157354 — 2023-06-14T04:26:43.000Z
@@ browser_protocol.pdl:8568 @@ domain Page
IndexedDBEvent
Dummy
JsNetworkRequestReceivedCacheControlNoStoreResource
- WebSerial
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1156692 — 2023-06-13T04:26:37.000Z
@@ browser_protocol.pdl:852 @@ experimental domain Audits
string url
# The failure message for the failed request.
string failureMessage
+ optional Network.RequestId requestId
type StyleSheetLoadingIssueReason extends string
enum
@@ -8566,7 +8567,8 @@ domain Page
KeepaliveRequest
IndexedDBEvent
Dummy
- AuthorizationHeader
+ JsNetworkRequestReceivedCacheControlNoStoreResource
+ WebSerial
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1155872 — 2023-06-10T04:26:19.000Z
@@ browser_protocol.pdl:8567 @@ domain Page
IndexedDBEvent
Dummy
AuthorizationHeader
- WebSerial
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1155343 — 2023-06-09T04:26:30.000Z
@@ browser_protocol.pdl:820 @@ experimental domain Audits
SilentMediationFailure
ThirdPartyCookiesBlocked
+ type FederatedAuthUserInfoRequestIssueDetails extends object
+ properties
+ FederatedAuthUserInfoRequestIssueReason federatedAuthUserInfoRequestIssueReason
+
+ # Represents the failure reason when a getUserInfo() call fails.
+ # Should be updated alongside FederatedAuthUserInfoRequestResult in
+ # third_party/blink/public/mojom/devtools/inspector_issue.mojom.
+ type FederatedAuthUserInfoRequestIssueReason extends string
+ enum
+ NotSameOrigin
+ NotIframe
+ NotPotentiallyTrustworthy
+ NoApiPermission
+ NotSignedInWithIdp
+ NoAccountSharingPermission
+ InvalidConfigOrWellKnown
+ InvalidAccountsResponse
+ NoReturningUserFromFetchedAccounts
+
# This issue tracks client hints related issues. It's used to deprecate old
# features, encourage the use of new ones, and provide general guidance.
type ClientHintIssueDetails extends object
@@ -871,6 +890,7 @@ experimental domain Audits
FederatedAuthRequestIssue
BounceTrackingIssue
StylesheetLoadingIssue
+ FederatedAuthUserInfoRequestIssue
# 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
@@ -894,6 +914,7 @@ experimental domain Audits
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
optional BounceTrackingIssueDetails bounceTrackingIssueDetails
optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
+ optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
@@ -6493,6 +6514,7 @@ domain Network
enum status
Ok
InvalidArgument
+ MissingIssuerKeys
FailedPrecondition
ResourceExhausted
AlreadyExists
@@ -7279,11 +7301,9 @@ domain Page
ch-ua-platform
ch-ua-model
ch-ua-mobile
- ch-ua-full
ch-ua-full-version
ch-ua-full-version-list
ch-ua-platform-version
- ch-ua-reduced
ch-ua-wow64
ch-viewport-height
ch-viewport-width
@@ -11087,6 +11107,7 @@ experimental domain Preload
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
PrerenderingDisabledByDevTools
+ ResourceLoadBlockedByClient
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1154250 — 2023-06-07T04:26:56.000Z
@@ browser_protocol.pdl:827 @@ experimental domain Audits
SourceCodeLocation sourceCodeLocation
ClientHintIssueReason clientHintIssueReason
+ type FailedRequestInfo extends object
+ properties
+ # The URL that failed to load.
+ string url
+ # The failure message for the failed request.
+ string failureMessage
+
+ type StyleSheetLoadingIssueReason extends string
+ enum
+ LateImportRule
+ RequestFailed
+
+ # This issue warns when a referenced stylesheet couldn't be loaded.
+ type StylesheetLoadingIssueDetails extends object
+ properties
+ # Source code position that referenced the failing stylesheet.
+ SourceCodeLocation sourceCodeLocation
+ # Reason why the stylesheet couldn't be loaded.
+ StyleSheetLoadingIssueReason styleSheetLoadingIssueReason
+ # Contains additional info when the failure was due to a request.
+ optional FailedRequestInfo failedRequestInfo
+
# 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.
@@ -848,6 +870,7 @@ experimental domain Audits
ClientHintIssue
FederatedAuthRequestIssue
BounceTrackingIssue
+ StylesheetLoadingIssue
# 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
@@ -870,6 +893,7 @@ experimental domain Audits
optional ClientHintIssueDetails clientHintIssueDetails
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
optional BounceTrackingIssueDetails bounceTrackingIssueDetails
+ optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
Roll protocol to r1152884 — 2023-06-03T04:26:19.000Z
@@ browser_protocol.pdl:6560 @@ domain Network
optional string reportingEndpoint
optional string reportOnlyReportingEndpoint
+ experimental type ContentSecurityPolicySource extends string
+ enum
+ HTTP
+ Meta
+
+ experimental type ContentSecurityPolicyStatus extends object
+ properties
+ string effectiveDirectives
+ boolean isEnforced
+ ContentSecurityPolicySource source
+
experimental type SecurityIsolationStatus extends object
properties
optional CrossOriginOpenerPolicyStatus coop
optional CrossOriginEmbedderPolicyStatus coep
+ optional array of ContentSecurityPolicyStatus csp
# Returns information about the COEP/COOP isolation status.
experimental command getSecurityIsolationStatus
@@ -8511,6 +8523,7 @@ domain Page
IndexedDBEvent
Dummy
AuthorizationHeader
+ WebSerial
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
Roll protocol to r1152352 — 2023-06-02T04:26:31.000Z
@@ browser_protocol.pdl:3984 @@ experimental domain HeadlessExperimental
jpeg
png
webp
- # Compression quality from range [0..100] (jpeg only).
+ # Compression quality from range [0..100] (jpeg and webp only).
optional integer quality
# Optimize image encoding for speed, not for resulting size (defaults to false)
optional boolean optimizeForSpeed
Roll protocol to r1151065 — 2023-05-31T04:26:30.000Z
@@ browser_protocol.pdl:818 @@ experimental domain Audits
Canceled
RpPageNotVisible
SilentMediationFailure
+ ThirdPartyCookiesBlocked
# This issue tracks client hints related issues. It's used to deprecate old
# features, encourage the use of new ones, and provide general guidance.
@@ -8462,6 +8463,7 @@ domain Page
ActivationNavigationsDisallowedForBug1234857
ErrorDocument
FencedFramesEmbedder
+ CookieDisabled
#Blocklisted features
WebSocket
WebTransport
Roll protocol to r1149535 — 2023-05-26T04:26:25.000Z
@@ browser_protocol.pdl:8631 @@ domain Page
# Base64-encoded data
binary data
+ # Enable/disable prerendering manually.
+ #
+ # This command is a short-term solution for https://crbug.com/1440085.
+ # See https://docs.google.com/document/d/12HVmFxYj5Jc-eJr5OmWsa2bqTJsbgGLKI6ZIyx0_wpA
+ # for more details.
+ #
+ # TODO(https://crbug.com/1440085): Remove this once Puppeteer supports tab targets.
+ experimental command setPrerenderingAllowed
+ parameters
+ boolean isAllowed
+
domain Performance
# Run-time execution metric.
@@ -11036,6 +11047,7 @@ experimental domain Preload
SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
+ PrerenderingDisabledByDevTools
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index 0dbdc01d..7a3c772c 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -1443,7 +1443,7 @@ domain Runtime
# resulting `objectId` is still provided.
deprecated optional boolean generateWebDriverValue
# Specifies the result serialization. If provided, overrides
- # `returnByValue` and `generateWebDriverValue`.
+ # `generatePreview`, `returnByValue` and `generateWebDriverValue`.
experimental optional SerializationOptions serializationOptions
returns
@@ -1538,7 +1538,7 @@ domain Runtime
# resulting `objectId` is still provided.
deprecated optional boolean generateWebDriverValue
# Specifies the result serialization. If provided, overrides
- # `returnByValue` and `generateWebDriverValue`.
+ # `generatePreview`, `returnByValue` and `generateWebDriverValue`.
experimental optional SerializationOptions serializationOptions
returns
# Evaluation result.
Roll protocol to r1148337 — 2023-05-24T04:27:07.000Z
@@ browser_protocol.pdl:5121 @@ domain Network
experimental number pushStart
# Time the server finished pushing request.
experimental number pushEnd
+ # Started receiving response headers.
+ experimental number receiveHeadersStart
# Finished receiving response headers.
number receiveHeadersEnd
Roll protocol to r1147663 — 2023-05-23T04:26:36.000Z
@@ browser_protocol.pdl:1382 @@ experimental domain CSS
string text
# Value range in the underlying resource (if available).
optional SourceRange range
+ # Specificity of the selector.
+ experimental optional Specificity specificity
+
+ # Specificity:
+ # https://drafts.csswg.org/selectors/#specificity-rules
+ experimental type Specificity extends object
+ properties
+ # The a component, which represents the number of ID selectors.
+ integer a
+ # The b component, which represents the number of class selectors, attributes selectors, and
+ # pseudo-classes.
+ integer b
+ # The c component, which represents the number of type selectors and pseudo-elements.
+ integer c
# Selector list data.
type SelectorList extends object
Roll protocol to r1146845 — 2023-05-20T04:26:10.000Z
@@ browser_protocol.pdl:2047 @@ experimental domain CSS
StyleSheetId styleSheetId
experimental domain CacheStorage
+ depends on Storage
# Unique identifier of the Cache object.
type CacheId extends string
@@ -2090,6 +2091,8 @@ experimental domain CacheStorage
string securityOrigin
# Storage key of the cache.
string storageKey
+ # Storage bucket of the cache.
+ optional Storage.StorageBucket storageBucket
# The name of the cache.
string cacheName
@@ -2121,11 +2124,13 @@ experimental domain CacheStorage
# Requests cache names.
command requestCacheNames
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
returns
# Caches for the security origin.
array of Cache caches
@@ -9432,6 +9437,8 @@ experimental domain Storage
string origin
# Storage key to update.
string storageKey
+ # Storage bucket to update.
+ string bucketId
# Name of cache in origin.
string cacheName
@@ -9442,6 +9449,8 @@ experimental domain Storage
string origin
# Storage key to update.
string storageKey
+ # Storage bucket to update.
+ string bucketId
# The origin's IndexedDB object store has been modified.
event indexedDBContentUpdated
@@ -11024,19 +11033,12 @@ experimental domain Preload
# that is incompatible with prerender and has caused the cancellation of the attempt
optional string disallowedApiMethod
- type PreloadEnabledState extends string
- enum
- Enabled
- DisabledByDataSaver
- DisabledByBatterySaver
- DisabledByPreference
- # Service not available.
- NotSupported
-
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
parameters
- PreloadEnabledState state
+ boolean disabledByPreference
+ boolean disabledByDataSaver
+ boolean disabledByBatterySaver
# Preloading status values, see also PreloadingTriggeringOutcome. This
# status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
Roll protocol to r1146363 — 2023-05-19T04:26:26.000Z
@@ browser_protocol.pdl:817 @@ experimental domain Audits
ErrorIdToken
Canceled
RpPageNotVisible
+ SilentMediationFailure
# This issue tracks client hints related issues. It's used to deprecate old
# features, encourage the use of new ones, and provide general guidance.
@@ -1314,6 +1315,12 @@ domain Browser
parameters
BrowserCommandId commandId
+ # Allows a site to use privacy sandbox features that require enrollment
+ # without the site actually being enrolled. Only supported on page targets.
+ command addPrivacySandboxEnrollmentOverride
+ parameters
+ string url
+
# 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.
@@ -11055,6 +11062,7 @@ experimental domain Preload
PrefetchFailedNetError
PrefetchFailedNon2XX
PrefetchFailedPerPageLimitExceeded
+ PrefetchEvicted
PrefetchHeldback
# A previous prefetch to the origin got a HTTP 503 response with an
# Retry-After header that has no elapsed yet.
Roll protocol to r1145810 — 2023-05-18T04:26:32.000Z
@@ browser_protocol.pdl:11070 @@ experimental domain Preload
PrefetchNotEligibleSchemeIsNotHttps
PrefetchNotEligibleUserHasCookies
PrefetchNotEligibleUserHasServiceWorker
+ PrefetchNotEligibleBatterySaverEnabled
+ PrefetchNotEligiblePreloadingDisabled
PrefetchNotFinishedInTime
PrefetchNotStarted
PrefetchNotUsedCookiesChanged
@@ -11095,9 +11097,6 @@ experimental domain Preload
event prerenderStatusUpdated
parameters
PreloadingAttemptKey key
- # The frame id of the frame initiating prerender.
- Page.FrameId initiatingFrameId
- string prerenderingUrl
PreloadingStatus status
optional PrerenderFinalStatus prerenderStatus
@@ -11169,4 +11168,3 @@ experimental domain FedCm
# Resets the cooldown time, if any, to allow the next FedCM call to show
# a dialog even if one was recently dismissed by the user.
command resetCooldown
-
Roll protocol to r1145140 — 2023-05-17T04:26:30.000Z
@@ browser_protocol.pdl:11004 @@ experimental domain Preload
SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
- SpeculationRuleRemoved
- TriggerPageNavigated
- OtherPrerenderedPageActivated
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
@@ -11102,6 +11099,7 @@ experimental domain Preload
Page.FrameId initiatingFrameId
string prerenderingUrl
PreloadingStatus status
+ optional PrerenderFinalStatus prerenderStatus
# Send a list of sources for all preloading attempts in a document.
event preloadingAttemptSourcesUpdated
Roll protocol to r1144541 — 2023-05-16T04:27:03.000Z
@@ browser_protocol.pdl:919 @@ experimental domain Audits
# Whether to report WCAG AAA level issues. Default is false.
optional boolean reportAAA
+ # Runs the form issues check for the target page. Found issues are reported
+ # using Audits.issueAdded event.
+ command checkFormsIssues
+ returns
+ array of GenericIssueDetails formIssues
+
event issueAdded
parameters
InspectorIssue issue
@@ -944,6 +950,8 @@ experimental domain Autofill
parameters
# Identifies a field that serves as an anchor for autofill.
DOM.BackendNodeId fieldId
+ # Identifies the frame that field belongs to.
+ optional Page.FrameId frameId
# Credit card information to fill out the form. Credit card data is not saved.
CreditCard card
Roll protocol to r1143632 — 2023-05-13T04:26:23.000Z
@@ browser_protocol.pdl:10996 @@ experimental domain Preload
SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
+ SpeculationRuleRemoved
+ TriggerPageNavigated
+ OtherPrerenderedPageActivated
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
@@ -11035,6 +11038,44 @@ experimental domain Preload
# PreloadingTriggeringOutcome which not used by prefetch nor prerender.
NotSupported
+ # TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
+ # filter out the ones that aren't necessary to the developers.
+ type PrefetchStatus extends string
+ enum
+ # Prefetch is not disabled by PrefetchHeldback.
+ PrefetchAllowed
+ PrefetchFailedIneligibleRedirect
+ PrefetchFailedInvalidRedirect
+ PrefetchFailedMIMENotSupported
+ PrefetchFailedNetError
+ PrefetchFailedNon2XX
+ PrefetchFailedPerPageLimitExceeded
+ PrefetchHeldback
+ # A previous prefetch to the origin got a HTTP 503 response with an
+ # Retry-After header that has no elapsed yet.
+ PrefetchIneligibleRetryAfter
+ PrefetchIsPrivacyDecoy
+ PrefetchIsStale
+ PrefetchNotEligibleBrowserContextOffTheRecord
+ PrefetchNotEligibleDataSaverEnabled
+ PrefetchNotEligibleExistingProxy
+ PrefetchNotEligibleHostIsNonUnique
+ PrefetchNotEligibleNonDefaultStoragePartition
+ PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy
+ PrefetchNotEligibleSchemeIsNotHttps
+ PrefetchNotEligibleUserHasCookies
+ PrefetchNotEligibleUserHasServiceWorker
+ PrefetchNotFinishedInTime
+ PrefetchNotStarted
+ PrefetchNotUsedCookiesChanged
+ PrefetchProxyNotAvailable
+ # The response of the prefetch is used for the next navigation. This is
+ # the final successful state.
+ PrefetchResponseUsed
+ # The prefetch finished successfully but was never used.
+ PrefetchSuccessfulButNotUsed
+ PrefetchNotUsedProbeFailed
+
# Fired when a prefetch attempt is updated.
event prefetchStatusUpdated
parameters
@@ -11043,6 +11084,7 @@ experimental domain Preload
Page.FrameId initiatingFrameId
string prefetchUrl
PreloadingStatus status
+ PrefetchStatus prefetchStatus
# Fired when a prerender attempt is updated.
event prerenderStatusUpdated
Roll protocol to r1141857 — 2023-05-10T04:26:34.000Z
@@ browser_protocol.pdl:11068 @@ experimental domain FedCm
SignIn
SignUp
+ # Whether the dialog shown is an account chooser or an auto re-authentication dialog.
+ type DialogType extends string
+ enum
+ AccountChooser
+ AutoReauthn
+
# Corresponds to IdentityRequestAccount
type Account extends object
properties
@@ -11086,6 +11092,7 @@ experimental domain FedCm
event dialogShown
parameters
string dialogId
+ DialogType dialogType
array of Account accounts
# These exist primarily so that the caller can verify the
# RP context was used appropriately.
Roll protocol to r1140464 — 2023-05-06T04:26:18.000Z
@@ js_protocol.pdl:1014 @@ domain Runtime
# Unique script identifier.
type ScriptId extends string
- # Represents the value serialiazed by the WebDriver BiDi specification
- # https://goo.gle/browser-automation-deepserialization.
+ # Represents options for serialization. Overrides `generatePreview`, `returnByValue` and
+ # `generateWebDriverValue`.
+ type SerializationOptions extends object
+ properties
+ enum serialization
+ # Whether the result should be deep-serialized. The result is put into
+ # `deepSerializedValue` and `ObjectId` is provided.
+ deep
+ # Whether the result is expected to be a JSON object which should be sent by value.
+ # The result is put either into `value` or into `unserializableValue`. Synonym of
+ # `returnByValue: true`. Overrides `returnByValue`.
+ json
+ # Only remote object id is put in the result. Same bahaviour as if no
+ # `serializationOptions`, `generatePreview`, `returnByValue` nor `generateWebDriverValue`
+ # are provided.
+ idOnly
+
+ # Deep serialization depth. Default is full depth. Respected only in `deep` serialization mode.
+ optional integer maxDepth
+
+ # Represents deep serialized value.
type DeepSerializedValue extends object
properties
enum type
@@ -1101,8 +1120,10 @@ domain Runtime
optional UnserializableValue unserializableValue
# String representation of the object.
optional string description
- # WebDriver BiDi representation of the value.
- experimental optional DeepSerializedValue webDriverValue
+ # Deprecated. Use `deepSerializedValue` instead. WebDriver BiDi representation of the value.
+ deprecated optional DeepSerializedValue webDriverValue
+ # Deep serialized value.
+ experimental optional DeepSerializedValue deepSerializedValue
# Unique object identifier (for non-primitive values).
optional RemoteObjectId objectId
# Preview containing abbreviated property values. Specified for `object` type values only.
@@ -1392,6 +1413,7 @@ domain Runtime
# execution. Overrides `setPauseOnException` state.
optional boolean silent
# Whether the result is expected to be a JSON object which should be sent by value.
+ # Can be overriden by `serializationOptions`.
optional boolean returnByValue
# Whether preview should be generated for the result.
experimental optional boolean generatePreview
@@ -1415,10 +1437,15 @@ domain Runtime
# boundaries).
# This is mutually exclusive with `executionContextId`.
experimental optional string uniqueContextId
+ # Deprecated. Use `serializationOptions: {serialization:"deep"}` instead.
# Whether the result should contain `webDriverValue`, serialized according to
- # https://goo.gle/browser-automation-deepserialization. This is mutually
- # exclusive with `returnByValue`, but resulting `objectId` is still provided.
- experimental optional boolean generateWebDriverValue
+ # https://w3c.github.io/webdriver-bidi. This is mutually exclusive with `returnByValue`, but
+ # resulting `objectId` is still provided.
+ deprecated optional boolean generateWebDriverValue
+ # Specifies the result serialization. If provided, overrides
+ # `returnByValue` and `generateWebDriverValue`.
+ experimental optional SerializationOptions serializationOptions
+
returns
# Call result.
RemoteObject result
@@ -1504,8 +1531,15 @@ domain Runtime
# boundaries).
# This is mutually exclusive with `contextId`.
experimental optional string uniqueContextId
- # Whether the result should be serialized according to https://goo.gle/browser-automation-deepserialization.
- experimental optional boolean generateWebDriverValue
+ # Deprecated. Use `serializationOptions: {serialization:"deep"}` instead.
+ # 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.
+ deprecated optional boolean generateWebDriverValue
+ # Specifies the result serialization. If provided, overrides
+ # `returnByValue` and `generateWebDriverValue`.
+ experimental optional SerializationOptions serializationOptions
returns
# Evaluation result.
RemoteObject result
Roll protocol to r1139932 — 2023-05-05T04:26:32.000Z
@@ browser_protocol.pdl:658 @@ experimental domain Audits
boolean isWarning
SharedArrayBufferIssueType type
- type TwaQualityEnforcementViolationType extends string
- enum
- kHttpError
- kUnavailableOffline
- kDigitalAssetLinks
-
- type TrustedWebActivityIssueDetails extends object
- properties
- # The url that triggers the violation.
- string url
- TwaQualityEnforcementViolationType violationType
- optional integer httpStatusCode
- # The package name of the Trusted Web Activity client app. This field is
- # only used when violation type is kDigitalAssetLinks.
- optional string packageName
- # The signature of the Trusted Web Activity client app. This field is only
- # used when violation type is kDigitalAssetLinks.
- optional string signature
-
type LowTextContrastIssueDetails extends object
properties
DOM.BackendNodeId violatingNodeId
@@ -855,7 +836,6 @@ experimental domain Audits
HeavyAdIssue
ContentSecurityPolicyIssue
SharedArrayBufferIssue
- TrustedWebActivityIssue
LowTextContrastIssue
CorsIssue
AttributionReportingIssue
@@ -878,7 +858,6 @@ experimental domain Audits
optional HeavyAdIssueDetails heavyAdIssueDetails
optional ContentSecurityPolicyIssueDetails contentSecurityPolicyIssueDetails
optional SharedArrayBufferIssueDetails sharedArrayBufferIssueDetails
- optional TrustedWebActivityIssueDetails twaQualityEnforcementDetails
optional LowTextContrastIssueDetails lowTextContrastIssueDetails
optional CorsIssueDetails corsIssueDetails
optional AttributionReportingIssueDetails attributionReportingIssueDetails
Roll protocol to r1139346 — 2023-05-04T04:26:49.000Z
@@ browser_protocol.pdl:944 @@ experimental domain Audits
parameters
InspectorIssue issue
+# Defines commands and events for Autofill.
+experimental domain Autofill
+ type CreditCard extends object
+ properties
+ # 16-digit credit card number.
+ string number
+ # Name of the credit card owner.
+ string name
+ # 2-digit expiry month.
+ string expiryMonth
+ # 4-digit expiry year.
+ string expiryYear
+ # 3-digit card verification code.
+ string cvc
+
+ # Trigger autofill on a form identified by the fieldId.
+ # If the field and related form cannot be autofilled, returns an error.
+ command trigger
+ parameters
+ # Identifies a field that serves as an anchor for autofill.
+ DOM.BackendNodeId fieldId
+ # Credit card information to fill out the form. Credit card data is not saved.
+ CreditCard card
+
# Defines events for background web platform features.
experimental domain BackgroundService
# The Background Service that will be associated with the commands/events.
Roll protocol to r1138800 — 2023-05-03T04:26:34.000Z
@@ js_protocol.pdl:1015 @@ domain Runtime
type ScriptId extends string
# Represents the value serialiazed by the WebDriver BiDi specification
- # https://w3c.github.io/webdriver-bidi.
- type WebDriverValue extends object
+ # https://goo.gle/browser-automation-deepserialization.
+ type DeepSerializedValue extends object
properties
enum type
undefined
@@ -1102,7 +1102,7 @@ domain Runtime
# String representation of the object.
optional string description
# WebDriver BiDi representation of the value.
- experimental optional WebDriverValue webDriverValue
+ experimental optional DeepSerializedValue webDriverValue
# Unique object identifier (for non-primitive values).
optional RemoteObjectId objectId
# Preview containing abbreviated property values. Specified for `object` type values only.
@@ -1416,8 +1416,8 @@ domain Runtime
# This is mutually exclusive with `executionContextId`.
experimental optional string uniqueContextId
# 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.
+ # https://goo.gle/browser-automation-deepserialization. This is mutually
+ # exclusive with `returnByValue`, but resulting `objectId` is still provided.
experimental optional boolean generateWebDriverValue
returns
# Call result.
@@ -1504,7 +1504,7 @@ domain Runtime
# 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.
+ # Whether the result should be serialized according to https://goo.gle/browser-automation-deepserialization.
experimental optional boolean generateWebDriverValue
returns
# Evaluation result.
Roll protocol to r1138159 — 2023-05-02T04:26:48.000Z
@@ browser_protocol.pdl:707 @@ experimental domain Audits
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
InvalidHeader
InvalidRegisterTriggerHeader
- # TODO(apaseltiner): Remove this issue once DevTools stops referencing it.
- InvalidEligibleHeader
SourceAndTriggerHeaders
SourceIgnored
TriggerIgnored
Roll protocol to r1137730 — 2023-05-01T04:26:59.000Z
@@ js_protocol.pdl:1044 @@ domain Runtime
window
optional any value
optional string objectId
+ # Set if value reference met more then once during serialization. In such
+ # case, value is provided only to one of the serialized values. Unique
+ # per value in the scope of one CDP call.
+ optional integer weakLocalObjectReference
# Unique object identifier.
type RemoteObjectId extends string
Roll protocol to r1137505 — 2023-04-29T04:26:38.000Z
@@ browser_protocol.pdl:4028 @@ domain IO
experimental domain IndexedDB
depends on Runtime
+ depends on Storage
# Database with an array of object stores.
type DatabaseWithObjectStores extends object
@@ -4120,11 +4121,13 @@ experimental domain IndexedDB
# Clears all entries from an object store.
command clearObjectStore
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
@@ -4133,22 +4136,26 @@ experimental domain IndexedDB
# Deletes a database.
command deleteDatabase
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Delete a range of entries from an object store
command deleteObjectStoreEntries
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
string databaseName
string objectStoreName
# Range of entry keys to delete
@@ -4163,11 +4170,13 @@ experimental domain IndexedDB
# Requests data from object store or index.
command requestData
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
@@ -4189,11 +4198,13 @@ experimental domain IndexedDB
# Gets metadata of an object store.
command getMetadata
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
@@ -4209,11 +4220,13 @@ experimental domain IndexedDB
# Requests database with given name in given frame.
command requestDatabase
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
returns
@@ -4223,11 +4236,13 @@ experimental domain IndexedDB
# Requests database names for given security origin.
command requestDatabaseNames
parameters
- # At least and at most one of securityOrigin, storageKey must be specified.
+ # At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
+ # Storage bucket. If not specified, it uses the default bucket.
+ optional Storage.StorageBucket storageBucket
returns
# Database names for origin.
array of string databaseNames
@@ -9166,12 +9181,16 @@ experimental domain Storage
relaxed
strict
- type StorageBucketInfo extends object
+ type StorageBucket extends object
properties
SerializedStorageKey storageKey
+ # If not specified, it is the default bucket of the storageKey.
+ optional string name
+
+ type StorageBucketInfo extends object
+ properties
+ StorageBucket bucket
string id
- string name
- boolean isDefault
Network.TimeSinceEpoch expiration
# Storage quota (bytes).
number quota
@@ -9383,8 +9402,7 @@ experimental domain Storage
# Deletes the Storage Bucket with the given storage key and bucket name.
experimental command deleteStorageBucket
parameters
- string storageKey
- string bucketName
+ StorageBucket bucket
# Deletes state for sites identified as potential bounce trackers, immediately.
experimental command runBounceTrackingMitigations
@@ -9416,6 +9434,8 @@ experimental domain Storage
string origin
# Storage key to update.
string storageKey
+ # Storage bucket to update.
+ string bucketId
# Database to update.
string databaseName
# ObjectStore to update.
@@ -9428,6 +9448,8 @@ experimental domain Storage
string origin
# Storage key to update.
string storageKey
+ # Storage bucket to update.
+ string bucketId
# One of the interest groups was accessed by the associated page.
event interestGroupAccessed
@@ -9455,7 +9477,7 @@ experimental domain Storage
event storageBucketCreatedOrUpdated
parameters
- StorageBucketInfo bucket
+ StorageBucketInfo bucketInfo
event storageBucketDeleted
parameters
@@ -10832,6 +10854,19 @@ experimental domain Preload
# - https://wicg.github.io/nav-speculation/speculation-rules.html
# - https://github.com/WICG/nav-speculation/blob/main/triggers.md
string sourceText
+ # A speculation rule set is either added through an inline
+ # <script> tag or through an external resource via the
+ # 'Speculation-Rules' HTTP header. For the first case, we include
+ # the BackendNodeId of the relevant <script> tag. For the second
+ # case, we include the external URL where the rule set was loaded
+ # from, and also RequestId if Network domain is enabled.
+ #
+ # See also:
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-script
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-header
+ optional DOM.BackendNodeId backendNodeId
+ optional string url
+ optional Network.RequestId requestId
# Error information
# `errorMessage` is null iff `errorType` is null.
optional RuleSetErrorType errorType
Roll protocol to r1136950 — 2023-04-28T04:26:58.000Z
@@ browser_protocol.pdl:707 @@ experimental domain Audits
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
InvalidHeader
InvalidRegisterTriggerHeader
+ # TODO(apaseltiner): Remove this issue once DevTools stops referencing it.
InvalidEligibleHeader
SourceAndTriggerHeaders
SourceIgnored
Roll protocol to r1135726 — 2023-04-26T04:27:01.000Z
@@ browser_protocol.pdl:4668 @@ experimental domain LayerTree
LayerId layerId
returns
# A list of strings specifying reasons for the given layer to become composited.
- deprecated array of string compositingReasons
+ array of string compositingReasons
# A list of strings specifying reason IDs for the given layer to become composited.
array of string compositingReasonIds
@@ -7228,6 +7228,7 @@ domain Page
payment
picture-in-picture
private-aggregation
+ private-state-token-issuance
private-state-token-redemption
publickey-credentials-get
run-ad-auction
@@ -9384,6 +9385,11 @@ experimental domain Storage
string storageKey
string bucketName
+ # Deletes state for sites identified as potential bounce trackers, immediately.
+ experimental command runBounceTrackingMitigations
+ returns
+ array of string deletedSites
+
# A cache's contents have been modified.
event cacheStorageContentUpdated
parameters
Roll protocol to r1135028 — 2023-04-25T04:27:09.000Z
@@ browser_protocol.pdl:716 @@ experimental domain Audits
InvalidRegisterOsSourceHeader
InvalidRegisterOsTriggerHeader
WebAndOsHeaders
+ NoWebOrOsSupport
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
@@ -7227,6 +7228,7 @@ domain Page
payment
picture-in-picture
private-aggregation
+ private-state-token-redemption
publickey-credentials-get
run-ad-auction
screen-wake-lock
@@ -7237,7 +7239,6 @@ domain Page
smart-card
storage-access
sync-xhr
- trust-token-redemption
unload
usb
vertical-scroll
Roll protocol to r1134390 — 2023-04-24T04:27:12.000Z
@@ js_protocol.pdl:632 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
- # Embedder-specific auxiliary data.
+ # Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
# URL of source map associated with script (if any).
optional string sourceMapURL
@@ -671,7 +671,7 @@ domain Debugger
Runtime.ExecutionContextId executionContextId
# Content hash of the script, SHA-256.
string hash
- # Embedder-specific auxiliary data.
+ # Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object executionContextAuxData
# True, if this script is generated as a result of the live edit operation.
experimental optional boolean isLiveEdit
@@ -1284,7 +1284,7 @@ domain Runtime
# 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.
+ # Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
optional object auxData
# Detailed information about exception (or error) that was thrown during script compilation or
Roll protocol to r1134181 — 2023-04-22T04:26:52.000Z
@@ browser_protocol.pdl:10950 @@ experimental domain Preload
CrossSiteNavigationInMainFrameNavigation
SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation
SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
+ MemoryPressureOnTrigger
+ MemoryPressureAfterTriggered
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1133601 — 2023-04-21T04:27:13.000Z
@@ browser_protocol.pdl:777 @@ experimental domain Audits
# This issue warns about sites in the redirect chain of a finished navigation
# that may be flagged as trackers and have their state cleared if they don't
- # receive a user interaction. Note that in this context 'site' means eTLD+1.
- # For example, if the URL `https://example.test:80/bounce` was in the
+ # receive a user interaction. Note that in this context 'site' means eTLD+1.
+ # For example, if the URL `https://example.test:80/bounce` was in the
# redirect chain, the site reported would be `example.test`.
type BounceTrackingIssueDetails extends object
properties
@@ -10963,6 +10963,20 @@ experimental domain Preload
# that is incompatible with prerender and has caused the cancellation of the attempt
optional string disallowedApiMethod
+ type PreloadEnabledState extends string
+ enum
+ Enabled
+ DisabledByDataSaver
+ DisabledByBatterySaver
+ DisabledByPreference
+ # Service not available.
+ NotSupported
+
+ # Fired when a preload enabled state is updated.
+ event preloadEnabledStateUpdated
+ parameters
+ PreloadEnabledState state
+
# Preloading status values, see also PreloadingTriggeringOutcome. This
# status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
type PreloadingStatus extends string
Roll protocol to r1132318 — 2023-04-19T04:27:21.000Z
@@ browser_protocol.pdl:809 @@ experimental domain Audits
WellKnownNoResponse
WellKnownInvalidResponse
WellKnownListEmpty
+ WellKnownInvalidContentType
ConfigNotInWellKnown
WellKnownTooBig
ConfigHttpNotFound
ConfigNoResponse
ConfigInvalidResponse
+ ConfigInvalidContentType
ClientMetadataHttpNotFound
ClientMetadataNoResponse
ClientMetadataInvalidResponse
+ ClientMetadataInvalidContentType
DisabledInSettings
ErrorFetchingSignin
InvalidSigninResponse
@@ -824,10 +827,12 @@ experimental domain Audits
AccountsNoResponse
AccountsInvalidResponse
AccountsListEmpty
+ AccountsInvalidContentType
IdTokenHttpNotFound
IdTokenNoResponse
IdTokenInvalidResponse
IdTokenInvalidRequest
+ IdTokenInvalidContentType
ErrorIdToken
Canceled
RpPageNotVisible
Roll protocol to r1131670 — 2023-04-18T04:26:48.000Z
@@ browser_protocol.pdl:1412 @@ experimental domain CSS
number endLine
# Column offset of the end of the stylesheet within the resource (zero based).
number endColumn
+ # If the style sheet was loaded from a network resource, this indicates when the resource failed to load
+ experimental optional boolean loadingFailed
# CSS rule representation.
type CSSRule extends object
Roll protocol to r1130274 — 2023-04-14T04:26:53.000Z
@@ browser_protocol.pdl:775 @@ experimental domain Audits
# One of the deprecation names from third_party/blink/renderer/core/frame/deprecation/deprecation.json5
string type
+ # This issue warns about sites in the redirect chain of a finished navigation
+ # that may be flagged as trackers and have their state cleared if they don't
+ # receive a user interaction. Note that in this context 'site' means eTLD+1.
+ # For example, if the URL `https://example.test:80/bounce` was in the
+ # redirect chain, the site reported would be `example.test`.
+ type BounceTrackingIssueDetails extends object
+ properties
+ array of string trackingSites
+
type ClientHintIssueReason extends string
enum
# Items in the accept-ch meta tag allow list must be valid origins.
@@ -851,6 +860,7 @@ experimental domain Audits
DeprecationIssue
ClientHintIssue
FederatedAuthRequestIssue
+ BounceTrackingIssue
# 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
@@ -873,6 +883,7 @@ experimental domain Audits
optional DeprecationIssueDetails deprecationIssueDetails
optional ClientHintIssueDetails clientHintIssueDetails
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
+ optional BounceTrackingIssueDetails bounceTrackingIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
Roll protocol to r1129676 — 2023-04-13T04:27:09.000Z
@@ browser_protocol.pdl:708 @@ experimental domain Audits
InvalidHeader
InvalidRegisterTriggerHeader
InvalidEligibleHeader
- # TODO(crbug.com/1431942): Remove this issue once DevTools stops
- # referencing it
- TooManyConcurrentRequests
SourceAndTriggerHeaders
SourceIgnored
TriggerIgnored
Roll protocol to r1129085 — 2023-04-12T04:26:50.000Z
@@ browser_protocol.pdl:708 @@ experimental domain Audits
InvalidHeader
InvalidRegisterTriggerHeader
InvalidEligibleHeader
+ # TODO(crbug.com/1431942): Remove this issue once DevTools stops
+ # referencing it
TooManyConcurrentRequests
SourceAndTriggerHeaders
SourceIgnored
Roll protocol to r1126404 — 2023-04-05T04:27:02.000Z
@@ browser_protocol.pdl:1679 @@ experimental domain CSS
# Parent stylesheet's origin.
StyleSheetOrigin origin
# Associated style declaration.
- optional CSSStyle style
+ CSSStyle style
# CSS position-fallback rule representation.
type CSSPositionFallbackRule extends object
Roll protocol to r1124027 — 2023-03-30T04:27:29.000Z
@@ browser_protocol.pdl:765 @@ experimental domain Audits
GenericIssueErrorType errorType
optional Page.FrameId frameId
optional DOM.BackendNodeId violatingNodeId
+ optional string violatingNodeAttribute
# This issue tracks information needed to print a deprecation message.
# https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
Roll protocol to r1122837 — 2023-03-28T04:27:31.000Z
@@ browser_protocol.pdl:1669 @@ experimental domain CSS
# Available variation settings (a.k.a. "axes").
optional array of FontVariationAxis fontVariationAxes
+ # CSS try rule representation.
+ type CSSTryRule extends object
+ properties
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
+ # stylesheet rules) this rule came from.
+ optional StyleSheetId styleSheetId
+ # Parent stylesheet's origin.
+ StyleSheetOrigin origin
+ # Associated style declaration.
+ optional CSSStyle style
+
+ # CSS position-fallback rule representation.
+ type CSSPositionFallbackRule extends object
+ properties
+ Value name
+ # List of keyframes.
+ array of CSSTryRule tryRules
+
# CSS keyframes rule representation.
type CSSKeyframesRule extends object
properties
@@ -1802,6 +1820,8 @@ experimental domain CSS
optional array of InheritedPseudoElementMatches inheritedPseudoElements
# A list of CSS keyframed animations matching this node.
optional array of CSSKeyframesRule cssKeyframesRules
+ # A list of CSS position fallbacks matching this node.
+ optional array of CSSPositionFallbackRule cssPositionFallbackRules
# Id of the first parent element that does not have display: contents.
experimental optional DOM.NodeId parentLayoutNodeId
Roll protocol to r1122063 — 2023-03-25T04:27:16.000Z
@@ js_protocol.pdl:580 @@ domain Debugger
other
promiseRejection
XHR
+ step
# Object containing break-specific auxiliary properties.
optional object data
# Hit breakpoints IDs
Roll protocol to r1121538 — 2023-03-24T04:27:33.000Z
@@ browser_protocol.pdl:8984 @@ experimental domain Storage
cache_storage
interest_groups
shared_storage
+ storage_buckets
all
other
@@ -9119,6 +9120,23 @@ experimental domain Storage
# SharedStorageAccessType.workletSet.
optional boolean ignoreIfPresent
+ type StorageBucketsDurability extends string
+ enum
+ relaxed
+ strict
+
+ type StorageBucketInfo extends object
+ properties
+ SerializedStorageKey storageKey
+ string id
+ string name
+ boolean isDefault
+ Network.TimeSinceEpoch expiration
+ # Storage quota (bytes).
+ number quota
+ boolean persistent
+ StorageBucketsDurability durability
+
# Returns a storage key given a frame id.
command getStorageKeyForFrame
parameters
@@ -9315,6 +9333,18 @@ experimental domain Storage
parameters
boolean enable
+ # Set tracking for a storage key's buckets.
+ experimental command setStorageBucketTracking
+ parameters
+ string storageKey
+ boolean enable
+
+ # Deletes the Storage Bucket with the given storage key and bucket name.
+ experimental command deleteStorageBucket
+ parameters
+ string storageKey
+ string bucketName
+
# A cache's contents have been modified.
event cacheStorageContentUpdated
parameters
@@ -9377,6 +9407,14 @@ experimental domain Storage
# presence/absence depends on `type`.
SharedStorageAccessParams params
+ event storageBucketCreatedOrUpdated
+ parameters
+ StorageBucketInfo bucket
+
+ event storageBucketDeleted
+ parameters
+ string bucketId
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
@@ -10748,6 +10786,16 @@ experimental domain Preload
# - https://wicg.github.io/nav-speculation/speculation-rules.html
# - https://github.com/WICG/nav-speculation/blob/main/triggers.md
string sourceText
+ # Error information
+ # `errorMessage` is null iff `errorType` is null.
+ optional RuleSetErrorType errorType
+ # TODO(https://crbug.com/1425354): Replace this property with structured error.
+ deprecated optional string errorMessage
+
+ type RuleSetErrorType extends string
+ enum
+ SourceIsNotJsonObject
+ InvalidRulesSkipped
# The type of preloading attempted. It corresponds to
# mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
@@ -10941,6 +10989,10 @@ experimental domain FedCm
parameters
string dialogId
array of Account accounts
+ # These exist primarily so that the caller can verify the
+ # RP context was used appropriately.
+ string title
+ optional string subtitle
command enable
parameters
@@ -10959,3 +11011,9 @@ experimental domain FedCm
command dismissDialog
parameters
string dialogId
+ optional boolean triggerCooldown
+
+ # Resets the cooldown time, if any, to allow the next FedCM call to show
+ # a dialog even if one was recently dismissed by the user.
+ command resetCooldown
+
Roll protocol to r1120988 — 2023-03-23T04:27:35.000Z
@@ browser_protocol.pdl:10868 @@ experimental domain Preload
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
parameters
+ PreloadingAttemptKey key
# The frame id of the frame initiating prerendering.
Page.FrameId initiatingFrameId
string prerenderingUrl
@@ -10891,6 +10892,7 @@ experimental domain Preload
# Fired when a prefetch attempt is updated.
event prefetchStatusUpdated
parameters
+ PreloadingAttemptKey key
# The frame id of the frame initiating prefetch.
Page.FrameId initiatingFrameId
string prefetchUrl
@@ -10899,6 +10901,7 @@ experimental domain Preload
# Fired when a prerender attempt is updated.
event prerenderStatusUpdated
parameters
+ PreloadingAttemptKey key
# The frame id of the frame initiating prerender.
Page.FrameId initiatingFrameId
string prerenderingUrl
Roll protocol to r1120367 — 2023-03-22T04:27:34.000Z
@@ browser_protocol.pdl:756 @@ experimental domain Audits
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
FormLabelHasNeitherForNorNestedInput
FormLabelForMatchesNonExistingIdError
+ FormInputHasWrongButWellIntendedAutocompleteValueError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
@@ -10903,9 +10904,10 @@ experimental domain Preload
string prerenderingUrl
PreloadingStatus status
- # Send a list of sources for all preloading attempts.
+ # Send a list of sources for all preloading attempts in a document.
event preloadingAttemptSourcesUpdated
parameters
+ Network.LoaderId loaderId
array of PreloadingAttemptSource preloadingAttemptSources
# This domain allows interacting with the FedCM dialog.
Roll protocol to r1119769 — 2023-03-21T04:27:17.000Z
@@ browser_protocol.pdl:10842 @@ experimental domain Preload
InactivePageRestriction
StartFailed
TimeoutBackgrounded
- CrossSiteRedirect
- CrossSiteNavigation
- SameSiteCrossOriginRedirect
- SameSiteCrossOriginRedirectNotOptIn
- SameSiteCrossOriginNavigationNotOptIn
+ CrossSiteRedirectInInitialNavigation
+ CrossSiteNavigationInInitialNavigation
+ SameSiteCrossOriginRedirectNotOptInInInitialNavigation
+ SameSiteCrossOriginNavigationNotOptInInInitialNavigation
ActivationNavigationParameterMismatch
ActivatedInBackground
EmbedderHostDisallowed
@@ -10860,6 +10859,10 @@ experimental domain Preload
BatterySaverEnabled
ActivatedDuringMainFrameNavigation
PreloadingUnsupportedByWebContents
+ CrossSiteRedirectInMainFrameNavigation
+ CrossSiteNavigationInMainFrameNavigation
+ SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation
+ SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
@@ -10935,6 +10938,12 @@ experimental domain FedCm
array of Account accounts
command enable
+ parameters
+ # Allows callers to disable the promise rejection delay that would
+ # normally happen, if this is unimportant to what's being tested.
+ # (step 4 of https://fedidcg.github.io/FedCM/#browser-api-rp-sign-in)
+ optional boolean disableRejectionDelay
+
command disable
command selectAccount
Roll protocol to r1119014 — 2023-03-18T04:27:47.000Z
@@ browser_protocol.pdl:1409 @@ experimental domain CSS
optional StyleSheetId styleSheetId
# Rule selector data.
SelectorList selectorList
+ # Array of selectors from ancestor style rules, sorted by distance from the current rule.
+ experimental optional array of string nestingSelectors
# Parent stylesheet's origin.
StyleSheetOrigin origin
# Associated style declaration.
Roll protocol to r1116775 — 2023-03-14T04:28:31.000Z
@@ browser_protocol.pdl:712 @@ experimental domain Audits
SourceAndTriggerHeaders
SourceIgnored
TriggerIgnored
+ OsSourceIgnored
+ OsTriggerIgnored
+ InvalidRegisterOsSourceHeader
+ InvalidRegisterOsTriggerHeader
+ WebAndOsHeaders
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
@@ -10900,6 +10905,13 @@ experimental domain Preload
# This domain allows interacting with the FedCM dialog.
experimental domain FedCm
+ # Whether this is a sign-up or sign-in action for this account, i.e.
+ # whether this account has ever been used to sign in to this RP before.
+ type LoginState extends string
+ enum
+ SignIn
+ SignUp
+
# Corresponds to IdentityRequestAccount
type Account extends object
properties
@@ -10909,10 +10921,25 @@ experimental domain FedCm
string givenName
string pictureUrl
string idpConfigUrl
+ string idpSigninUrl
+ LoginState loginState
+ # These two are only set if the loginState is signUp
+ optional string termsOfServiceUrl
+ optional string privacyPolicyUrl
event dialogShown
parameters
+ string dialogId
array of Account accounts
command enable
command disable
+
+ command selectAccount
+ parameters
+ string dialogId
+ integer accountIndex
+
+ command dismissDialog
+ parameters
+ string dialogId
Roll protocol to r1115542 — 2023-03-10T04:29:00.000Z
@@ browser_protocol.pdl:10900 @@ experimental domain Preload
# This domain allows interacting with the FedCM dialog.
experimental domain FedCm
+ # Corresponds to IdentityRequestAccount
+ type Account extends object
+ properties
+ string accountId
+ string email
+ string name
+ string givenName
+ string pictureUrl
+ string idpConfigUrl
+
event dialogShown
+ parameters
+ array of Account accounts
command enable
command disable
Roll protocol to r1114954 — 2023-03-09T04:29:10.000Z
@@ browser_protocol.pdl:10838 @@ experimental domain Preload
CrossSiteRedirect
CrossSiteNavigation
SameSiteCrossOriginRedirect
- SameSiteCrossOriginNavigation
SameSiteCrossOriginRedirectNotOptIn
SameSiteCrossOriginNavigationNotOptIn
ActivationNavigationParameterMismatch
Roll protocol to r1114386 — 2023-03-08T04:28:54.000Z
@@ browser_protocol.pdl:702 @@ experimental domain Audits
type AttributionReportingIssueType extends string
enum
PermissionPolicyDisabled
- PermissionPolicyNotDelegated
UntrustworthyReportingOrigin
InsecureContext
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
Roll protocol to r1113774 — 2023-03-07T04:29:03.000Z
@@ browser_protocol.pdl:10742 @@ experimental domain Preload
# - https://github.com/WICG/nav-speculation/blob/main/triggers.md
string sourceText
+ # The type of preloading attempted. It corresponds to
+ # mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
+ # isn't being used by clients).
+ type SpeculationAction extends string
+ enum
+ Prefetch
+ Prerender
+
+ # Corresponds to mojom::SpeculationTargetHint.
+ # See https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
+ type SpeculationTargetHint extends string
+ enum
+ Blank
+ Self
+
+ # A key that identifies a preloading attempt.
+ #
+ # The url used is the url specified by the trigger (i.e. the initial URL), and
+ # not the final url that is navigated to. For example, prerendering allows
+ # same-origin main frame navigations during the attempt, but the attempt is
+ # still keyed with the initial URL.
+ type PreloadingAttemptKey extends object
+ properties
+ Network.LoaderId loaderId
+ SpeculationAction action
+ string url
+ optional SpeculationTargetHint targetHint
+
+ # Lists sources for a preloading attempt, specifically the ids of rule sets
+ # that had a speculation rule that triggered the attempt, and the
+ # BackendNodeIds of <a href> or <area href> elements that triggered the
+ # attempt (in the case of attempts triggered by a document rule). It is
+ # possible for mulitple rule sets and links to trigger a single attempt.
+ type PreloadingAttemptSource extends object
+ properties
+ PreloadingAttemptKey key
+ array of RuleSetId ruleSetIds
+ array of DOM.BackendNodeId nodeIds
+
command enable
command disable
@@ -10856,6 +10895,11 @@ experimental domain Preload
string prerenderingUrl
PreloadingStatus status
+ # Send a list of sources for all preloading attempts.
+ event preloadingAttemptSourcesUpdated
+ parameters
+ array of PreloadingAttemptSource preloadingAttemptSources
+
# This domain allows interacting with the FedCM dialog.
experimental domain FedCm
event dialogShown
Roll protocol to r1113120 — 2023-03-04T04:28:32.000Z
@@ browser_protocol.pdl:8482 @@ domain Page
# Tree structure of reasons why the page could not be cached for each frame.
optional BackForwardCacheNotRestoredExplanationTree notRestoredExplanationsTree
- # List of FinalStatus reasons for Prerender2.
- type PrerenderFinalStatus extends string
- enum
- Activated
- Destroyed
- LowEndDevice
- InvalidSchemeRedirect
- InvalidSchemeNavigation
- InProgressNavigation
- NavigationRequestBlockedByCsp
- MainFrameNavigation
- MojoBinderPolicy
- RendererProcessCrashed
- RendererProcessKilled
- Download
- TriggerDestroyed
- NavigationNotCommitted
- NavigationBadHttpStatus
- ClientCertRequested
- NavigationRequestNetworkError
- MaxNumOfRunningPrerendersExceeded
- CancelAllHostsForTesting
- DidFailLoad
- Stop
- SslCertificateError
- LoginAuthRequested
- UaChangeRequiresReload
- BlockedByClient
- AudioOutputDeviceRequested
- MixedContent
- TriggerBackgrounded
- EmbedderTriggeredAndCrossOriginRedirected
- MemoryLimitExceeded
- # Prerenders can be cancelled when Chrome uses excessive memory. This is
- # recorded when it fails to get the memory usage.
- FailToGetMemoryUsage
- DataSaverEnabled
- HasEffectiveUrl
- ActivatedBeforeStarted
- InactivePageRestriction
- StartFailed
- TimeoutBackgrounded
- CrossSiteRedirect
- CrossSiteNavigation
- SameSiteCrossOriginRedirect
- SameSiteCrossOriginNavigation
- SameSiteCrossOriginRedirectNotOptIn
- SameSiteCrossOriginNavigationNotOptIn
- ActivationNavigationParameterMismatch
- ActivatedInBackground
- EmbedderHostDisallowed
- ActivationNavigationDestroyedBeforeSuccess
- TabClosedByUserGesture
- TabClosedWithoutUserGesture
- PrimaryMainFrameRendererProcessCrashed
- PrimaryMainFrameRendererProcessKilled
- ActivationFramePolicyNotCompatible
- PreloadingDisabled
- BatterySaverEnabled
- ActivatedDuringMainFrameNavigation
- PreloadingUnsupportedByWebContents
-
- # Fired when a prerender attempt is completed.
- experimental event prerenderAttemptCompleted
- parameters
- # The frame id of the frame initiating prerendering.
- FrameId initiatingFrameId
- string prerenderingUrl
- PrerenderFinalStatus finalStatus
- # This is used to give users more information about the name of the API call
- # that is incompatible with prerender and has caused the cancellation of the attempt
- optional string disallowedApiMethod
-
- # Preloading status values, see also PreloadingTriggeringOutcome. This
- # status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
- type PreloadingStatus extends string
- enum
- Pending
- Running
- Ready
- Success
- Failure
- # PreloadingTriggeringOutcome which not used by prefetch nor prerender.
- NotSupported
-
- # TODO(crbug/1384419): Create a dedicated domain for preloading.
- # Fired when a prefetch attempt is updated.
- experimental event prefetchStatusUpdated
- parameters
- # The frame id of the frame initiating prefetch.
- FrameId initiatingFrameId
- string prefetchUrl
- PreloadingStatus status
-
- # TODO(crbug/1384419): Create a dedicated domain for preloading.
- # Fired when a prerender attempt is updated.
- experimental event prerenderStatusUpdated
- parameters
- # The frame id of the frame initiating prerender.
- FrameId initiatingFrameId
- string prerenderingUrl
- PreloadingStatus status
-
event loadEventFired
parameters
Network.MonotonicTime timestamp
@@ -10858,6 +10755,107 @@ experimental domain Preload
parameters
RuleSetId id
+ # List of FinalStatus reasons for Prerender2.
+ type PrerenderFinalStatus extends string
+ enum
+ Activated
+ Destroyed
+ LowEndDevice
+ InvalidSchemeRedirect
+ InvalidSchemeNavigation
+ InProgressNavigation
+ NavigationRequestBlockedByCsp
+ MainFrameNavigation
+ MojoBinderPolicy
+ RendererProcessCrashed
+ RendererProcessKilled
+ Download
+ TriggerDestroyed
+ NavigationNotCommitted
+ NavigationBadHttpStatus
+ ClientCertRequested
+ NavigationRequestNetworkError
+ MaxNumOfRunningPrerendersExceeded
+ CancelAllHostsForTesting
+ DidFailLoad
+ Stop
+ SslCertificateError
+ LoginAuthRequested
+ UaChangeRequiresReload
+ BlockedByClient
+ AudioOutputDeviceRequested
+ MixedContent
+ TriggerBackgrounded
+ EmbedderTriggeredAndCrossOriginRedirected
+ MemoryLimitExceeded
+ # Prerenders can be cancelled when Chrome uses excessive memory. This is
+ # recorded when it fails to get the memory usage.
+ FailToGetMemoryUsage
+ DataSaverEnabled
+ HasEffectiveUrl
+ ActivatedBeforeStarted
+ InactivePageRestriction
+ StartFailed
+ TimeoutBackgrounded
+ CrossSiteRedirect
+ CrossSiteNavigation
+ SameSiteCrossOriginRedirect
+ SameSiteCrossOriginNavigation
+ SameSiteCrossOriginRedirectNotOptIn
+ SameSiteCrossOriginNavigationNotOptIn
+ ActivationNavigationParameterMismatch
+ ActivatedInBackground
+ EmbedderHostDisallowed
+ ActivationNavigationDestroyedBeforeSuccess
+ TabClosedByUserGesture
+ TabClosedWithoutUserGesture
+ PrimaryMainFrameRendererProcessCrashed
+ PrimaryMainFrameRendererProcessKilled
+ ActivationFramePolicyNotCompatible
+ PreloadingDisabled
+ BatterySaverEnabled
+ ActivatedDuringMainFrameNavigation
+ PreloadingUnsupportedByWebContents
+
+ # Fired when a prerender attempt is completed.
+ event prerenderAttemptCompleted
+ parameters
+ # The frame id of the frame initiating prerendering.
+ Page.FrameId initiatingFrameId
+ string prerenderingUrl
+ PrerenderFinalStatus finalStatus
+ # This is used to give users more information about the name of the API call
+ # that is incompatible with prerender and has caused the cancellation of the attempt
+ optional string disallowedApiMethod
+
+ # Preloading status values, see also PreloadingTriggeringOutcome. This
+ # status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
+ type PreloadingStatus extends string
+ enum
+ Pending
+ Running
+ Ready
+ Success
+ Failure
+ # PreloadingTriggeringOutcome which not used by prefetch nor prerender.
+ NotSupported
+
+ # Fired when a prefetch attempt is updated.
+ event prefetchStatusUpdated
+ parameters
+ # The frame id of the frame initiating prefetch.
+ Page.FrameId initiatingFrameId
+ string prefetchUrl
+ PreloadingStatus status
+
+ # Fired when a prerender attempt is updated.
+ event prerenderStatusUpdated
+ parameters
+ # The frame id of the frame initiating prerender.
+ Page.FrameId initiatingFrameId
+ string prerenderingUrl
+ PreloadingStatus status
+
# This domain allows interacting with the FedCM dialog.
experimental domain FedCm
event dialogShown
Roll protocol to r1112051 — 2023-03-02T04:29:08.000Z
@@ browser_protocol.pdl:10857 @@ experimental domain Preload
event ruleSetRemoved
parameters
RuleSetId id
+
+# This domain allows interacting with the FedCM dialog.
+experimental domain FedCm
+ event dialogShown
+
+ command enable
+ command disable
Roll protocol to r1111422 — 2023-03-01T04:29:07.000Z
@@ browser_protocol.pdl:752 @@ experimental domain Audits
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
FormLabelHasNeitherForNorNestedInput
FormLabelForMatchesNonExistingIdError
- FormHasPasswordFieldWithoutUsernameFieldError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1109433 — 2023-02-24T04:29:05.000Z
@@ browser_protocol.pdl:752 @@ experimental domain Audits
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
FormLabelHasNeitherForNorNestedInput
FormLabelForMatchesNonExistingIdError
+ FormHasPasswordFieldWithoutUsernameFieldError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1107588 — 2023-02-21T04:28:49.000Z
@@ browser_protocol.pdl:8555 @@ domain Page
# that is incompatible with prerender and has caused the cancellation of the attempt
optional string disallowedApiMethod
- # List of Prefetch status, which refers to PreloadingTriggeringOutcome.
- type PrefetchStatus extends string
+ # Preloading status values, see also PreloadingTriggeringOutcome. This
+ # status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
+ type PreloadingStatus extends string
enum
+ Pending
Running
Ready
Success
Failure
- # PreloadingTriggeringOutcome which not used by prefetch.
+ # PreloadingTriggeringOutcome which not used by prefetch nor prerender.
NotSupported
# TODO(crbug/1384419): Create a dedicated domain for preloading.
@@ -8572,7 +8574,16 @@ domain Page
# The frame id of the frame initiating prefetch.
FrameId initiatingFrameId
string prefetchUrl
- PrefetchStatus status
+ PreloadingStatus status
+
+ # TODO(crbug/1384419): Create a dedicated domain for preloading.
+ # Fired when a prerender attempt is updated.
+ experimental event prerenderStatusUpdated
+ parameters
+ # The frame id of the frame initiating prerender.
+ FrameId initiatingFrameId
+ string prerenderingUrl
+ PreloadingStatus status
event loadEventFired
parameters
Roll protocol to r1105486 — 2023-02-15T04:28:51.000Z
@@ browser_protocol.pdl:10814 @@ experimental domain DeviceAccess
parameters
RequestId id
array of PromptDevice devices
+
+experimental domain Preload
+ # Unique id
+ type RuleSetId extends string
+
+ # Corresponds to SpeculationRuleSet
+ type RuleSet extends object
+ properties
+ RuleSetId id
+ # Identifies a document which the rule set is associated with.
+ Network.LoaderId loaderId
+ # Source text of JSON representing the rule set. If it comes from
+ # <script> tag, it is the textContent of the node. Note that it is
+ # a JSON for valid case.
+ #
+ # See also:
+ # - https://wicg.github.io/nav-speculation/speculation-rules.html
+ # - https://github.com/WICG/nav-speculation/blob/main/triggers.md
+ string sourceText
+
+ command enable
+
+ command disable
+
+ # Upsert. Currently, it is only emitted when a rule set added.
+ event ruleSetUpdated
+ parameters
+ RuleSet ruleSet
+
+ event ruleSetRemoved
+ parameters
+ RuleSetId id
Roll protocol to r1103684 — 2023-02-10T04:28:55.000Z
@@ browser_protocol.pdl:8555 @@ domain Page
# that is incompatible with prerender and has caused the cancellation of the attempt
optional string disallowedApiMethod
+ # List of Prefetch status, which refers to PreloadingTriggeringOutcome.
+ type PrefetchStatus extends string
+ enum
+ Running
+ Ready
+ Success
+ Failure
+ # PreloadingTriggeringOutcome which not used by prefetch.
+ NotSupported
+
+ # TODO(crbug/1384419): Create a dedicated domain for preloading.
+ # Fired when a prefetch attempt is updated.
+ experimental event prefetchStatusUpdated
+ parameters
+ # The frame id of the frame initiating prefetch.
+ FrameId initiatingFrameId
+ string prefetchUrl
+ PrefetchStatus status
+
event loadEventFired
parameters
Network.MonotonicTime timestamp
@@ -10757,3 +10776,41 @@ experimental domain Media
# Disables the Media domain.
command disable
+
+experimental domain DeviceAccess
+ # Device request id.
+ type RequestId extends string
+
+ # A device id.
+ type DeviceId extends string
+
+ # Device information displayed in a user prompt to select a device.
+ type PromptDevice extends object
+ properties
+ DeviceId id
+ # Display name as it appears in a device request user prompt.
+ string name
+
+ # Enable events in this domain.
+ command enable
+
+ # Disable events in this domain.
+ command disable
+
+ # Select a device in response to a DeviceAccess.deviceRequestPrompted event.
+ command selectPrompt
+ parameters
+ RequestId id
+ DeviceId deviceId
+
+ # Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
+ command cancelPrompt
+ parameters
+ RequestId id
+
+ # A device request opened a user prompt to select a device. Respond with the
+ # selectPrompt or cancelPrompt command.
+ event deviceRequestPrompted
+ parameters
+ RequestId id
+ array of PromptDevice devices
Roll protocol to r1103117 — 2023-02-09T04:28:18.000Z
@@ browser_protocol.pdl:203 @@ experimental domain Accessibility
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node wrapper to get the partial accessibility tree for.
optional Runtime.RemoteObjectId objectId
- # Whether to fetch this nodes ancestors, siblings and children. Defaults to true.
+ # Whether to fetch this node's ancestors, siblings and children. Defaults to true.
optional boolean fetchRelatives
returns
# The `Accessibility.AXNode` for this DOM node, if it exists, plus its ancestors, siblings and
@@ -761,73 +761,14 @@ experimental domain Audits
optional Page.FrameId frameId
optional DOM.BackendNodeId violatingNodeId
- type DeprecationIssueType extends string
- enum
- AuthorizationCoveredByWildcard
- CanRequestURLHTTPContainingNewline
- ChromeLoadTimesConnectionInfo
- ChromeLoadTimesFirstPaintAfterLoadTime
- ChromeLoadTimesWasAlternateProtocolAvailable
- CookieWithTruncatingChar
- CrossOriginAccessBasedOnDocumentDomain
- CrossOriginWindowAlert
- CrossOriginWindowConfirm
- CSSSelectorInternalMediaControlsOverlayCastButton
- DeprecationExample
- DocumentDomainSettingWithoutOriginAgentClusterHeader
- EventPath
- ExpectCTHeader
- GeolocationInsecureOrigin
- GeolocationInsecureOriginDeprecatedNotRemoved
- GetUserMediaInsecureOrigin
- HostCandidateAttributeGetter
- IdentityInCanMakePaymentEvent
- InsecurePrivateNetworkSubresourceRequest
- LocalCSSFileExtensionRejected
- MediaSourceAbortRemove
- MediaSourceDurationTruncatingBuffered
- NoSysexWebMIDIWithoutPermission
- NotificationInsecureOrigin
- NotificationPermissionRequestedIframe
- ObsoleteCreateImageBitmapImageOrientationNone
- ObsoleteWebRtcCipherSuite
- OpenWebDatabaseInsecureContext
- OverflowVisibleOnReplacedElement
- PaymentInstruments
- PaymentRequestCSPViolation
- PersistentQuotaType
- PictureSourceSrc
- PrefixedCancelAnimationFrame
- PrefixedRequestAnimationFrame
- PrefixedStorageInfo
- PrefixedVideoDisplayingFullscreen
- PrefixedVideoEnterFullscreen
- PrefixedVideoEnterFullScreen
- PrefixedVideoExitFullscreen
- PrefixedVideoExitFullScreen
- PrefixedVideoSupportsFullscreen
- PrivacySandboxExtensionsAPI
- RangeExpand
- RequestedSubresourceWithEmbeddedCredentials
- RTCConstraintEnableDtlsSrtpFalse
- RTCConstraintEnableDtlsSrtpTrue
- RTCPeerConnectionComplexPlanBSdpUsingDefaultSdpSemantics
- RTCPeerConnectionSdpSemanticsPlanB
- RtcpMuxPolicyNegotiate
- SharedArrayBufferConstructedWithoutIsolation
- TextToSpeech_DisallowedByAutoplay
- V8SharedArrayBufferConstructedInExtensionWithoutIsolation
- XHRJSONEncodingDetection
- XMLHttpRequestSynchronousInNonWorkerOutsideBeforeUnload
- XRSupportsSession
-
# This issue tracks information needed to print a deprecation message.
# https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
type DeprecationIssueDetails extends object
properties
optional AffectedFrame affectedFrame
SourceCodeLocation sourceCodeLocation
- DeprecationIssueType type
+ # One of the deprecation names from third_party/blink/renderer/core/frame/deprecation/deprecation.json5
+ string type
type ClientHintIssueReason extends string
enum
@@ -1902,7 +1843,7 @@ experimental domain CSS
# Polls the next batch of computed style updates.
experimental command takeComputedStyleUpdates
returns
- # The list of node Ids that have their tracked computed styles updated
+ # The list of node Ids that have their tracked computed styles updated.
array of DOM.NodeId nodeIds
# Find a rule with the given active property for the given node and set the new value for this
@@ -1995,13 +1936,13 @@ experimental domain CSS
command startRuleUsageTracking
# Stop tracking rule usage and return the list of rules that were used since last call to
- # `takeCoverageDelta` (or since start of coverage instrumentation)
+ # `takeCoverageDelta` (or since start of coverage instrumentation).
command stopRuleUsageTracking
returns
array of RuleUsage ruleUsage
# Obtain list of rules that became used since last call to this method (or since start of coverage
- # instrumentation)
+ # instrumentation).
command takeCoverageDelta
returns
array of RuleUsage coverage
@@ -2015,7 +1956,7 @@ experimental domain CSS
boolean enabled
# Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded
- # web font
+ # web font.
event fontsUpdated
parameters
# The web font that has loaded.
@@ -3810,11 +3751,13 @@ domain Emulation
# Emulates the given vision deficiency.
experimental command setEmulatedVisionDeficiency
parameters
- # Vision deficiency to emulate.
+ # Vision deficiency to emulate. Order: best-effort emulations come first, followed by any
+ # physiologically accurate emulations for medically recognized color vision deficiencies.
enum type
none
- achromatopsia
blurredVision
+ reducedContrast
+ achromatopsia
deuteranopia
protanopia
tritanopia
@@ -4196,7 +4139,7 @@ experimental domain IndexedDB
# If true, there are more entries to fetch in the given range.
boolean hasMore
- # Gets metadata of an object store
+ # Gets metadata of an object store.
command getMetadata
parameters
# At least and at most one of securityOrigin, storageKey must be specified.
@@ -9371,6 +9314,15 @@ experimental domain Storage
returns
array of TrustTokens tokens
+ # Removes all Trust Tokens issued by the provided issuerOrigin.
+ # Leaves other stored data, including the issuer's Redemption Records, intact.
+ experimental command clearTrustTokens
+ parameters
+ string issuerOrigin
+ returns
+ # True if any tokens were deleted, false otherwise.
+ boolean didDeleteTokens
+
# Gets details for a named interest group.
experimental command getInterestGroupDetails
parameters
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index d4102f5c..6285d9b6 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -511,6 +511,7 @@ domain Debugger
CompileError
BlockedByActiveGenerator
BlockedByActiveFunction
+ BlockedByTopLevelEsModuleChange
# Exception details if any. Only present when `status` is `CompileError`.
optional Runtime.ExceptionDetails exceptionDetails
Roll protocol to r1102555 — 2023-02-08T04:29:03.000Z
@@ browser_protocol.pdl:2556 @@ domain DOM
array of Quad quads
# Returns the root DOM node (and optionally the subtree) to the caller.
+ # Implicitly enables the DOM domain events for the current target.
command getDocument
parameters
# The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
Roll protocol to r1101985 — 2023-02-07T04:28:15.000Z
@@ browser_protocol.pdl:7735 @@ domain Page
returns
array of InstallabilityError installabilityErrors
- experimental command getManifestIcons
+ # Deprecated because it's not guaranteed that the returned icon is in fact the one used for PWA installation.
+ experimental deprecated command getManifestIcons
returns
optional binary primaryIcon
@@ -8149,24 +8150,25 @@ domain Page
# Clears seeded compilation cache.
experimental command clearCompilationCache
- # Sets the Secure Payment Confirmation transaction mode.
+ # Enum of possible auto-reponse for permisison / prompt dialogs.
+ experimental type AutoResponseMode extends string
+ enum
+ none
+ autoAccept
+ autoReject
+ autoOptOut
+
+# Sets the Secure Payment Confirmation transaction mode.
# https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
experimental command setSPCTransactionMode
parameters
- enum mode
- none
- autoAccept
- autoReject
- autoOptOut
+ AutoResponseMode mode
# Extensions for Custom Handlers API:
# https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
experimental command setRPHRegistrationMode
parameters
- enum mode
- none
- autoaccept
- autoreject
+ AutoResponseMode mode
# Generates a report for testing.
experimental command generateTestReport
Roll protocol to r1101329 — 2023-02-04T04:27:44.000Z
@@ browser_protocol.pdl:8159 @@ domain Page
autoReject
autoOptOut
+ # Extensions for Custom Handlers API:
+ # https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
+ experimental command setRPHRegistrationMode
+ parameters
+ enum mode
+ none
+ autoaccept
+ autoreject
+
# Generates a report for testing.
experimental command generateTestReport
parameters
@@ -8587,6 +8596,7 @@ domain Page
PreloadingDisabled
BatterySaverEnabled
ActivatedDuringMainFrameNavigation
+ PreloadingUnsupportedByWebContents
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1100832 — 2023-02-03T04:28:21.000Z
@@ browser_protocol.pdl:751 @@ experimental domain Audits
FormAriaLabelledByToNonExistingId
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
FormLabelHasNeitherForNorNestedInput
+ FormLabelForMatchesNonExistingIdError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1100268 — 2023-02-02T04:28:14.000Z
@@ browser_protocol.pdl:750 @@ experimental domain Audits
FormEmptyIdAndNameAttributesForInputError
FormAriaLabelledByToNonExistingId
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
+ FormLabelHasNeitherForNorNestedInput
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
@@ -9356,15 +9357,6 @@ experimental domain Storage
returns
array of TrustTokens tokens
- # Removes all Trust Tokens issued by the provided issuerOrigin.
- # Leaves other stored data, including the issuer's Redemption Records, intact.
- experimental command clearTrustTokens
- parameters
- string issuerOrigin
- returns
- # True if any tokens were deleted, false otherwise.
- boolean didDeleteTokens
-
# Gets details for a named interest group.
experimental command getInterestGroupDetails
parameters
Roll protocol to r1099658 — 2023-02-01T04:28:12.000Z
@@ browser_protocol.pdl:8584 @@ domain Page
ActivationFramePolicyNotCompatible
PreloadingDisabled
BatterySaverEnabled
+ ActivatedDuringMainFrameNavigation
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1099089 — 2023-01-31T04:27:53.000Z
@@ browser_protocol.pdl:749 @@ experimental domain Audits
FormAutocompleteAttributeEmptyError
FormEmptyIdAndNameAttributesForInputError
FormAriaLabelledByToNonExistingId
+ FormInputAssignedAutocompleteValueToIdOrNameAttributeError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1098258 — 2023-01-28T04:27:44.000Z
@@ browser_protocol.pdl:748 @@ experimental domain Audits
FormInputWithNoLabelError
FormAutocompleteAttributeEmptyError
FormEmptyIdAndNameAttributesForInputError
+ FormAriaLabelledByToNonExistingId
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1097787 — 2023-01-27T04:28:00.000Z
@@ browser_protocol.pdl:802 @@ experimental domain Audits
PrefixedVideoExitFullscreen
PrefixedVideoExitFullScreen
PrefixedVideoSupportsFullscreen
+ PrivacySandboxExtensionsAPI
RangeExpand
RequestedSubresourceWithEmbeddedCredentials
RTCConstraintEnableDtlsSrtpFalse
@@ -6401,6 +6402,11 @@ domain Network
# Raw response header text as it was received over the wire. The raw text may not always be
# available, such as in the case of HTTP/2 or QUIC.
optional string headersText
+ # The cookie partition key that will be used to store partitioned cookies set in this response.
+ # Only sent when partitioned cookies are enabled.
+ optional string cookiePartitionKey
+ # True if partitioned cookies are enabled, but the partition key is not serializeable to string.
+ optional boolean cookiePartitionKeyOpaque
# Fired exactly once for each Trust Token operation. Depending on
# the type of the operation and whether the operation succeeded or
@@ -8574,6 +8580,8 @@ domain Page
PrimaryMainFrameRendererProcessCrashed
PrimaryMainFrameRendererProcessKilled
ActivationFramePolicyNotCompatible
+ PreloadingDisabled
+ BatterySaverEnabled
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1097235 — 2023-01-26T04:28:05.000Z
@@ browser_protocol.pdl:747 @@ experimental domain Audits
FormDuplicateIdForInputError
FormInputWithNoLabelError
FormAutocompleteAttributeEmptyError
+ FormEmptyIdAndNameAttributesForInputError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1096618 — 2023-01-25T04:27:58.000Z
@@ browser_protocol.pdl:746 @@ experimental domain Audits
FormLabelForNameError
FormDuplicateIdForInputError
FormInputWithNoLabelError
+ FormAutocompleteAttributeEmptyError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1096014 — 2023-01-24T04:28:10.000Z
@@ browser_protocol.pdl:1273 @@ domain Browser
# substring in their name are extracted. An empty or absent query returns
# all histograms.
optional string query
- # If true, retrieve delta since last call.
+ # If true, retrieve delta since last delta call.
optional boolean delta
returns
@@ -1285,7 +1285,7 @@ domain Browser
parameters
# Requested histogram name.
string name
- # If true, retrieve delta since last call.
+ # If true, retrieve delta since last delta call.
optional boolean delta
returns
# Histogram.
Roll protocol to r1094867 — 2023-01-20T04:28:35.000Z
@@ browser_protocol.pdl:5271 @@ domain Network
# are specified in third_party/blink/renderer/core/fetch/trust_token.idl.
experimental type TrustTokenParams extends object
properties
- TrustTokenOperationType type
+ TrustTokenOperationType operation
- # Only set for "token-redemption" type and determine whether
+ # Only set for "token-redemption" operation and determine whether
# to request a fresh SRR or use a still valid cached SRR.
enum refreshPolicy
UseCached
Roll protocol to r1094278 — 2023-01-19T04:28:56.000Z
@@ browser_protocol.pdl:8569 @@ domain Page
ActivationNavigationDestroyedBeforeSuccess
TabClosedByUserGesture
TabClosedWithoutUserGesture
+ PrimaryMainFrameRendererProcessCrashed
+ PrimaryMainFrameRendererProcessKilled
+ ActivationFramePolicyNotCompatible
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1093722 — 2023-01-18T04:28:24.000Z
@@ browser_protocol.pdl:783 @@ experimental domain Audits
NoSysexWebMIDIWithoutPermission
NotificationInsecureOrigin
NotificationPermissionRequestedIframe
+ ObsoleteCreateImageBitmapImageOrientationNone
ObsoleteWebRtcCipherSuite
OpenWebDatabaseInsecureContext
OverflowVisibleOnReplacedElement
@@ -3681,7 +3682,9 @@ domain Emulation
# Missing optional values will be filled in by the target with what it would normally use.
experimental type UserAgentMetadata extends object
properties
+ # Brands appearing in Sec-CH-UA.
optional array of UserAgentBrandVersion brands
+ # Brands appearing in Sec-CH-UA-Full-Version-List.
optional array of UserAgentBrandVersion fullVersionList
deprecated optional string fullVersion
string platform
@@ -10550,6 +10553,10 @@ experimental domain WebAuthn
# https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-20210615.html#sctn-minpinlength-extension
# Defaults to false.
optional boolean hasMinPinLength
+ # If set to true, the authenticator will support the prf extension.
+ # https://w3c.github.io/webauthn/#prf-extension
+ # Defaults to false.
+ optional boolean hasPrf
# If set to true, tests of user presence will succeed immediately.
# Otherwise, they will not be resolved. Defaults to true.
optional boolean automaticPresenceSimulation
Roll protocol to r1092731 — 2023-01-14T04:27:49.000Z
@@ browser_protocol.pdl:745 @@ experimental domain Audits
CrossOriginPortalPostMessageError
FormLabelForNameError
FormDuplicateIdForInputError
+ FormInputWithNoLabelError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
Roll protocol to r1092232 — 2023-01-13T04:28:35.000Z
@@ browser_protocol.pdl:744 @@ experimental domain Audits
enum
CrossOriginPortalPostMessageError
FormLabelForNameError
+ FormDuplicateIdForInputError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
@@ -7236,6 +7237,8 @@ domain Page
usb
vertical-scroll
web-share
+ # Alias for 'window-placement' (crbug.com/1328581).
+ window-management
window-placement
xr-spatial-tracking
Roll protocol to r1090008 — 2023-01-07T04:27:59.000Z
@@ browser_protocol.pdl:843 @@ experimental domain Audits
WellKnownHttpNotFound
WellKnownNoResponse
WellKnownInvalidResponse
+ WellKnownListEmpty
ConfigNotInWellKnown
WellKnownTooBig
ConfigHttpNotFound
@@ -857,6 +858,7 @@ experimental domain Audits
AccountsHttpNotFound
AccountsNoResponse
AccountsInvalidResponse
+ AccountsListEmpty
IdTokenHttpNotFound
IdTokenNoResponse
IdTokenInvalidResponse
Roll protocol to r1089613 — 2023-01-06T04:28:04.000Z
@@ js_protocol.pdl:1741 @@ domain Runtime
event executionContextDestroyed
parameters
# Id of the destroyed context
- ExecutionContextId executionContextId
+ deprecated ExecutionContextId executionContextId
+ # Unique Id of the destroyed context
+ experimental string executionContextUniqueId
# Issued when all executionContexts were cleared in browser
event executionContextsCleared
Roll protocol to r1089107 — 2023-01-05T04:28:22.000Z
@@ browser_protocol.pdl:7218 @@ domain Page
otp-credentials
payment
picture-in-picture
+ private-aggregation
publickey-credentials-get
run-ad-auction
screen-wake-lock
serial
shared-autofill
shared-storage
+ shared-storage-select-url
smart-card
storage-access
sync-xhr
Roll protocol to r1088570 — 2023-01-04T04:27:47.000Z
@@ browser_protocol.pdl:1092 @@ domain Browser
protectedMediaIdentifier
sensors
storageAccess
+ topLevelStorageAccess
videoCapture
videoCapturePanTiltZoom
wakeLockScreen
Roll protocol to r1087818 — 2022-12-31T04:27:46.000Z
@@ browser_protocol.pdl:8555 @@ domain Page
ActivatedInBackground
EmbedderHostDisallowed
ActivationNavigationDestroyedBeforeSuccess
+ TabClosedByUserGesture
+ TabClosedWithoutUserGesture
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1087713 — 2022-12-30T04:27:43.000Z
@@ browser_protocol.pdl:5867 @@ domain Network
# Returns all browser cookies. Depending on the backend support, will return detailed cookie
# information in the `cookies` field.
- command getAllCookies
+ # Deprecated. Use Storage.getCookies instead.
+ deprecated command getAllCookies
returns
# Array of cookie objects.
array of Cookie cookies
Roll protocol to r1087487 — 2022-12-29T04:28:09.000Z
@@ js_protocol.pdl:1402 @@ domain Runtime
optional string objectGroup
# Whether to throw an exception if side effect cannot be ruled out during evaluation.
experimental optional boolean throwOnSideEffect
+ # An alternative way to specify the execution context to call function on.
+ # Compared to contextId that may be reused across processes, this is guaranteed to be
+ # system-unique, so it can be used to prevent accidental function call
+ # in context different than intended (e.g. as a result of navigation across process
+ # boundaries).
+ # This is mutually exclusive with `executionContextId`.
+ experimental optional string uniqueContextId
# 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.
Roll protocol to r1085790 — 2022-12-21T04:28:10.000Z
@@ browser_protocol.pdl:8553 @@ domain Page
ActivationNavigationParameterMismatch
ActivatedInBackground
EmbedderHostDisallowed
+ ActivationNavigationDestroyedBeforeSuccess
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1085283 — 2022-12-20T04:28:00.000Z
@@ browser_protocol.pdl:9381 @@ experimental domain Storage
parameters
string ownerOrigin
+ # Resets the budget for `ownerOrigin` by clearing all budget withdrawals.
+ experimental command resetSharedStorageBudget
+ parameters
+ string ownerOrigin
+
# Enables/disables issuing of sharedStorageAccessed events.
experimental command setSharedStorageTracking
parameters
Roll protocol to r1084670 — 2022-12-17T04:27:45.000Z
@@ browser_protocol.pdl:9723 @@ domain Target
# Whether to create the target in background or foreground (chrome-only,
# false by default).
optional boolean background
+ # Whether to create the target of type "tab".
+ experimental optional boolean forTab
returns
# The id of the page opened.
TargetID targetId
Roll protocol to r1084174 — 2022-12-16T04:27:47.000Z
@@ browser_protocol.pdl:743 @@ experimental domain Audits
type GenericIssueErrorType extends string
enum
CrossOriginPortalPostMessageError
+ FormLabelForNameError
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
@@ -750,6 +751,7 @@ experimental domain Audits
# Issues with the same errorType are aggregated in the frontend.
GenericIssueErrorType errorType
optional Page.FrameId frameId
+ optional DOM.BackendNodeId violatingNodeId
type DeprecationIssueType extends string
enum
@@ -6406,6 +6408,7 @@ domain Network
ResourceExhausted
AlreadyExists
Unavailable
+ Unauthorized
BadResponse
InternalError
UnknownError
@@ -8423,6 +8426,7 @@ domain Page
InjectedJavascript
InjectedStyleSheet
KeepaliveRequest
+ IndexedDBEvent
Dummy
AuthorizationHeader
# Disabled for RenderFrameHost reasons
Roll protocol to r1082910 — 2022-12-14T04:29:01.000Z
@@ browser_protocol.pdl:8548 @@ domain Page
SameSiteCrossOriginNavigationNotOptIn
ActivationNavigationParameterMismatch
ActivatedInBackground
+ EmbedderHostDisallowed
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1082281 — 2022-12-13T04:28:57.000Z
@@ browser_protocol.pdl:8547 @@ domain Page
SameSiteCrossOriginRedirectNotOptIn
SameSiteCrossOriginNavigationNotOptIn
ActivationNavigationParameterMismatch
+ ActivatedInBackground
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1081726 — 2022-12-10T04:28:45.000Z
@@ browser_protocol.pdl:838 @@ experimental domain Audits
enum
ShouldEmbargo
TooManyRequests
- ManifestListHttpNotFound
- ManifestListNoResponse
- ManifestListInvalidResponse
- ManifestNotInManifestList
- ManifestListTooBig
- ManifestHttpNotFound
- ManifestNoResponse
- ManifestInvalidResponse
+ WellKnownHttpNotFound
+ WellKnownNoResponse
+ WellKnownInvalidResponse
+ ConfigNotInWellKnown
+ WellKnownTooBig
+ ConfigHttpNotFound
+ ConfigNoResponse
+ ConfigInvalidResponse
ClientMetadataHttpNotFound
ClientMetadataNoResponse
ClientMetadataInvalidResponse
@@ -3897,7 +3897,6 @@ domain Emulation
experimental type DisabledImageType extends string
enum
avif
- jxl
webp
experimental command setDisabledImageTypes
@@ -7220,6 +7219,7 @@ domain Page
serial
shared-autofill
shared-storage
+ smart-card
storage-access
sync-xhr
trust-token-redemption
Roll protocol to r1081314 — 2022-12-09T04:28:47.000Z
@@ browser_protocol.pdl:9569 @@ experimental domain SystemInfo
# supported.
string commandLine
+ # Returns information about the feature state.
+ command getFeatureState
+ parameters
+ string featureState
+ returns
+ boolean featureEnabled
+
# Returns information about all running processes.
command getProcessInfo
returns
Roll protocol to r1079624 — 2022-12-06T04:28:29.000Z
@@ browser_protocol.pdl:1100 @@ domain Browser
enum
granted
denied
+ prompt
# Definition of PermissionDescriptor defined in the Permissions API:
# https://w3c.github.io/permissions/#dictdef-permissiondescriptor.
Roll protocol to r1078443 — 2022-12-02T04:28:44.000Z
@@ browser_protocol.pdl:10630 @@ experimental domain WebAuthn
AuthenticatorId authenticatorId
boolean enabled
+ # Triggered when a credential is added to an authenticator.
+ event credentialAdded
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
+ # Triggered when a credential is used in a webauthn assertion.
+ event credentialAsserted
+ parameters
+ AuthenticatorId authenticatorId
+ Credential credential
+
# This domain allows detailed inspection of media elements
experimental domain Media
Roll protocol to r1077862 — 2022-12-01T04:30:06.000Z
@@ browser_protocol.pdl:8423 @@ domain Page
InjectedStyleSheet
KeepaliveRequest
Dummy
+ AuthorizationHeader
# Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
@@ -9076,6 +9077,7 @@ experimental domain Storage
join
leave
update
+ loaded
bid
win
@@ -10011,8 +10013,8 @@ experimental domain Tracing
# total size.
optional number value
- # 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.
+ # Contains a bucket of collected trace events. When tracing is stopped collected events will be
+ # sent as a sequence of dataCollected events followed by tracingComplete event.
event dataCollected
parameters
array of object value
Roll protocol to r1075693 — 2022-11-25T04:29:29.000Z
@@ browser_protocol.pdl:1031 @@ experimental domain BackgroundService
string instanceId
# A list of event-specific information.
array of EventMetadata eventMetadata
+ # Storage key this event belongs to.
+ string storageKey
# Called with all existing backgroundServiceEvents when enabled, and all new
# events afterwards if enabled and recording.
ChromeDevTools