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 ee14676..8dad9c9 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 8dad9c9..ee14676 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 4754f17..8dad9c9 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 7a3c772..ed62263 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 0dbdc01..7a3c772 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 d4102f5..6285d9b 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.
Roll protocol to r1075032 — 2022-11-23T04:29:43.000Z
@@ browser_protocol.pdl:2099 @@ experimental domain CacheStorage
# Requests cache names.
command requestCacheNames
parameters
+ # At least and at most one of securityOrigin, storageKey must be specified.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
returns
# Caches for the security origin.
array of Cache caches
Roll protocol to r1074451 — 2022-11-22T04:30:40.000Z
@@ browser_protocol.pdl:9262 @@ experimental domain Storage
# 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
@@ -9280,6 +9286,12 @@ experimental domain Storage
# 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
@@ -9365,6 +9377,8 @@ experimental domain Storage
parameters
# Origin to update.
string origin
+ # Storage key to update.
+ string storageKey
# Name of cache in origin.
string cacheName
@@ -9373,6 +9387,8 @@ experimental domain Storage
parameters
# Origin to update.
string origin
+ # Storage key to update.
+ string storageKey
# The origin's IndexedDB object store has been modified.
event indexedDBContentUpdated
Roll protocol to r1073708 — 2022-11-19T04:30:08.000Z
@@ browser_protocol.pdl:8121 @@ domain Page
parameters
enum mode
none
- autoaccept
- autoreject
+ autoAccept
+ autoReject
+ autoOptOut
# Generates a report for testing.
experimental command generateTestReport
Roll protocol to r1072049 — 2022-11-16T04:31:33.000Z
@@ browser_protocol.pdl:482 @@ experimental domain Audits
ExcludeInvalidSameParty
ExcludeSamePartyCrossPartyContext
ExcludeDomainNonASCII
+ ExcludeThirdPartyCookieBlockedInFirstPartySet
type CookieWarningReason extends string
enum
@@ -5479,6 +5480,9 @@ domain Network
SameSiteNoneInsecure
# The cookie was not stored due to user preferences.
UserPreferences
+ # 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.
@@ -5543,6 +5547,9 @@ domain Network
SameSiteNoneInsecure
# The cookie was not sent due to user preferences.
UserPreferences
+ # 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
Roll protocol to r1070637 — 2022-11-12T04:32:08.000Z
@@ browser_protocol.pdl:2065 @@ experimental domain CacheStorage
CacheId cacheId
# Security origin of the cache.
string securityOrigin
+ # Storage key of the cache.
+ string storageKey
# The name of the cache.
string cacheName
Roll protocol to r1069585 — 2022-11-10T04:34:05.000Z
@@ browser_protocol.pdl:1076 @@ domain Browser
durableStorage
flash
geolocation
+ idleDetection
+ localFonts
midi
midiSysex
nfc
@@ -1084,11 +1086,12 @@ domain Browser
periodicBackgroundSync
protectedMediaIdentifier
sensors
+ storageAccess
videoCapture
videoCapturePanTiltZoom
- idleDetection
wakeLockScreen
wakeLockSystem
+ windowManagement
experimental type PermissionSetting extends string
enum
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index b3b97fa..6efcf78 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -458,13 +458,14 @@ domain Debugger
# New value for breakpoints active state.
boolean active
- # Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions or
- # no exceptions. Initial pause on exceptions state is `none`.
+ # Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions,
+ # or caught exceptions, no exceptions. Initial pause on exceptions state is `none`.
command setPauseOnExceptions
parameters
# Pause on exceptions mode.
enum state
none
+ caught
uncaught
all
Roll protocol to r1068969 — 2022-11-09T04:35:00.000Z
@@ browser_protocol.pdl:2237 @@ domain DOM
scrollbar-corner
resizer
input-list-button
- page-transition
- page-transition-container
- page-transition-image-wrapper
- page-transition-outgoing-image
- page-transition-incoming-image
+ view-transition
+ view-transition-group
+ view-transition-image-pair
+ view-transition-old
+ view-transition-new
# Shadow root type.
type ShadowRootType extends string
Roll protocol to r1068494 — 2022-11-08T04:34:24.000Z
@@ browser_protocol.pdl:1599 @@ experimental domain CSS
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
# CSS Supports at-rule descriptor.
experimental type CSSSupports extends object
@@ -2253,6 +2257,20 @@ domain DOM
LimitedQuirksMode
NoQuirksMode
+ # ContainerSelector physical axes
+ type PhysicalAxes extends string
+ enum
+ Horizontal
+ Vertical
+ Both
+
+ # ContainerSelector logical axes
+ type LogicalAxes extends string
+ enum
+ Inline
+ Block
+ Both
+
# 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
@@ -2865,13 +2883,16 @@ domain DOM
# Id of the node at given coordinates, only when enabled and requested document.
optional NodeId nodeId
- # Returns the container of the given node based on container query conditions.
- # If containerName is given, it will find the nearest container with a matching name;
- # otherwise it will find the nearest container regardless of its container name.
+ # 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.
experimental command getContainerForNode
parameters
NodeId nodeId
optional string containerName
+ optional PhysicalAxes physicalAxes
+ optional LogicalAxes logicalAxes
returns
# The container node for the given node, or null if not found.
optional NodeId nodeId
@@ -9300,6 +9321,16 @@ experimental domain Storage
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
Roll protocol to r1067399 — 2022-11-04T04:34:35.000Z
@@ browser_protocol.pdl:1094 @@ domain Browser
enum
granted
denied
- prompt
# Definition of PermissionDescriptor defined in the Permissions API:
# https://w3c.github.io/permissions/#dictdef-permissiondescriptor.
@@ -3942,18 +3941,10 @@ experimental domain HeadlessExperimental
optional binary screenshotData
# Disables headless events for the target.
- command disable
+ deprecated command disable
# Enables headless events for the target.
- command enable
-
- # Issued when the target starts or stops needing BeginFrames.
- # Deprecated. Issue beginFrame unconditionally instead and use result from
- # beginFrame to detect whether the frames were suppressed.
- deprecated event needsBeginFramesChanged
- parameters
- # True if BeginFrames are needed, false otherwise.
- boolean needsBeginFrames
+ deprecated command enable
# Input/Output operations for streams produced by DevTools.
domain IO
@@ -6333,6 +6324,8 @@ domain Network
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
@@ -9307,6 +9300,17 @@ experimental domain Storage
returns
array of SharedStorageEntry entries
+ # 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
+
# Enables/disables issuing of sharedStorageAccessed events.
experimental command setSharedStorageTracking
parameters
Roll protocol to r1066334 — 2022-11-02T04:46:36.000Z
@@ browser_protocol.pdl:10493 @@ experimental domain WebAuthn
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
Roll protocol to r1065144 — 2022-10-29T04:33:23.000Z
@@ browser_protocol.pdl:8359 @@ domain Page
DedicatedWorkerOrWorklet
OutstandingNetworkRequestOthers
OutstandingIndexedDBTransaction
- RequestedNotificationsPermission
RequestedMIDIPermission
RequestedAudioCapturePermission
RequestedVideoCapturePermission
Roll protocol to r1064701 — 2022-10-28T04:35:09.000Z
@@ browser_protocol.pdl:9070 @@ experimental domain Storage
array of InterestGroupAd ads
array of InterestGroupAd adComponents
+ # Enum of shared storage access types.
+ type SharedStorageAccessType extends string
+ enum
+ documentAddModule
+ documentSelectURL
+ documentRun
+ documentSet
+ documentAppend
+ documentDelete
+ documentClear
+ workletSet
+ workletAppend
+ workletDelete
+ workletClear
+ workletGet
+ workletKeys
+ workletEntries
+ workletLength
+ workletRemainingBudget
+
# Struct for a single key-value pair in an origin's shared storage.
type SharedStorageEntry extends object
properties
@@ -9083,6 +9103,58 @@ experimental domain Storage
integer length
number remainingBudget
+ # 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 SharedStorageAccessType.documentAddModule.
+ optional string scriptSourceUrl
+ # Name of the registered operation to be run.
+ # Present only for SharedStorageAccessType.documentRun and
+ # SharedStorageAccessType.documentSelectURL.
+ optional string operationName
+ # The operation's serialized data in bytes (converted to a string).
+ # Present only for SharedStorageAccessType.documentRun and
+ # SharedStorageAccessType.documentSelectURL.
+ optional string serializedData
+ # Array of candidate URLs' specs, along with any associated metadata.
+ # Present only for SharedStorageAccessType.documentSelectURL.
+ optional array of SharedStorageUrlWithMetadata urlsWithMetadata
+ # 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, and
+ # SharedStorageAccessType.workletGet.
+ 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.
+ 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.
+ optional boolean ignoreIfPresent
+
# Returns a storage key given a frame id.
command getStorageKeyForFrame
parameters
@@ -9236,6 +9308,11 @@ experimental domain Storage
returns
array of SharedStorageEntry entries
+ # Enables/disables issuing of sharedStorageAccessed events.
+ experimental command setSharedStorageTracking
+ parameters
+ boolean enable
+
# A cache's contents have been modified.
event cacheStorageContentUpdated
parameters
@@ -9278,6 +9355,22 @@ experimental domain Storage
string ownerOrigin
string name
+ # 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 Shared Storage API method invoked.
+ SharedStorageAccessType type
+ # DevTools Frame Token for the primary frame tree's root.
+ 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
+ # presence/absence depends on `type`.
+ SharedStorageAccessParams params
+
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
Roll protocol to r1064177 — 2022-10-27T04:35:18.000Z
@@ browser_protocol.pdl:7155 @@ domain Page
ch-width
clipboard-read
clipboard-write
+ compute-pressure
cross-origin-isolated
direct-sockets
display-capture
Roll protocol to r1063652 — 2022-10-26T04:39:27.000Z
@@ browser_protocol.pdl:8512 @@ domain Page
SameSiteCrossOriginNavigation
SameSiteCrossOriginRedirectNotOptIn
SameSiteCrossOriginNavigationNotOptIn
+ ActivationNavigationParameterMismatch
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1063155 — 2022-10-25T05:01:53.000Z
@@ browser_protocol.pdl:8470 @@ domain Page
Activated
Destroyed
LowEndDevice
- CrossOriginRedirect
- CrossOriginNavigation
InvalidSchemeRedirect
InvalidSchemeNavigation
InProgressNavigation
@@ -8508,6 +8506,12 @@ domain Page
InactivePageRestriction
StartFailed
TimeoutBackgrounded
+ CrossSiteRedirect
+ CrossSiteNavigation
+ SameSiteCrossOriginRedirect
+ SameSiteCrossOriginNavigation
+ SameSiteCrossOriginRedirectNotOptIn
+ SameSiteCrossOriginNavigationNotOptIn
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
@@ -9014,6 +9018,7 @@ experimental domain Storage
service_workers
cache_storage
interest_groups
+ shared_storage
all
other
@@ -9063,6 +9068,19 @@ experimental domain Storage
array of InterestGroupAd ads
array of InterestGroupAd adComponents
+ # 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
+ Network.TimeSinceEpoch creationTime
+ integer length
+ number remainingBudget
+
# Returns a storage key given a frame id.
command getStorageKeyForFrame
parameters
@@ -9202,6 +9220,20 @@ experimental domain Storage
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
+
# A cache's contents have been modified.
event cacheStorageContentUpdated
parameters
Roll protocol to r1061995 — 2022-10-21T04:47:34.000Z
@@ browser_protocol.pdl:3908 @@ experimental domain HeadlessExperimental
optional enum format
jpeg
png
+ webp
# Compression quality from range [0..100] (jpeg 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
@@ -8388,7 +8391,7 @@ domain Page
InjectedStyleSheet
KeepaliveRequest
Dummy
- # Disabled for render frame host reasons
+ # Disabled for RenderFrameHost reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
ContentSecurityHandler
ContentWebAuthenticationAPI
Roll protocol to r1061415 — 2022-10-20T04:46:58.000Z
@@ browser_protocol.pdl:7595 @@ domain Page
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
@@ -8384,6 +8386,7 @@ domain Page
OutstandingNetworkRequestDirectSocket
InjectedJavascript
InjectedStyleSheet
+ KeepaliveRequest
Dummy
# Disabled for render frame host reasons
# See content/browser/renderer_host/back_forward_cache_disable.h for explanations.
Roll protocol to r1060866 — 2022-10-19T05:00:30.000Z
@@ browser_protocol.pdl:8135 @@ domain Page
FrameId parentFrameId
# JavaScript stack trace of when frame was attached, only set if frame initiated from script.
optional Runtime.StackTrace stack
- # 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.
- # Deprecated: use Page.getAdScriptId instead.
- experimental deprecated optional AdScriptId adScriptId
# Fired when frame no longer has a scheduled navigation.
deprecated event frameClearedScheduledNavigation
Roll protocol to r1059612 — 2022-10-15T04:53:37.000Z
@@ browser_protocol.pdl:7682 @@ domain Page
# Recommendation for manifest's id attribute to match current id computed from start_url
optional string recommendedId
+ experimental command getAdScriptId
+ 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
+
# 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.
@@ -8129,7 +8137,8 @@ domain Page
optional Runtime.StackTrace stack
# 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.
- experimental optional AdScriptId adScriptId
+ # Deprecated: use Page.getAdScriptId instead.
+ experimental deprecated optional AdScriptId adScriptId
# Fired when frame no longer has a scheduled navigation.
deprecated event frameClearedScheduledNavigation
Roll protocol to r1059094 — 2022-10-14T04:59:20.000Z
@@ browser_protocol.pdl:9945 @@ domain Fetch
optional string method
# If set, overrides the post data in the request.
optional binary postData
- # If set, overrides the request headers.
+ # 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
Roll protocol to r1057312 — 2022-10-11T04:55:46.000Z
@@ js_protocol.pdl:918 @@ domain Profiler
# Functions contained in the script that has coverage data.
array of FunctionCoverage functions
- # Describes a type collected during runtime.
- experimental type TypeObject extends object
- properties
- # Name of a type collected with type profiling.
- string name
-
- # Source offset and types for a parameter or return value.
- experimental type TypeProfileEntry extends object
- properties
- # Source offset of the parameter or end of function for return values.
- integer offset
- # The types for this parameter or return value.
- array of TypeObject types
-
- # Type profile data collected during runtime for a JavaScript script.
- experimental type ScriptTypeProfile extends object
- properties
- # JavaScript script id.
- Runtime.ScriptId scriptId
- # JavaScript script name or url.
- string url
- # Type profile entries for parameters and return values of the functions in the script.
- array of TypeProfileEntry entries
-
command disable
command enable
@@ -976,9 +952,6 @@ domain Profiler
# Monotonically increasing time (in seconds) when the coverage update was taken in the backend.
number timestamp
- # Enable type profile.
- experimental command startTypeProfile
-
command stop
returns
# Recorded profile.
@@ -988,9 +961,6 @@ domain Profiler
# executing optimized code.
command stopPreciseCoverage
- # Disable type profile. Disabling releases type profile data collected so far.
- experimental command stopTypeProfile
-
# Collect coverage data for the current isolate, and resets execution counters. Precise code
# coverage needs to have started.
command takePreciseCoverage
@@ -1000,12 +970,6 @@ domain Profiler
# Monotonically increasing time (in seconds) when the coverage update was taken in the backend.
number timestamp
- # Collect type profile.
- experimental command takeTypeProfile
- returns
- # Type profile for all scripts since startTypeProfile() was turned on.
- array of ScriptTypeProfile result
-
event consoleProfileFinished
parameters
string id
Roll protocol to r1056733 — 2022-10-09T04:46:56.000Z
@@ browser_protocol.pdl:5277 @@ domain Network
# HTTPS DNS protocol upgrade job won a race with a normal connection and
# an Alternate Protocol job.
dnsAlpnH3JobWonRace
- # When the reason is unspecified.
+ # This value is used when the reason is unknown.
unspecifiedReason
# HTTP response data.
Roll protocol to r1056622 — 2022-10-08T04:34:15.000Z
@@ browser_protocol.pdl:10036 @@ domain Fetch
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 RequestId networkId
+ 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.
Roll protocol to r1055599 — 2022-10-06T04:34:37.000Z
@@ browser_protocol.pdl:7166 @@ domain Page
geolocation
gyroscope
hid
- identity-credential-get
+ identity-credentials-get
idle-detection
interest-cohort
join-ad-interest-group
@@ -7682,8 +7682,9 @@ domain Page
# Recommendation for manifest's id attribute to match current id computed from start_url
optional string recommendedId
- # Returns all browser cookies. Depending on the backend support, will return detailed cookie
- # information in the `cookies` field.
+ # 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
Roll protocol to r1055124 — 2022-10-05T04:35:05.000Z
@@ browser_protocol.pdl:8495 @@ domain Page
ActivatedBeforeStarted
InactivePageRestriction
StartFailed
+ TimeoutBackgrounded
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1052822 — 2022-09-29T04:58:25.000Z
@@ browser_protocol.pdl:5256 @@ domain Network
# 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
+ # When the reason is unspecified.
+ unspecifiedReason
+
# HTTP response data.
type Response extends object
properties
@@ -5301,6 +5325,8 @@ domain Network
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.
@@ -7106,6 +7132,7 @@ domain Page
ch-downlink
ch-ect
ch-prefers-color-scheme
+ ch-prefers-reduced-motion
ch-rtt
ch-save-data
ch-ua
@@ -7132,7 +7159,6 @@ domain Page
encrypted-media
execution-while-out-of-viewport
execution-while-not-rendered
- federated-credentials
focus-without-user-activation
fullscreen
frobulate
@@ -7140,6 +7166,7 @@ domain Page
geolocation
gyroscope
hid
+ identity-credential-get
idle-detection
interest-cohort
join-ad-interest-group
Roll protocol to r1052219 — 2022-09-28T04:58:58.000Z
@@ browser_protocol.pdl:1 @@ @@ -1,4 +1,4 @@
-# Copyright 2017 The Chromium Authors. All rights reserved.
+# 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.
#
@@ -775,8 +775,6 @@ experimental domain Audits
LocalCSSFileExtensionRejected
MediaSourceAbortRemove
MediaSourceDurationTruncatingBuffered
- NavigateEventRestoreScroll
- NavigateEventTransitionWhile
NoSysexWebMIDIWithoutPermission
NotificationInsecureOrigin
NotificationPermissionRequestedIframe
@@ -784,6 +782,7 @@ experimental domain Audits
OpenWebDatabaseInsecureContext
OverflowVisibleOnReplacedElement
PaymentInstruments
+ PaymentRequestCSPViolation
PersistentQuotaType
PictureSourceSrc
PrefixedCancelAnimationFrame
@@ -9361,6 +9360,9 @@ domain Target
# 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 "portal" or "prerender".
+ experimental optional string subtype
# A filter used by target query/discovery/auto-attach operations.
experimental type FilterEntry extends object
Roll protocol to r1051614 — 2022-09-27T04:54:05.000Z
@@ browser_protocol.pdl:783 @@ experimental domain Audits
ObsoleteWebRtcCipherSuite
OpenWebDatabaseInsecureContext
OverflowVisibleOnReplacedElement
+ PaymentInstruments
PersistentQuotaType
PictureSourceSrc
PrefixedCancelAnimationFrame
Roll protocol to r1049481 — 2022-09-21T04:59:07.000Z
@@ browser_protocol.pdl:8466 @@ domain Page
DataSaverEnabled
HasEffectiveUrl
ActivatedBeforeStarted
+ InactivePageRestriction
+ StartFailed
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1048947 — 2022-09-20T04:57:57.000Z
@@ browser_protocol.pdl:8458 @@ domain Page
AudioOutputDeviceRequested
MixedContent
TriggerBackgrounded
- EmbedderTriggeredAndSameOriginRedirected
EmbedderTriggeredAndCrossOriginRedirected
MemoryLimitExceeded
# Prerenders can be cancelled when Chrome uses excessive memory. This is
diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
index 8d8211b..2d56043 100644
--- a/pdl/js_protocol.pdl
+++ b/pdl/js_protocol.pdl
@@ -766,6 +766,22 @@ experimental domain HeapProfiler
# Average sample interval in bytes. Poisson distribution is used for the intervals. The
# default value is 32768 bytes.
optional number samplingInterval
+ # By default, the sampling heap profiler reports only objects which are
+ # still alive when the profile is returned via getSamplingProfile or
+ # stopSampling, which is useful for determining what functions contribute
+ # the most to steady-state memory usage. This flag instructs the sampling
+ # heap profiler to also include information about objects discarded by
+ # major GC, which will show which functions cause large temporary memory
+ # usage or long GC pauses.
+ optional boolean includeObjectsCollectedByMajorGC
+ # By default, the sampling heap profiler reports only objects which are
+ # still alive when the profile is returned via getSamplingProfile or
+ # stopSampling, which is useful for determining what functions contribute
+ # the most to steady-state memory usage. This flag instructs the sampling
+ # heap profiler to also include information about objects discarded by
+ # minor GC, which is useful when tuning a latency-sensitive application
+ # for minimal GC activity.
+ optional boolean includeObjectsCollectedByMinorGC
command startTrackingHeapObjects
parameters
Roll protocol to r1048352 — 2022-09-17T04:46:41.000Z
@@ browser_protocol.pdl:772 @@ experimental domain Audits
HostCandidateAttributeGetter
IdentityInCanMakePaymentEvent
InsecurePrivateNetworkSubresourceRequest
- LegacyConstraintGoogIPv6
LocalCSSFileExtensionRejected
MediaSourceAbortRemove
MediaSourceDurationTruncatingBuffered
Roll protocol to r1047822 — 2022-09-16T04:59:17.000Z
@@ browser_protocol.pdl:8467 @@ domain Page
FailToGetMemoryUsage
DataSaverEnabled
HasEffectiveUrl
+ ActivatedBeforeStarted
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1046751 — 2022-09-14T04:56:53.000Z
@@ browser_protocol.pdl:8475 @@ domain Page
FrameId initiatingFrameId
string prerenderingUrl
PrerenderFinalStatus finalStatus
- # This is used to give users more information about the cancellation details,
- # and this will be formatted for display.
- optional string reasonDetails
+ # 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
event loadEventFired
parameters
Roll protocol to r1045489 — 2022-09-10T04:51:55.000Z
@@ browser_protocol.pdl:701 @@ experimental domain Audits
type AttributionReportingIssueType extends string
enum
PermissionPolicyDisabled
+ PermissionPolicyNotDelegated
UntrustworthyReportingOrigin
InsecureContext
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
Roll protocol to r1044932 — 2022-09-09T04:49:16.000Z
@@ browser_protocol.pdl:2926 @@ domain DOM
parameters
# Id of the node that has changed.
NodeId parentNodeId
- # If of the previous siblint.
+ # Id of the previous sibling.
NodeId previousNodeId
# Inserted node data.
Node node
Roll protocol to r1040073 — 2022-08-27T04:44:13.000Z
@@ browser_protocol.pdl:835 @@ experimental domain Audits
# all cases except for success.
type FederatedAuthRequestIssueReason extends string
enum
- ApprovalDeclined
+ ShouldEmbargo
TooManyRequests
ManifestListHttpNotFound
ManifestListNoResponse
@@ -860,6 +860,7 @@ experimental domain Audits
IdTokenInvalidRequest
ErrorIdToken
Canceled
+ RpPageNotVisible
# This issue tracks client hints related issues. It's used to deprecate old
# features, encourage the use of new ones, and provide general guidance.
Roll protocol to r1039585 — 2022-08-26T04:57:38.000Z
@@ browser_protocol.pdl:8464 @@ domain Page
# recorded when it fails to get the memory usage.
FailToGetMemoryUsage
DataSaverEnabled
+ HasEffectiveUrl
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1036444 — 2022-08-18T04:47:13.000Z
@@ browser_protocol.pdl:7156 @@ domain Page
serial
shared-autofill
shared-storage
- storage-access-api
+ storage-access
sync-xhr
trust-token-redemption
unload
Roll protocol to r1034970 — 2022-08-15T04:47:01.000Z
@@ browser_protocol.pdl:8459 @@ domain Page
TriggerBackgrounded
EmbedderTriggeredAndSameOriginRedirected
EmbedderTriggeredAndCrossOriginRedirected
- EmbedderTriggeredAndDestroyed
MemoryLimitExceeded
# Prerenders can be cancelled when Chrome uses excessive memory. This is
# recorded when it fails to get the memory usage.
FailToGetMemoryUsage
+ DataSaverEnabled
# Fired when a prerender attempt is completed.
experimental event prerenderAttemptCompleted
Roll protocol to r1034791 — 2022-08-13T04:31:31.000Z
@@ browser_protocol.pdl:1537 @@ experimental domain CSS
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
Roll protocol to r1033355 — 2022-08-10T04:31:04.000Z
@@ browser_protocol.pdl:7156 @@ domain Page
storage-access-api
sync-xhr
trust-token-redemption
+ unload
usb
vertical-scroll
web-share
Roll protocol to r1032873 — 2022-08-09T04:34:16.000Z
@@ browser_protocol.pdl:709 @@ experimental domain Audits
InvalidEligibleHeader
TooManyConcurrentRequests
SourceAndTriggerHeaders
+ SourceIgnored
+ TriggerIgnored
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
Roll protocol to r1032240 — 2022-08-06T04:31:26.000Z
@@ browser_protocol.pdl:708 @@ experimental domain Audits
InvalidRegisterTriggerHeader
InvalidEligibleHeader
TooManyConcurrentRequests
+ SourceAndTriggerHeaders
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
@@ -8459,12 +8460,15 @@ domain Page
FailToGetMemoryUsage
# Fired when a prerender attempt is completed.
- event prerenderAttemptCompleted
+ 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 cancellation details,
+ # and this will be formatted for display.
+ optional string reasonDetails
event loadEventFired
parameters
Roll protocol to r1031356 — 2022-08-04T04:34:29.000Z
@@ browser_protocol.pdl:845 @@ experimental domain Audits
ClientMetadataHttpNotFound
ClientMetadataNoResponse
ClientMetadataInvalidResponse
- ClientMetadataMissingPrivacyPolicyUrl
DisabledInSettings
ErrorFetchingSignin
InvalidSigninResponse
Roll protocol to r1030896 — 2022-08-03T04:47:29.000Z
@@ browser_protocol.pdl:481 @@ experimental domain Audits
ExcludeSameSiteStrict
ExcludeInvalidSameParty
ExcludeSamePartyCrossPartyContext
+ ExcludeDomainNonASCII
type CookieWarningReason extends string
enum
@@ -493,6 +494,7 @@ experimental domain Audits
WarnSameSiteLaxCrossDowngradeStrict
WarnSameSiteLaxCrossDowngradeLax
WarnAttributeValueExceedsMaxSize
+ WarnDomainNonASCII
type CookieOperation extends string
enum
@@ -4181,8 +4183,11 @@ 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.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
returns
# Database names for origin.
array of string databaseNames
Roll protocol to r1030398 — 2022-08-02T04:50:11.000Z
@@ browser_protocol.pdl:705 @@ experimental domain Audits
InvalidHeader
InvalidRegisterTriggerHeader
InvalidEligibleHeader
+ TooManyConcurrentRequests
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
Roll protocol to r1030018 — 2022-07-30T04:33:35.000Z
@@ browser_protocol.pdl:9091 @@ experimental domain Storage
# 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
@@ -9103,6 +9109,12 @@ experimental domain Storage
# 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
@@ -9150,6 +9162,8 @@ experimental domain Storage
parameters
# Origin to update.
string origin
+ # Storage key to update.
+ string storageKey
# Database to update.
string databaseName
# ObjectStore to update.
@@ -9160,6 +9174,8 @@ experimental domain Storage
parameters
# Origin to update.
string origin
+ # Storage key to update.
+ string storageKey
# One of the interest groups was accessed by the associated page.
event interestGroupAccessed
@@ -9330,13 +9346,16 @@ domain Target
experimental type FilterEntry extends object
properties
# If set, causes exclusion of mathcing targets from the list.
- # The remainder of filter entries in the filter arrat are ignored.
optional boolean exclude
# If not present, matches any type.
optional string type
- # If filter is not specified, the one assumed is [{type: "browser", exclude: true}, {}]
- # (i.e. include everything but browser).
+ # 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
Roll protocol to r1029622 — 2022-07-29T04:36:32.000Z
@@ browser_protocol.pdl:9326 @@ domain Target
experimental optional Page.FrameId openerFrameId
experimental optional Browser.BrowserContextID browserContextId
+ # 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.
+ # The remainder of filter entries in the filter arrat are ignored.
+ optional boolean exclude
+ # If not present, matches any type.
+ optional string type
+
+ # If filter is not specified, the one assumed is [{type: "browser", exclude: true}, {}]
+ # (i.e. include everything but browser).
+ experimental type TargetFilter extends array of FilterEntry
+
experimental type RemoteLocation extends object
properties
string host
@@ -9389,7 +9402,6 @@ domain Target
# 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
-
returns
# The id of the context created.
Browser.BrowserContextID browserContextId
@@ -9446,6 +9458,11 @@ domain Target
# 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
@@ -9477,6 +9494,8 @@ domain Target
# We plan to make this the default, deprecate non-flattened mode,
# and eventually retire it. See crbug.com/991325.
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
@@ -9489,6 +9508,8 @@ domain Target
# 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.
@@ -9496,6 +9517,9 @@ domain Target
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`.
Roll protocol to r1029085 — 2022-07-28T04:34:38.000Z
@@ browser_protocol.pdl:699 @@ experimental domain Audits
type AttributionReportingIssueType extends string
enum
PermissionPolicyDisabled
- # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
- AttributionSourceUntrustworthyOrigin
- # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
- AttributionUntrustworthyOrigin
UntrustworthyReportingOrigin
InsecureContext
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
InvalidHeader
InvalidRegisterTriggerHeader
+ InvalidEligibleHeader
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
properties
AttributionReportingIssueType violationType
- # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
- optional AffectedFrame frame
optional AffectedRequest request
optional DOM.BackendNodeId violatingNodeId
optional string invalidParameter
@@ -4125,8 +4120,11 @@ 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.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
# Database name.
string databaseName
# Object store name.
@@ -4168,8 +4166,11 @@ 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.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
# Database name.
string databaseName
returns
Roll protocol to r1028580 — 2022-07-27T04:39:00.000Z
@@ browser_protocol.pdl:782 @@ experimental domain Audits
ObsoleteWebRtcCipherSuite
OpenWebDatabaseInsecureContext
OverflowVisibleOnReplacedElement
+ PersistentQuotaType
PictureSourceSrc
PrefixedCancelAnimationFrame
PrefixedRequestAnimationFrame
@@ -4105,7 +4106,11 @@ experimental domain IndexedDB
# Delete a range of entries from an object store
command deleteObjectStoreEntries
parameters
- string securityOrigin
+ # At least and at most one of securityOrigin, storageKey must be specified.
+ # Security origin.
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
string databaseName
string objectStoreName
# Range of entry keys to delete
@@ -4143,8 +4148,11 @@ experimental domain IndexedDB
# Gets metadata of an object store
command getMetadata
parameters
+ # At least and at most one of securityOrigin, storageKey must be specified.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
# Database name.
string databaseName
# Object store name.
Roll protocol to r1028116 — 2022-07-26T04:49:26.000Z
@@ browser_protocol.pdl:699 @@ experimental domain Audits
type AttributionReportingIssueType extends string
enum
PermissionPolicyDisabled
+ # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
AttributionSourceUntrustworthyOrigin
+ # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
AttributionUntrustworthyOrigin
+ UntrustworthyReportingOrigin
+ InsecureContext
+ # TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
InvalidHeader
+ InvalidRegisterTriggerHeader
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
properties
AttributionReportingIssueType violationType
+ # TODO(apaseltiner): Remove this once it is no longer referenced by the frontend.
optional AffectedFrame frame
optional AffectedRequest request
optional DOM.BackendNodeId violatingNodeId
@@ -4074,8 +4081,11 @@ 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.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
# Database name.
string databaseName
# Object store name.
@@ -4084,8 +4094,11 @@ experimental domain IndexedDB
# Deletes a database.
command deleteDatabase
parameters
+ # At least and at most one of securityOrigin, storageKey must be specified.
# Security origin.
- string securityOrigin
+ optional string securityOrigin
+ # Storage key.
+ optional string storageKey
# Database name.
string databaseName
@@ -8426,6 +8439,10 @@ domain Page
EmbedderTriggeredAndSameOriginRedirected
EmbedderTriggeredAndCrossOriginRedirected
EmbedderTriggeredAndDestroyed
+ MemoryLimitExceeded
+ # Prerenders can be cancelled when Chrome uses excessive memory. This is
+ # recorded when it fails to get the memory usage.
+ FailToGetMemoryUsage
# Fired when a prerender attempt is completed.
event prerenderAttemptCompleted
Roll protocol to r1027518 — 2022-07-23T04:32:37.000Z
@@ js_protocol.pdl:261 @@ domain Debugger
optional string streamId
# The total number of lines in the disassembly text.
integer totalNumberOfLines
- # The offsets of all function bodies plus one additional entry pointing
- # one by past the end of the last function.
+ # The offsets of all function bodies, in the format [start1, end1,
+ # start2, end2, ...] where all ends are exclusive.
array of integer functionBodyOffsets
# The first chunk of disassembly.
WasmDisassemblyChunk chunk
ChromeDevTools