Add Brave CDP automation, replace Oracle browser mode

Connects to user's running Brave via Chrome DevTools Protocol
to automate ChatGPT interaction. Uses puppeteer-core to open a
tab, send the prompt, wait for response, and extract the result.

No cookies, no separate profiles, no copy/paste. Just connects
to the browser where the user is already logged in.

One-time setup: relaunch Brave with --remote-debugging-port=9222

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Taylor Eernisse
2026-02-07 16:16:41 -05:00
parent d776a266a8
commit e7882b917b
4163 changed files with 782828 additions and 148 deletions

View File

@@ -0,0 +1,57 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
version
major 1
minor 3
include domains/Accessibility.pdl
include domains/Animation.pdl
include domains/Audits.pdl
include domains/Autofill.pdl
include domains/BackgroundService.pdl
include domains/BluetoothEmulation.pdl
include domains/Browser.pdl
include domains/CSS.pdl
include domains/CacheStorage.pdl
include domains/Cast.pdl
include domains/DOM.pdl
include domains/DOMDebugger.pdl
include domains/DOMSnapshot.pdl
include domains/DOMStorage.pdl
include domains/DeviceAccess.pdl
include domains/DeviceOrientation.pdl
include domains/Emulation.pdl
include domains/EventBreakpoints.pdl
include domains/Extensions.pdl
include domains/FedCm.pdl
include domains/Fetch.pdl
include domains/FileSystem.pdl
include domains/HeadlessExperimental.pdl
include domains/IO.pdl
include domains/IndexedDB.pdl
include domains/Input.pdl
include domains/Inspector.pdl
include domains/LayerTree.pdl
include domains/Log.pdl
include domains/Media.pdl
include domains/Memory.pdl
include domains/Network.pdl
include domains/Overlay.pdl
include domains/PWA.pdl
include domains/Page.pdl
include domains/Performance.pdl
include domains/PerformanceTimeline.pdl
include domains/Preload.pdl
include domains/Security.pdl
include domains/ServiceWorker.pdl
include domains/Storage.pdl
include domains/SystemInfo.pdl
include domains/Target.pdl
include domains/Tethering.pdl
include domains/Tracing.pdl
include domains/WebAudio.pdl
include domains/WebAuthn.pdl

View File

@@ -0,0 +1,310 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Accessibility
depends on DOM
# Unique accessibility node identifier.
type AXNodeId extends string
# Enum of possible property types.
type AXValueType extends string
enum
boolean
tristate
booleanOrUndefined
idref
idrefList
integer
node
nodeList
number
string
computedString
token
tokenList
domRelation
role
internalRole
valueUndefined
# Enum of possible property sources.
type AXValueSourceType extends string
enum
attribute
implicit
style
contents
placeholder
relatedElement
# Enum of possible native property sources (as a subtype of a particular AXValueSourceType).
type AXValueNativeSourceType extends string
enum
description
figcaption
label
labelfor
labelwrapped
legend
rubyannotation
tablecaption
title
other
# A single source for a computed AX property.
type AXValueSource extends object
properties
# What type of source this is.
AXValueSourceType type
# The value of this property source.
optional AXValue value
# The name of the relevant attribute, if any.
optional string attribute
# The value of the relevant attribute, if any.
optional AXValue attributeValue
# Whether this source is superseded by a higher priority source.
optional boolean superseded
# The native markup source for this value, e.g. a `<label>` element.
optional AXValueNativeSourceType nativeSource
# The value, such as a node or node list, of the native source.
optional AXValue nativeSourceValue
# Whether the value for this property is invalid.
optional boolean invalid
# Reason for the value being invalid, if it is.
optional string invalidReason
type AXRelatedNode extends object
properties
# The BackendNodeId of the related DOM node.
DOM.BackendNodeId backendDOMNodeId
# The IDRef value provided, if any.
optional string idref
# The text alternative of this node in the current context.
optional string text
type AXProperty extends object
properties
# The name of this property.
AXPropertyName name
# The value of this property.
AXValue value
# A single computed AX property.
type AXValue extends object
properties
# The type of this value.
AXValueType type
# The computed value of this property.
optional any value
# One or more related nodes, if applicable.
optional array of AXRelatedNode relatedNodes
# The sources which contributed to the computation of this property.
optional array of AXValueSource sources
# Values of AXProperty name:
# - from 'busy' to 'roledescription': states which apply to every AX node
# - from 'live' to 'root': attributes which apply to nodes in live regions
# - from 'autocomplete' to 'valuetext': attributes which apply to widgets
# - from 'checked' to 'selected': states which apply to widgets
# - from 'activedescendant' to 'owns': relationships between elements other than parent/child/sibling
# - from 'activeFullscreenElement' to 'uninteresting': reasons why this noode is hidden
type AXPropertyName extends string
enum
actions
busy
disabled
editable
focusable
focused
hidden
hiddenRoot
invalid
keyshortcuts
settable
roledescription
live
atomic
relevant
root
autocomplete
hasPopup
level
multiselectable
orientation
multiline
readonly
required
valuemin
valuemax
valuetext
checked
expanded
modal
pressed
selected
activedescendant
controls
describedby
details
errormessage
flowto
labelledby
owns
url
# LINT.IfChange(AXIgnoredReason)
activeFullscreenElement
activeModalDialog
activeAriaModalDialog
ariaHiddenElement
ariaHiddenSubtree
emptyAlt
emptyText
inertElement
inertSubtree
labelContainer
labelFor
notRendered
notVisible
presentationalRole
probablyPresentational
inactiveCarouselTabContent
uninteresting
# LINT.ThenChange(//third_party/blink/renderer/modules/accessibility/ax_enums.cc:AXIgnoredReason)
# A node in the accessibility tree.
type AXNode extends object
properties
# Unique identifier for this node.
AXNodeId nodeId
# Whether this node is ignored for accessibility
boolean ignored
# Collection of reasons why this node is hidden.
optional array of AXProperty ignoredReasons
# This `Node`'s role, whether explicit or implicit.
optional AXValue role
# This `Node`'s Chrome raw role.
optional AXValue chromeRole
# The accessible name for this `Node`.
optional AXValue name
# The accessible description for this `Node`.
optional AXValue description
# The value for this `Node`.
optional AXValue value
# All other properties
optional array of AXProperty properties
# ID for this node's parent.
optional AXNodeId parentId
# IDs for each of this node's child nodes.
optional array of AXNodeId childIds
# The backend ID for the associated DOM node, if any.
optional DOM.BackendNodeId backendDOMNodeId
# The frame ID for the frame associated with this nodes document.
optional Page.FrameId frameId
# Disables the accessibility domain.
command disable
# Enables the accessibility domain which causes `AXNodeId`s to remain consistent between method calls.
# This turns on accessibility for the page, which can impact performance until accessibility is disabled.
command enable
# Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
experimental command getPartialAXTree
parameters
# Identifier of the node to get the partial accessibility tree for.
optional DOM.NodeId nodeId
# Identifier of the backend node to get the partial accessibility tree for.
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node wrapper to get the partial accessibility tree for.
optional Runtime.RemoteObjectId objectId
# Whether to fetch this node's ancestors, siblings and children. Defaults to true.
optional boolean fetchRelatives
returns
# The `Accessibility.AXNode` for this DOM node, if it exists, plus its ancestors, siblings and
# children, if requested.
array of AXNode nodes
# Fetches the entire accessibility tree for the root Document
experimental command getFullAXTree
parameters
# The maximum depth at which descendants of the root node should be retrieved.
# If omitted, the full tree is returned.
optional integer depth
# The frame for whose document the AX tree should be retrieved.
# If omitted, the root frame is used.
optional Page.FrameId frameId
returns
array of AXNode nodes
# Fetches the root node.
# Requires `enable()` to have been called previously.
experimental command getRootAXNode
parameters
# The frame in whose document the node resides.
# If omitted, the root frame is used.
optional Page.FrameId frameId
returns
AXNode node
# Fetches a node and all ancestors up to and including the root.
# Requires `enable()` to have been called previously.
experimental command getAXNodeAndAncestors
parameters
# Identifier of the node to get.
optional DOM.NodeId nodeId
# Identifier of the backend node to get.
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node wrapper to get.
optional Runtime.RemoteObjectId objectId
returns
array of AXNode nodes
# Fetches a particular accessibility node by AXNodeId.
# Requires `enable()` to have been called previously.
experimental command getChildAXNodes
parameters
AXNodeId id
# The frame in whose document the node resides.
# If omitted, the root frame is used.
optional Page.FrameId frameId
returns
array of AXNode nodes
# Query a DOM node's accessibility subtree for accessible name and role.
# This command computes the name and role for all nodes in the subtree, including those that are
# ignored for accessibility, and returns those that match the specified name and role. If no DOM
# node is specified, or the DOM node does not exist, the command returns an error. If neither
# `accessibleName` or `role` is specified, it returns all the accessibility nodes in the subtree.
experimental command queryAXTree
parameters
# Identifier of the node for the root to query.
optional DOM.NodeId nodeId
# Identifier of the backend node for the root to query.
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node wrapper for the root to query.
optional Runtime.RemoteObjectId objectId
# Find nodes with this computed name.
optional string accessibleName
# Find nodes with this computed role.
optional string role
returns
# A list of `Accessibility.AXNode` matching the specified attributes,
# including nodes that are ignored for accessibility.
array of AXNode nodes
# The loadComplete event mirrors the load complete event sent by the browser to assistive
# technology when the web page has finished loading.
experimental event loadComplete
parameters
# New document root node.
AXNode root
# The nodesUpdated event is sent every time a previously requested node has changed the in tree.
experimental event nodesUpdated
parameters
# Updated node data.
array of AXNode nodes

View File

@@ -0,0 +1,195 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Animation
depends on Runtime
depends on DOM
# Animation instance.
type Animation extends object
properties
# `Animation`'s id.
string id
# `Animation`'s name.
string name
# `Animation`'s internal paused state.
boolean pausedState
# `Animation`'s play state.
string playState
# `Animation`'s playback rate.
number playbackRate
# `Animation`'s start time.
# Milliseconds for time based animations and
# percentage [0 - 100] for scroll driven animations
# (i.e. when viewOrScrollTimeline exists).
number startTime
# `Animation`'s current time.
number currentTime
# Animation type of `Animation`.
enum type
CSSTransition
CSSAnimation
WebAnimation
# `Animation`'s source animation node.
optional AnimationEffect source
# A unique ID for `Animation` representing the sources that triggered this CSS
# animation/transition.
optional string cssId
# View or scroll timeline
optional ViewOrScrollTimeline viewOrScrollTimeline
# Timeline instance
type ViewOrScrollTimeline extends object
properties
# Scroll container node
optional DOM.BackendNodeId sourceNodeId
# Represents the starting scroll position of the timeline
# as a length offset in pixels from scroll origin.
optional number startOffset
# Represents the ending scroll position of the timeline
# as a length offset in pixels from scroll origin.
optional number endOffset
# The element whose principal box's visibility in the
# scrollport defined the progress of the timeline.
# Does not exist for animations with ScrollTimeline
optional DOM.BackendNodeId subjectNodeId
# Orientation of the scroll
DOM.ScrollOrientation axis
# AnimationEffect instance
type AnimationEffect extends object
properties
# `AnimationEffect`'s delay.
number delay
# `AnimationEffect`'s end delay.
number endDelay
# `AnimationEffect`'s iteration start.
number iterationStart
# `AnimationEffect`'s iterations. Omitted if the value is infinite.
optional number iterations
# `AnimationEffect`'s iteration duration.
# Milliseconds for time based animations and
# percentage [0 - 100] for scroll driven animations
# (i.e. when viewOrScrollTimeline exists).
number duration
# `AnimationEffect`'s playback direction.
string direction
# `AnimationEffect`'s fill mode.
string fill
# `AnimationEffect`'s target node.
optional DOM.BackendNodeId backendNodeId
# `AnimationEffect`'s keyframes.
optional KeyframesRule keyframesRule
# `AnimationEffect`'s timing function.
string easing
# Keyframes Rule
type KeyframesRule extends object
properties
# CSS keyframed animation's name.
optional string name
# List of animation keyframes.
array of KeyframeStyle keyframes
# Keyframe Style
type KeyframeStyle extends object
properties
# Keyframe's time offset.
string offset
# `AnimationEffect`'s timing function.
string easing
# Disables animation domain notifications.
command disable
# Enables animation domain notifications.
command enable
# Returns the current time of the an animation.
command getCurrentTime
parameters
# Id of animation.
string id
returns
# Current time of the page.
number currentTime
# Gets the playback rate of the document timeline.
command getPlaybackRate
returns
# Playback rate for animations on page.
number playbackRate
# Releases a set of animations to no longer be manipulated.
command releaseAnimations
parameters
# List of animation ids to seek.
array of string animations
# Gets the remote object of the Animation.
command resolveAnimation
parameters
# Animation id.
string animationId
returns
# Corresponding remote object.
Runtime.RemoteObject remoteObject
# Seek a set of animations to a particular time within each animation.
command seekAnimations
parameters
# List of animation ids to seek.
array of string animations
# Set the current time of each animation.
number currentTime
# Sets the paused state of a set of animations.
command setPaused
parameters
# Animations to set the pause state of.
array of string animations
# Paused state to set to.
boolean paused
# Sets the playback rate of the document timeline.
command setPlaybackRate
parameters
# Playback rate for animations on page
number playbackRate
# Sets the timing of an animation node.
command setTiming
parameters
# Animation id.
string animationId
# Duration of the animation.
number duration
# Delay of the animation.
number delay
# Event for when an animation has been cancelled.
event animationCanceled
parameters
# Id of the animation that was cancelled.
string id
# Event for each animation that has been created.
event animationCreated
parameters
# Id of the animation that was created.
string id
# Event for animation that has been started.
event animationStarted
parameters
# Animation that was started.
Animation animation
# Event for animation that has been updated.
event animationUpdated
parameters
# Animation that was updated.
Animation animation

808
node_modules/devtools-protocol/pdl/domains/Audits.pdl generated vendored Normal file
View File

@@ -0,0 +1,808 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Audits domain allows investigation of page violations and possible improvements.
experimental domain Audits
depends on Network
# Information about a cookie that is affected by an inspector issue.
type AffectedCookie extends object
properties
# The following three properties uniquely identify a cookie
string name
string path
string domain
# Information about a request that is affected by an inspector issue.
type AffectedRequest extends object
properties
# The unique request id.
optional Network.RequestId requestId
string url
# Information about the frame affected by an inspector issue.
type AffectedFrame extends object
properties
Page.FrameId frameId
type CookieExclusionReason extends string
enum
ExcludeSameSiteUnspecifiedTreatedAsLax
ExcludeSameSiteNoneInsecure
ExcludeSameSiteLax
ExcludeSameSiteStrict
ExcludeInvalidSameParty
ExcludeSamePartyCrossPartyContext
ExcludeDomainNonASCII
ExcludeThirdPartyCookieBlockedInFirstPartySet
ExcludeThirdPartyPhaseout
ExcludePortMismatch
ExcludeSchemeMismatch
type CookieWarningReason extends string
enum
WarnSameSiteUnspecifiedCrossSiteContext
WarnSameSiteNoneInsecure
WarnSameSiteUnspecifiedLaxAllowUnsafe
WarnSameSiteStrictLaxDowngradeStrict
WarnSameSiteStrictCrossDowngradeStrict
WarnSameSiteStrictCrossDowngradeLax
WarnSameSiteLaxCrossDowngradeStrict
WarnSameSiteLaxCrossDowngradeLax
WarnAttributeValueExceedsMaxSize
WarnDomainNonASCII
WarnThirdPartyPhaseout
WarnCrossSiteRedirectDowngradeChangesInclusion
WarnDeprecationTrialMetadata
WarnThirdPartyCookieHeuristic
type CookieOperation extends string
enum
SetCookie
ReadCookie
# Represents the category of insight that a cookie issue falls under.
type InsightType extends string
enum
# Cookie domain has an entry in third-party cookie migration readiness
# list:
# https://github.com/privacysandbox/privacy-sandbox-dev-support/blob/main/3pc-migration-readiness.md
GitHubResource
# Cookie is exempted due to a grace period:
# https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
GracePeriod
# Cookie is exempted due a heuristics-based exemptiuon:
# https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/heuristics-based-exception
Heuristics
# Information about the suggested solution to a cookie issue.
type CookieIssueInsight extends object
properties
InsightType type
# Link to table entry in third-party cookie migration readiness list.
optional string tableEntryUrl
# This information is currently necessary, as the front-end has a difficult
# time finding a specific cookie. With this, we can convey specific error
# information without the cookie.
type CookieIssueDetails extends object
properties
# If AffectedCookie is not set then rawCookieLine contains the raw
# Set-Cookie header string. This hints at a problem where the
# cookie line is syntactically or semantically malformed in a way
# that no valid cookie could be created.
optional AffectedCookie cookie
optional string rawCookieLine
array of CookieWarningReason cookieWarningReasons
array of CookieExclusionReason cookieExclusionReasons
# Optionally identifies the site-for-cookies and the cookie url, which
# may be used by the front-end as additional context.
CookieOperation operation
optional string siteForCookies
optional string cookieUrl
optional AffectedRequest request
# The recommended solution to the issue.
optional CookieIssueInsight insight
type MixedContentResolutionStatus extends string
enum
MixedContentBlocked
MixedContentAutomaticallyUpgraded
MixedContentWarning
type MixedContentResourceType extends string
enum
AttributionSrc
Audio
Beacon
CSPReport
Download
EventSource
Favicon
Font
Form
Frame
Image
Import
JSON
Manifest
Ping
PluginData
PluginResource
Prefetch
Resource
Script
ServiceWorker
SharedWorker
SpeculationRules
Stylesheet
Track
Video
Worker
XMLHttpRequest
XSLT
type MixedContentIssueDetails extends object
properties
# The type of resource causing the mixed content issue (css, js, iframe,
# form,...). Marked as optional because it is mapped to from
# blink::mojom::RequestContextType, which will be replaced
# by network::mojom::RequestDestination
optional MixedContentResourceType resourceType
# The way the mixed content issue is being resolved.
MixedContentResolutionStatus resolutionStatus
# The unsafe http url causing the mixed content issue.
string insecureURL
# The url responsible for the call to an unsafe url.
string mainResourceURL
# The mixed content request.
# Does not always exist (e.g. for unsafe form submission urls).
optional AffectedRequest request
# Optional because not every mixed content issue is necessarily linked to a frame.
optional AffectedFrame frame
# Enum indicating the reason a response has been blocked. These reasons are
# refinements of the net error BLOCKED_BY_RESPONSE.
type BlockedByResponseReason extends string
enum
CoepFrameResourceNeedsCoepHeader
CoopSandboxedIFrameCannotNavigateToCoopPage
CorpNotSameOrigin
CorpNotSameOriginAfterDefaultedToSameOriginByCoep
CorpNotSameOriginAfterDefaultedToSameOriginByDip
CorpNotSameOriginAfterDefaultedToSameOriginByCoepAndDip
CorpNotSameSite
SRIMessageSignatureMismatch
# Details for a request that has been blocked with the BLOCKED_BY_RESPONSE
# code. Currently only used for COEP/COOP, but may be extended to include
# some CSP errors in the future.
type BlockedByResponseIssueDetails extends object
properties
AffectedRequest request
optional AffectedFrame parentFrame
optional AffectedFrame blockedFrame
BlockedByResponseReason reason
type HeavyAdResolutionStatus extends string
enum
HeavyAdBlocked
HeavyAdWarning
type HeavyAdReason extends string
enum
NetworkTotalLimit
CpuTotalLimit
CpuPeakLimit
type HeavyAdIssueDetails extends object
properties
# The resolution status, either blocking the content or warning.
HeavyAdResolutionStatus resolution
# The reason the ad was blocked, total network or cpu or peak cpu.
HeavyAdReason reason
# The frame that was blocked.
AffectedFrame frame
type ContentSecurityPolicyViolationType extends string
enum
kInlineViolation
kEvalViolation
kURLViolation
kSRIViolation
kTrustedTypesSinkViolation
kTrustedTypesPolicyViolation
kWasmEvalViolation
type SourceCodeLocation extends object
properties
optional Runtime.ScriptId scriptId
string url
integer lineNumber
integer columnNumber
type ContentSecurityPolicyIssueDetails extends object
properties
# The url not included in allowed sources.
optional string blockedURL
# Specific directive that is violated, causing the CSP issue.
string violatedDirective
boolean isReportOnly
ContentSecurityPolicyViolationType contentSecurityPolicyViolationType
optional AffectedFrame frameAncestor
optional SourceCodeLocation sourceCodeLocation
optional DOM.BackendNodeId violatingNodeId
type SharedArrayBufferIssueType extends string
enum
TransferIssue
CreationIssue
# Details for a issue arising from an SAB being instantiated in, or
# transferred to a context that is not cross-origin isolated.
type SharedArrayBufferIssueDetails extends object
properties
SourceCodeLocation sourceCodeLocation
boolean isWarning
SharedArrayBufferIssueType type
type LowTextContrastIssueDetails extends object
properties
DOM.BackendNodeId violatingNodeId
string violatingNodeSelector
number contrastRatio
number thresholdAA
number thresholdAAA
string fontSize
string fontWeight
# Details for a CORS related issue, e.g. a warning or error related to
# CORS RFC1918 enforcement.
type CorsIssueDetails extends object
properties
Network.CorsErrorStatus corsErrorStatus
boolean isWarning
AffectedRequest request
optional SourceCodeLocation location
optional string initiatorOrigin
optional Network.IPAddressSpace resourceIPAddressSpace
optional Network.ClientSecurityState clientSecurityState
type AttributionReportingIssueType extends string
enum
PermissionPolicyDisabled
UntrustworthyReportingOrigin
InsecureContext
# TODO(apaseltiner): Rename this to InvalidRegisterSourceHeader
InvalidHeader
InvalidRegisterTriggerHeader
SourceAndTriggerHeaders
SourceIgnored
TriggerIgnored
OsSourceIgnored
OsTriggerIgnored
InvalidRegisterOsSourceHeader
InvalidRegisterOsTriggerHeader
WebAndOsHeaders
NoWebOrOsSupport
NavigationRegistrationWithoutTransientUserActivation
InvalidInfoHeader
NoRegisterSourceHeader
NoRegisterTriggerHeader
NoRegisterOsSourceHeader
NoRegisterOsTriggerHeader
NavigationRegistrationUniqueScopeAlreadySet
type SharedDictionaryError extends string
enum
UseErrorCrossOriginNoCorsRequest
UseErrorDictionaryLoadFailure
UseErrorMatchingDictionaryNotUsed
UseErrorUnexpectedContentDictionaryHeader
WriteErrorCossOriginNoCorsRequest
WriteErrorDisallowedBySettings
WriteErrorExpiredResponse
WriteErrorFeatureDisabled
WriteErrorInsufficientResources
WriteErrorInvalidMatchField
WriteErrorInvalidStructuredHeader
WriteErrorInvalidTTLField
WriteErrorNavigationRequest
WriteErrorNoMatchField
WriteErrorNonIntegerTTLField
WriteErrorNonListMatchDestField
WriteErrorNonSecureContext
WriteErrorNonStringIdField
WriteErrorNonStringInMatchDestList
WriteErrorNonStringMatchField
WriteErrorNonTokenTypeField
WriteErrorRequestAborted
WriteErrorShuttingDown
WriteErrorTooLongIdField
WriteErrorUnsupportedType
type SRIMessageSignatureError extends string
enum
MissingSignatureHeader
MissingSignatureInputHeader
InvalidSignatureHeader
InvalidSignatureInputHeader
SignatureHeaderValueIsNotByteSequence
SignatureHeaderValueIsParameterized
SignatureHeaderValueIsIncorrectLength
SignatureInputHeaderMissingLabel
SignatureInputHeaderValueNotInnerList
SignatureInputHeaderValueMissingComponents
SignatureInputHeaderInvalidComponentType
SignatureInputHeaderInvalidComponentName
SignatureInputHeaderInvalidHeaderComponentParameter
SignatureInputHeaderInvalidDerivedComponentParameter
SignatureInputHeaderKeyIdLength
SignatureInputHeaderInvalidParameter
SignatureInputHeaderMissingRequiredParameters
ValidationFailedSignatureExpired
ValidationFailedInvalidLength
ValidationFailedSignatureMismatch
ValidationFailedIntegrityMismatch
type UnencodedDigestError extends string
enum
MalformedDictionary
UnknownAlgorithm
IncorrectDigestType
IncorrectDigestLength
# Details for issues around "Attribution Reporting API" usage.
# Explainer: https://github.com/WICG/attribution-reporting-api
type AttributionReportingIssueDetails extends object
properties
AttributionReportingIssueType violationType
optional AffectedRequest request
optional DOM.BackendNodeId violatingNodeId
optional string invalidParameter
# Details for issues about documents in Quirks Mode
# or Limited Quirks Mode that affects page layouting.
type QuirksModeIssueDetails extends object
properties
# If false, it means the document's mode is "quirks"
# instead of "limited-quirks".
boolean isLimitedQuirksMode
DOM.BackendNodeId documentNodeId
string url
Page.FrameId frameId
Network.LoaderId loaderId
deprecated type NavigatorUserAgentIssueDetails extends object
properties
string url
optional SourceCodeLocation location
type SharedDictionaryIssueDetails extends object
properties
SharedDictionaryError sharedDictionaryError
AffectedRequest request
type SRIMessageSignatureIssueDetails extends object
properties
SRIMessageSignatureError error
string signatureBase
array of string integrityAssertions
AffectedRequest request
type UnencodedDigestIssueDetails extends object
properties
UnencodedDigestError error
AffectedRequest request
type GenericIssueErrorType extends string
enum
FormLabelForNameError
FormDuplicateIdForInputError
FormInputWithNoLabelError
FormAutocompleteAttributeEmptyError
FormEmptyIdAndNameAttributesForInputError
FormAriaLabelledByToNonExistingIdError
FormInputAssignedAutocompleteValueToIdOrNameAttributeError
FormLabelHasNeitherForNorNestedInputError
FormLabelForMatchesNonExistingIdError
FormInputHasWrongButWellIntendedAutocompleteValueError
ResponseWasBlockedByORB
NavigationEntryMarkedSkippable
AutofillAndManualTextPolicyControlledFeaturesInfo
AutofillPolicyControlledFeatureInfo
ManualTextPolicyControlledFeatureInfo
# Depending on the concrete errorType, different properties are set.
type GenericIssueDetails extends object
properties
# Issues with the same errorType are aggregated in the frontend.
GenericIssueErrorType errorType
optional Page.FrameId frameId
optional DOM.BackendNodeId violatingNodeId
optional string violatingNodeAttribute
optional AffectedRequest request
# This issue tracks information needed to print a deprecation message.
# https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/third_party/blink/renderer/core/frame/deprecation/README.md
type DeprecationIssueDetails extends object
properties
optional AffectedFrame affectedFrame
SourceCodeLocation sourceCodeLocation
# One of the deprecation names from third_party/blink/renderer/core/frame/deprecation/deprecation.json5
string type
# This issue warns about sites in the redirect chain of a finished navigation
# that may be flagged as trackers and have their state cleared if they don't
# receive a user interaction. Note that in this context 'site' means eTLD+1.
# For example, if the URL `https://example.test:80/bounce` was in the
# redirect chain, the site reported would be `example.test`.
type BounceTrackingIssueDetails extends object
properties
array of string trackingSites
# This issue warns about third-party sites that are accessing cookies on the
# current page, and have been permitted due to having a global metadata grant.
# Note that in this context 'site' means eTLD+1. For example, if the URL
# `https://example.test:80/web_page` was accessing cookies, the site reported
# would be `example.test`.
type CookieDeprecationMetadataIssueDetails extends object
properties
array of string allowedSites
number optOutPercentage
boolean isOptOutTopLevel
CookieOperation operation
type ClientHintIssueReason extends string
enum
# Items in the accept-ch meta tag allow list must be valid origins.
# No special values (e.g. self, none, and *) are permitted.
MetaTagAllowListInvalidOrigin
# Only accept-ch meta tags in the original HTML sent from the server
# are respected. Any injected via javascript (or other means) are ignored.
MetaTagModifiedHTML
type FederatedAuthRequestIssueDetails extends object
properties
FederatedAuthRequestIssueReason federatedAuthRequestIssueReason
# Represents the failure reason when a federated authentication reason fails.
# Should be updated alongside RequestIdTokenStatus in
# third_party/blink/public/mojom/devtools/inspector_issue.mojom to include
# all cases except for success.
type FederatedAuthRequestIssueReason extends string
enum
ShouldEmbargo
TooManyRequests
WellKnownHttpNotFound
WellKnownNoResponse
WellKnownInvalidResponse
WellKnownListEmpty
WellKnownInvalidContentType
ConfigNotInWellKnown
WellKnownTooBig
ConfigHttpNotFound
ConfigNoResponse
ConfigInvalidResponse
ConfigInvalidContentType
ClientMetadataHttpNotFound
ClientMetadataNoResponse
ClientMetadataInvalidResponse
ClientMetadataInvalidContentType
IdpNotPotentiallyTrustworthy
DisabledInSettings
DisabledInFlags
ErrorFetchingSignin
InvalidSigninResponse
AccountsHttpNotFound
AccountsNoResponse
AccountsInvalidResponse
AccountsListEmpty
AccountsInvalidContentType
IdTokenHttpNotFound
IdTokenNoResponse
IdTokenInvalidResponse
IdTokenIdpErrorResponse
IdTokenCrossSiteIdpErrorResponse
IdTokenInvalidRequest
IdTokenInvalidContentType
ErrorIdToken
Canceled
RpPageNotVisible
SilentMediationFailure
ThirdPartyCookiesBlocked
NotSignedInWithIdp
MissingTransientUserActivation
ReplacedByActiveMode
InvalidFieldsSpecified
RelyingPartyOriginIsOpaque
TypeNotMatching
UiDismissedNoEmbargo
CorsError
SuppressedBySegmentationPlatform
type FederatedAuthUserInfoRequestIssueDetails extends object
properties
FederatedAuthUserInfoRequestIssueReason federatedAuthUserInfoRequestIssueReason
# Represents the failure reason when a getUserInfo() call fails.
# Should be updated alongside FederatedAuthUserInfoRequestResult in
# third_party/blink/public/mojom/devtools/inspector_issue.mojom.
type FederatedAuthUserInfoRequestIssueReason extends string
enum
NotSameOrigin
NotIframe
NotPotentiallyTrustworthy
NoApiPermission
NotSignedInWithIdp
NoAccountSharingPermission
InvalidConfigOrWellKnown
InvalidAccountsResponse
NoReturningUserFromFetchedAccounts
# This issue tracks client hints related issues. It's used to deprecate old
# features, encourage the use of new ones, and provide general guidance.
type ClientHintIssueDetails extends object
properties
SourceCodeLocation sourceCodeLocation
ClientHintIssueReason clientHintIssueReason
type FailedRequestInfo extends object
properties
# The URL that failed to load.
string url
# The failure message for the failed request.
string failureMessage
optional Network.RequestId requestId
type PartitioningBlobURLInfo extends string
enum
BlockedCrossPartitionFetching
EnforceNoopenerForNavigation
type PartitioningBlobURLIssueDetails extends object
properties
# The BlobURL that failed to load.
string url
# Additional information about the Partitioning Blob URL issue.
PartitioningBlobURLInfo partitioningBlobURLInfo
type ElementAccessibilityIssueReason extends string
enum
DisallowedSelectChild
DisallowedOptGroupChild
NonPhrasingContentOptionChild
InteractiveContentOptionChild
InteractiveContentLegendChild
InteractiveContentSummaryDescendant
# This issue warns about errors in the select or summary element content model.
type ElementAccessibilityIssueDetails extends object
properties
DOM.BackendNodeId nodeId
ElementAccessibilityIssueReason elementAccessibilityIssueReason
boolean hasDisallowedAttributes
type StyleSheetLoadingIssueReason extends string
enum
LateImportRule
RequestFailed
# This issue warns when a referenced stylesheet couldn't be loaded.
type StylesheetLoadingIssueDetails extends object
properties
# Source code position that referenced the failing stylesheet.
SourceCodeLocation sourceCodeLocation
# Reason why the stylesheet couldn't be loaded.
StyleSheetLoadingIssueReason styleSheetLoadingIssueReason
# Contains additional info when the failure was due to a request.
optional FailedRequestInfo failedRequestInfo
type PropertyRuleIssueReason extends string
enum
InvalidSyntax
InvalidInitialValue
InvalidInherits
InvalidName
# This issue warns about errors in property rules that lead to property
# registrations being ignored.
type PropertyRuleIssueDetails extends object
properties
# Source code position of the property rule.
SourceCodeLocation sourceCodeLocation
# Reason why the property rule was discarded.
PropertyRuleIssueReason propertyRuleIssueReason
# The value of the property rule property that failed to parse
optional string propertyValue
type UserReidentificationIssueType extends string
enum
BlockedFrameNavigation
BlockedSubresource
NoisedCanvasReadback
# This issue warns about uses of APIs that may be considered misuse to
# re-identify users.
type UserReidentificationIssueDetails extends object
properties
UserReidentificationIssueType type
# Applies to BlockedFrameNavigation and BlockedSubresource issue types.
optional AffectedRequest request
# Applies to NoisedCanvasReadback issue type.
optional SourceCodeLocation sourceCodeLocation
type PermissionElementIssueType extends string
enum
InvalidType
FencedFrameDisallowed
CspFrameAncestorsMissing
PermissionsPolicyBlocked
PaddingRightUnsupported
PaddingBottomUnsupported
InsetBoxShadowUnsupported
RequestInProgress
UntrustedEvent
RegistrationFailed
TypeNotSupported
InvalidTypeActivation
SecurityChecksFailed
ActivationDisabled
GeolocationDeprecated
InvalidDisplayStyle
NonOpaqueColor
LowContrast
FontSizeTooSmall
FontSizeTooLarge
InvalidSizeValue
# This issue warns about improper usage of the <permission> element.
type PermissionElementIssueDetails extends object
properties
PermissionElementIssueType issueType
# The value of the type attribute.
optional string type
# The node ID of the <permission> element.
optional DOM.BackendNodeId nodeId
# True if the issue is a warning, false if it is an error.
optional boolean isWarning
# Fields for message construction:
# Used for messages that reference a specific permission name
optional string permissionName
# Used for messages about occlusion
optional string occluderNodeInfo
# Used for messages about occluder's parent
optional string occluderParentNodeInfo
# Used for messages about activation disabled reason
optional string disableReason
# A unique identifier for the type of issue. Each type may use one of the
# optional fields in InspectorIssueDetails to convey more specific
# information about the kind of issue.
type InspectorIssueCode extends string
enum
CookieIssue
MixedContentIssue
BlockedByResponseIssue
HeavyAdIssue
ContentSecurityPolicyIssue
SharedArrayBufferIssue
LowTextContrastIssue
CorsIssue
AttributionReportingIssue
QuirksModeIssue
PartitioningBlobURLIssue
# Deprecated
NavigatorUserAgentIssue
GenericIssue
DeprecationIssue
ClientHintIssue
FederatedAuthRequestIssue
BounceTrackingIssue
CookieDeprecationMetadataIssue
StylesheetLoadingIssue
FederatedAuthUserInfoRequestIssue
PropertyRuleIssue
SharedDictionaryIssue
ElementAccessibilityIssue
SRIMessageSignatureIssue
UnencodedDigestIssue
UserReidentificationIssue
PermissionElementIssue
# This struct holds a list of optional fields with additional information
# specific to the kind of issue. When adding a new issue code, please also
# add a new optional field to this type.
type InspectorIssueDetails extends object
properties
optional CookieIssueDetails cookieIssueDetails
optional MixedContentIssueDetails mixedContentIssueDetails
optional BlockedByResponseIssueDetails blockedByResponseIssueDetails
optional HeavyAdIssueDetails heavyAdIssueDetails
optional ContentSecurityPolicyIssueDetails contentSecurityPolicyIssueDetails
optional SharedArrayBufferIssueDetails sharedArrayBufferIssueDetails
optional LowTextContrastIssueDetails lowTextContrastIssueDetails
optional CorsIssueDetails corsIssueDetails
optional AttributionReportingIssueDetails attributionReportingIssueDetails
optional QuirksModeIssueDetails quirksModeIssueDetails
optional PartitioningBlobURLIssueDetails partitioningBlobURLIssueDetails
deprecated optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
optional GenericIssueDetails genericIssueDetails
optional DeprecationIssueDetails deprecationIssueDetails
optional ClientHintIssueDetails clientHintIssueDetails
optional FederatedAuthRequestIssueDetails federatedAuthRequestIssueDetails
optional BounceTrackingIssueDetails bounceTrackingIssueDetails
optional CookieDeprecationMetadataIssueDetails cookieDeprecationMetadataIssueDetails
optional StylesheetLoadingIssueDetails stylesheetLoadingIssueDetails
optional PropertyRuleIssueDetails propertyRuleIssueDetails
optional FederatedAuthUserInfoRequestIssueDetails federatedAuthUserInfoRequestIssueDetails
optional SharedDictionaryIssueDetails sharedDictionaryIssueDetails
optional ElementAccessibilityIssueDetails elementAccessibilityIssueDetails
optional SRIMessageSignatureIssueDetails sriMessageSignatureIssueDetails
optional UnencodedDigestIssueDetails unencodedDigestIssueDetails
optional UserReidentificationIssueDetails userReidentificationIssueDetails
optional PermissionElementIssueDetails permissionElementIssueDetails
# A unique id for a DevTools inspector issue. Allows other entities (e.g.
# exceptions, CDP message, console messages, etc.) to reference an issue.
type IssueId extends string
# An inspector issue reported from the back-end.
type InspectorIssue extends object
properties
InspectorIssueCode code
InspectorIssueDetails details
# A unique id for this issue. May be omitted if no other entity (e.g.
# exception, CDP message, etc.) is referencing this issue.
optional IssueId issueId
# Returns the response body and size if it were re-encoded with the specified settings. Only
# applies to images.
command getEncodedResponse
parameters
# Identifier of the network request to get content for.
Network.RequestId requestId
# The encoding to use.
enum encoding
webp
jpeg
png
# The quality of the encoding (0-1). (defaults to 1)
optional number quality
# Whether to only return the size information (defaults to false).
optional boolean sizeOnly
returns
# The encoded body as a base64 string. Omitted if sizeOnly is true.
optional binary body
# Size before re-encoding.
integer originalSize
# Size after re-encoding.
integer encodedSize
# Disables issues domain, prevents further issues from being reported to the client.
command disable
# Enables issues domain, sends the issues collected so far to the client by means of the
# `issueAdded` event.
command enable
# Runs the contrast check for the target page. Found issues are reported
# using Audits.issueAdded event.
command checkContrast
parameters
# Whether to report WCAG AAA level issues. Default is false.
optional boolean reportAAA
# Runs the form issues check for the target page. Found issues are reported
# using Audits.issueAdded event.
command checkFormsIssues
returns
array of GenericIssueDetails formIssues
event issueAdded
parameters
InspectorIssue issue

110
node_modules/devtools-protocol/pdl/domains/Autofill.pdl generated vendored Normal file
View File

@@ -0,0 +1,110 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Defines commands and events for Autofill.
experimental domain Autofill
type CreditCard extends object
properties
# 16-digit credit card number.
string number
# Name of the credit card owner.
string name
# 2-digit expiry month.
string expiryMonth
# 4-digit expiry year.
string expiryYear
# 3-digit card verification code.
string cvc
type AddressField extends object
properties
# address field name, for example GIVEN_NAME.
# The full list of supported field names:
# https://source.chromium.org/chromium/chromium/src/+/main:components/autofill/core/browser/field_types.cc;l=38
string name
# address field value, for example Jon Doe.
string value
# A list of address fields.
type AddressFields extends object
properties
array of AddressField fields
type Address extends object
properties
# fields and values defining an address.
array of AddressField fields
# Defines how an address can be displayed like in chrome://settings/addresses.
# Address UI is a two dimensional array, each inner array is an "address information line", and when rendered in a UI surface should be displayed as such.
# The following address UI for instance:
# [[{name: "GIVE_NAME", value: "Jon"}, {name: "FAMILY_NAME", value: "Doe"}], [{name: "CITY", value: "Munich"}, {name: "ZIP", value: "81456"}]]
# should allow the receiver to render:
# Jon Doe
# Munich 81456
type AddressUI extends object
properties
# A two dimension array containing the representation of values from an address profile.
array of AddressFields addressFields
# Specified whether a filled field was done so by using the html autocomplete attribute or autofill heuristics.
type FillingStrategy extends string
enum
autocompleteAttribute
autofillInferred
type FilledField extends object
properties
# The type of the field, e.g text, password etc.
string htmlType
# the html id
string id
# the html name
string name
# the field value
string value
# The actual field type, e.g FAMILY_NAME
string autofillType
# The filling strategy
FillingStrategy fillingStrategy
# The frame the field belongs to
Page.FrameId frameId
# The form field's DOM node
DOM.BackendNodeId fieldId
# Emitted when an address form is filled.
event addressFormFilled
parameters
# Information about the fields that were filled
array of FilledField filledFields
# An UI representation of the address used to fill the form.
# Consists of a 2D array where each child represents an address/profile line.
AddressUI addressUi
# Trigger autofill on a form identified by the fieldId.
# If the field and related form cannot be autofilled, returns an error.
command trigger
parameters
# Identifies a field that serves as an anchor for autofill.
DOM.BackendNodeId fieldId
# Identifies the frame that field belongs to.
optional Page.FrameId frameId
# Credit card information to fill out the form. Credit card data is not saved. Mutually exclusive with `address`.
optional CreditCard card
# Address to fill out the form. Address data is not saved. Mutually exclusive with `card`.
optional Address address
# Set addresses so that developers can verify their forms implementation.
command setAddresses
# Test addresses for the available countries.
parameters
array of Address addresses
# Disables autofill domain notifications.
command disable
# Enables autofill domain notifications.
command enable

View File

@@ -0,0 +1,77 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Defines events for background web platform features.
experimental domain BackgroundService
# The Background Service that will be associated with the commands/events.
# Every Background Service operates independently, but they share the same
# API.
type ServiceName extends string
enum
backgroundFetch
backgroundSync
pushMessaging
notifications
paymentHandler
periodicBackgroundSync
# Enables event updates for the service.
command startObserving
parameters
ServiceName service
# Disables event updates for the service.
command stopObserving
parameters
ServiceName service
# Set the recording state for the service.
command setRecording
parameters
boolean shouldRecord
ServiceName service
# Clears all stored data for the service.
command clearEvents
parameters
ServiceName service
# Called when the recording state for the service has been updated.
event recordingStateChanged
parameters
boolean isRecording
ServiceName service
# A key-value pair for additional event information to pass along.
type EventMetadata extends object
properties
string key
string value
type BackgroundServiceEvent extends object
properties
# Timestamp of the event (in seconds).
Network.TimeSinceEpoch timestamp
# The origin this event belongs to.
string origin
# The Service Worker ID that initiated the event.
ServiceWorker.RegistrationID serviceWorkerRegistrationId
# The Background Service this event belongs to.
ServiceName service
# A description of the event.
string eventName
# An identifier that groups related events together.
string instanceId
# A list of event-specific information.
array of EventMetadata eventMetadata
# Storage key this event belongs to.
string storageKey
# Called with all existing backgroundServiceEvents when enabled, and all new
# events afterwards if enabled and recording.
event backgroundServiceEventReceived
parameters
BackgroundServiceEvent backgroundServiceEvent

View File

@@ -0,0 +1,227 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows configuring virtual Bluetooth devices to test
# the web-bluetooth API.
experimental domain BluetoothEmulation
# Indicates the various states of Central.
type CentralState extends string
enum
absent
powered-off
powered-on
# Indicates the various types of GATT event.
type GATTOperationType extends string
enum
connection
discovery
# Indicates the various types of characteristic write.
type CharacteristicWriteType extends string
enum
write-default-deprecated
write-with-response
write-without-response
# Indicates the various types of characteristic operation.
type CharacteristicOperationType extends string
enum
read
write
subscribe-to-notifications
unsubscribe-from-notifications
# Indicates the various types of descriptor operation.
type DescriptorOperationType extends string
enum
read
write
# Stores the manufacturer data
type ManufacturerData extends object
properties
# Company identifier
# https://bitbucket.org/bluetooth-SIG/public/src/main/assigned_numbers/company_identifiers/company_identifiers.yaml
# https://usb.org/developers
integer key
# Manufacturer-specific data
binary data
# Stores the byte data of the advertisement packet sent by a Bluetooth device.
type ScanRecord extends object
properties
optional string name
optional array of string uuids
# Stores the external appearance description of the device.
optional integer appearance
# Stores the transmission power of a broadcasting device.
optional integer txPower
# Key is the company identifier and the value is an array of bytes of
# manufacturer specific data.
optional array of ManufacturerData manufacturerData
# Stores the advertisement packet information that is sent by a Bluetooth device.
type ScanEntry extends object
properties
string deviceAddress
integer rssi
ScanRecord scanRecord
# Describes the properties of a characteristic. This follows Bluetooth Core
# Specification BT 4.2 Vol 3 Part G 3.3.1. Characteristic Properties.
type CharacteristicProperties extends object
properties
optional boolean broadcast
optional boolean read
optional boolean writeWithoutResponse
optional boolean write
optional boolean notify
optional boolean indicate
optional boolean authenticatedSignedWrites
optional boolean extendedProperties
# Enable the BluetoothEmulation domain.
command enable
parameters
# State of the simulated central.
CentralState state
# If the simulated central supports low-energy.
boolean leSupported
# Set the state of the simulated central.
command setSimulatedCentralState
parameters
# State of the simulated central.
CentralState state
# Disable the BluetoothEmulation domain.
command disable
# Simulates a peripheral with |address|, |name| and |knownServiceUuids|
# that has already been connected to the system.
command simulatePreconnectedPeripheral
parameters
string address
string name
array of ManufacturerData manufacturerData
array of string knownServiceUuids
# Simulates an advertisement packet described in |entry| being received by
# the central.
command simulateAdvertisement
parameters
ScanEntry entry
# Simulates the response code from the peripheral with |address| for a
# GATT operation of |type|. The |code| value follows the HCI Error Codes from
# Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
command simulateGATTOperationResponse
parameters
string address
GATTOperationType type
integer code
# Simulates the response from the characteristic with |characteristicId| for a
# characteristic operation of |type|. The |code| value follows the Error
# Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
# The |data| is expected to exist when simulating a successful read operation
# response.
command simulateCharacteristicOperationResponse
parameters
string characteristicId
CharacteristicOperationType type
integer code
optional binary data
# Simulates the response from the descriptor with |descriptorId| for a
# descriptor operation of |type|. The |code| value follows the Error
# Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
# The |data| is expected to exist when simulating a successful read operation
# response.
command simulateDescriptorOperationResponse
parameters
string descriptorId
DescriptorOperationType type
integer code
optional binary data
# Adds a service with |serviceUuid| to the peripheral with |address|.
command addService
parameters
string address
string serviceUuid
returns
# An identifier that uniquely represents this service.
string serviceId
# Removes the service respresented by |serviceId| from the simulated central.
command removeService
parameters
string serviceId
# Adds a characteristic with |characteristicUuid| and |properties| to the
# service represented by |serviceId|.
command addCharacteristic
parameters
string serviceId
string characteristicUuid
CharacteristicProperties properties
returns
# An identifier that uniquely represents this characteristic.
string characteristicId
# Removes the characteristic respresented by |characteristicId| from the
# simulated central.
command removeCharacteristic
parameters
string characteristicId
# Adds a descriptor with |descriptorUuid| to the characteristic respresented
# by |characteristicId|.
command addDescriptor
parameters
string characteristicId
string descriptorUuid
returns
# An identifier that uniquely represents this descriptor.
string descriptorId
# Removes the descriptor with |descriptorId| from the simulated central.
command removeDescriptor
parameters
string descriptorId
# Simulates a GATT disconnection from the peripheral with |address|.
command simulateGATTDisconnection
parameters
string address
# Event for when a GATT operation of |type| to the peripheral with |address|
# happened.
event gattOperationReceived
parameters
string address
GATTOperationType type
# Event for when a characteristic operation of |type| to the characteristic
# respresented by |characteristicId| happened. |data| and |writeType| is
# expected to exist when |type| is write.
event characteristicOperationReceived
parameters
string characteristicId
CharacteristicOperationType type
optional binary data
optional CharacteristicWriteType writeType
# Event for when a descriptor operation of |type| to the descriptor
# respresented by |descriptorId| happened. |data| is expected to exist when
# |type| is write.
event descriptorOperationReceived
parameters
string descriptorId
DescriptorOperationType type
optional binary data

352
node_modules/devtools-protocol/pdl/domains/Browser.pdl generated vendored Normal file
View File

@@ -0,0 +1,352 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# The Browser domain defines methods and events for browser managing.
domain Browser
experimental type BrowserContextID extends string
experimental type WindowID extends integer
# The state of the browser window.
experimental type WindowState extends string
enum
normal
minimized
maximized
fullscreen
# Browser window bounds information
experimental type Bounds extends object
properties
# The offset from the left edge of the screen to the window in pixels.
optional integer left
# The offset from the top edge of the screen to the window in pixels.
optional integer top
# The window width in pixels.
optional integer width
# The window height in pixels.
optional integer height
# The window state. Default to normal.
optional WindowState windowState
experimental type PermissionType extends string
enum
ar
audioCapture
automaticFullscreen
backgroundFetch
backgroundSync
cameraPanTiltZoom
capturedSurfaceControl
clipboardReadWrite
clipboardSanitizedWrite
displayCapture
durableStorage
geolocation
handTracking
idleDetection
keyboardLock
localFonts
localNetwork
localNetworkAccess
loopbackNetwork
midi
midiSysex
nfc
notifications
paymentHandler
periodicBackgroundSync
pointerLock
protectedMediaIdentifier
sensors
smartCard
speakerSelection
storageAccess
topLevelStorageAccess
videoCapture
vr
wakeLockScreen
wakeLockSystem
webAppInstallation
webPrinting
windowManagement
experimental type PermissionSetting extends string
enum
granted
denied
prompt
# Definition of PermissionDescriptor defined in the Permissions API:
# https://w3c.github.io/permissions/#dom-permissiondescriptor.
experimental type PermissionDescriptor extends object
properties
# Name of permission.
# See https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/permissions/permission_descriptor.idl for valid permission names.
string name
# For "midi" permission, may also specify sysex control.
optional boolean sysex
# For "push" permission, may specify userVisibleOnly.
# Note that userVisibleOnly = true is the only currently supported type.
optional boolean userVisibleOnly
# For "clipboard" permission, may specify allowWithoutSanitization.
optional boolean allowWithoutSanitization
# For "fullscreen" permission, must specify allowWithoutGesture:true.
optional boolean allowWithoutGesture
# For "camera" permission, may specify panTiltZoom.
optional boolean panTiltZoom
# Browser command ids used by executeBrowserCommand.
experimental type BrowserCommandId extends string
enum
openTabSearch
closeTabSearch
openGlic
# Set permission settings for given embedding and embedded origins.
experimental command setPermission
parameters
# Descriptor of permission to override.
PermissionDescriptor permission
# Setting of the permission.
PermissionSetting setting
# Embedding origin the permission applies to, all origins if not specified.
optional string origin
# Embedded origin the permission applies to. It is ignored unless the embedding origin is
# present and valid. If the embedding origin is provided but the embedded origin isn't, the
# embedding origin is used as the embedded origin.
optional string embeddedOrigin
# Context to override. When omitted, default browser context is used.
optional BrowserContextID browserContextId
# Grant specific permissions to the given origin and reject all others. Deprecated. Use
# setPermission instead.
experimental deprecated command grantPermissions
parameters
array of PermissionType permissions
# Origin the permission applies to, all origins if not specified.
optional string origin
# BrowserContext to override permissions. When omitted, default browser context is used.
optional BrowserContextID browserContextId
# Reset all permission management for all origins.
command resetPermissions
parameters
# BrowserContext to reset permissions. When omitted, default browser context is used.
optional BrowserContextID browserContextId
# Set the behavior when downloading a file.
experimental command setDownloadBehavior
parameters
# Whether to allow all or deny all download requests, or use default Chrome behavior if
# available (otherwise deny). |allowAndName| allows download and names files according to
# their download guids.
enum behavior
deny
allow
allowAndName
default
# BrowserContext to set download behavior. When omitted, default browser context is used.
optional BrowserContextID browserContextId
# The default path to save downloaded files to. This is required if behavior is set to 'allow'
# or 'allowAndName'.
optional string downloadPath
# Whether to emit download events (defaults to false).
optional boolean eventsEnabled
# Cancel a download if in progress
experimental command cancelDownload
parameters
# Global unique identifier of the download.
string guid
# BrowserContext to perform the action in. When omitted, default browser context is used.
optional BrowserContextID browserContextId
# Fired when page is about to start a download.
experimental event downloadWillBegin
parameters
# Id of the frame that caused the download to begin.
Page.FrameId frameId
# Global unique identifier of the download.
string guid
# URL of the resource being downloaded.
string url
# Suggested file name of the resource (the actual name of the file saved on disk may differ).
string suggestedFilename
# Fired when download makes progress. Last call has |done| == true.
experimental event downloadProgress
parameters
# Global unique identifier of the download.
string guid
# Total expected bytes to download.
number totalBytes
# Total bytes received.
number receivedBytes
# Download status.
enum state
inProgress
completed
canceled
# If download is "completed", provides the path of the downloaded file.
# Depending on the platform, it is not guaranteed to be set, nor the file
# is guaranteed to exist.
experimental optional string filePath
# Close browser gracefully.
command close
# Crashes browser on the main thread.
experimental command crash
# Crashes GPU process.
experimental command crashGpuProcess
# Returns version information.
command getVersion
returns
# Protocol version.
string protocolVersion
# Product name.
string product
# Product revision.
string revision
# User-Agent.
string userAgent
# V8 version.
string jsVersion
# Returns the command line switches for the browser process if, and only if
# --enable-automation is on the commandline.
experimental command getBrowserCommandLine
returns
# Commandline parameters
array of string arguments
# Chrome histogram bucket.
experimental type Bucket extends object
properties
# Minimum value (inclusive).
integer low
# Maximum value (exclusive).
integer high
# Number of samples.
integer count
# Chrome histogram.
experimental type Histogram extends object
properties
# Name.
string name
# Sum of sample values.
integer sum
# Total number of samples.
integer count
# Buckets.
array of Bucket buckets
# Get Chrome histograms.
experimental command getHistograms
parameters
# Requested substring in name. Only histograms which have query as a
# substring in their name are extracted. An empty or absent query returns
# all histograms.
optional string query
# If true, retrieve delta since last delta call.
optional boolean delta
returns
# Histograms.
array of Histogram histograms
# Get a Chrome histogram by name.
experimental command getHistogram
parameters
# Requested histogram name.
string name
# If true, retrieve delta since last delta call.
optional boolean delta
returns
# Histogram.
Histogram histogram
# Get position and size of the browser window.
experimental command getWindowBounds
parameters
# Browser window id.
WindowID windowId
returns
# Bounds information of the window. When window state is 'minimized', the restored window
# position and size are returned.
Bounds bounds
# Get the browser window that contains the devtools target.
experimental command getWindowForTarget
parameters
# Devtools agent host id. If called as a part of the session, associated targetId is used.
optional Target.TargetID targetId
returns
# Browser window id.
WindowID windowId
# Bounds information of the window. When window state is 'minimized', the restored window
# position and size are returned.
Bounds bounds
# Set position and/or size of the browser window.
experimental command setWindowBounds
parameters
# Browser window id.
WindowID windowId
# New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
# with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
Bounds bounds
# Set size of the browser contents resizing browser window as necessary.
experimental command setContentsSize
parameters
# Browser window id.
WindowID windowId
# The window contents width in DIP. Assumes current width if omitted.
# Must be specified if 'height' is omitted.
optional integer width
# The window contents height in DIP. Assumes current height if omitted.
# Must be specified if 'width' is omitted.
optional integer height
# Set dock tile details, platform-specific.
experimental command setDockTile
parameters
optional string badgeLabel
# Png encoded image.
optional binary image
# Invoke custom browser commands used by telemetry.
experimental command executeBrowserCommand
parameters
BrowserCommandId commandId
# Allows a site to use privacy sandbox features that require enrollment
# without the site actually being enrolled. Only supported on page targets.
command addPrivacySandboxEnrollmentOverride
parameters
string url
experimental type PrivacySandboxAPI extends string
enum
BiddingAndAuctionServices
TrustedKeyValue
# Configures encryption keys used with a given privacy sandbox API to talk
# to a trusted coordinator. Since this is intended for test automation only,
# coordinatorOrigin must be a .test domain. No existing coordinator
# configuration for the origin may exist.
command addPrivacySandboxCoordinatorKeyConfig
parameters
PrivacySandboxAPI api
string coordinatorOrigin
string keyConfig
# BrowserContext to perform the action in. When omitted, default browser
# context is used.
optional BrowserContextID browserContextId

1020
node_modules/devtools-protocol/pdl/domains/CSS.pdl generated vendored Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,125 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain CacheStorage
depends on Storage
# Unique identifier of the Cache object.
type CacheId extends string
# type of HTTP response cached
type CachedResponseType extends string
enum
basic
cors
default
error
opaqueResponse
opaqueRedirect
# Data entry.
type DataEntry extends object
properties
# Request URL.
string requestURL
# Request method.
string requestMethod
# Request headers
array of Header requestHeaders
# Number of seconds since epoch.
number responseTime
# HTTP response status code.
integer responseStatus
# HTTP response status text.
string responseStatusText
# HTTP response type
CachedResponseType responseType
# Response headers
array of Header responseHeaders
# Cache identifier.
type Cache extends object
properties
# An opaque unique id of the cache.
CacheId cacheId
# Security origin of the cache.
string securityOrigin
# Storage key of the cache.
string storageKey
# Storage bucket of the cache.
optional Storage.StorageBucket storageBucket
# The name of the cache.
string cacheName
type Header extends object
properties
string name
string value
# Cached response
type CachedResponse extends object
properties
# Entry content, base64-encoded.
binary body
# Deletes a cache.
command deleteCache
parameters
# Id of cache for deletion.
CacheId cacheId
# Deletes a cache entry.
command deleteEntry
parameters
# Id of cache where the entry will be deleted.
CacheId cacheId
# URL spec of the request.
string request
# Requests cache names.
command requestCacheNames
parameters
# At least and at most one of securityOrigin, storageKey, storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
returns
# Caches for the security origin.
array of Cache caches
# Fetches cache entry.
command requestCachedResponse
parameters
# Id of cache that contains the entry.
CacheId cacheId
# URL spec of the request.
string requestURL
# headers of the request.
array of Header requestHeaders
returns
# Response read from the cache.
CachedResponse response
# Requests data from cache.
command requestEntries
parameters
# ID of cache to get entries from.
CacheId cacheId
# Number of records to skip.
optional integer skipCount
# Number of records to fetch.
optional integer pageSize
# If present, only return the entries containing this substring in the path
optional string pathFilter
returns
# Array of object store data entries.
array of DataEntry cacheDataEntries
# Count of returned entries from this storage. If pathFilter is empty, it
# is the count of all entries from this storage.
number returnCount

62
node_modules/devtools-protocol/pdl/domains/Cast.pdl generated vendored Normal file
View File

@@ -0,0 +1,62 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# A domain for interacting with Cast, Presentation API, and Remote Playback API
# functionalities.
experimental domain Cast
type Sink extends object
properties
string name
string id
# Text describing the current session. Present only if there is an active
# session on the sink.
optional string session
# Starts observing for sinks that can be used for tab mirroring, and if set,
# sinks compatible with |presentationUrl| as well. When sinks are found, a
# |sinksUpdated| event is fired.
# Also starts observing for issue messages. When an issue is added or removed,
# an |issueUpdated| event is fired.
command enable
parameters
optional string presentationUrl
# Stops observing for sinks and issues.
command disable
# Sets a sink to be used when the web page requests the browser to choose a
# sink via Presentation API, Remote Playback API, or Cast SDK.
command setSinkToUse
parameters
string sinkName
# Starts mirroring the desktop to the sink.
command startDesktopMirroring
parameters
string sinkName
# Starts mirroring the tab to the sink.
command startTabMirroring
parameters
string sinkName
# Stops the active Cast session on the sink.
command stopCasting
parameters
string sinkName
# This is fired whenever the list of available sinks changes. A sink is a
# device or a software surface that you can cast to.
event sinksUpdated
parameters
array of Sink sinks
# This is fired whenever the outstanding issue/error message changes.
# |issueMessage| is empty if there is no issue.
event issueUpdated
parameters
string issueMessage

954
node_modules/devtools-protocol/pdl/domains/DOM.pdl generated vendored Normal file
View File

@@ -0,0 +1,954 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object
# that has an `id`. This `id` can be used to get additional information on the Node, resolve it into
# the JavaScript object wrapper, etc. It is important that client receives DOM events only for the
# nodes that are known to the client. Backend keeps track of the nodes that were sent to the client
# and never sends the same node twice. It is client's responsibility to collect information about
# the nodes that were sent to the client. Note that `iframe` owner elements will return
# corresponding document elements as their child nodes.
domain DOM
depends on Runtime
# Unique DOM node identifier.
type NodeId extends integer
# Unique DOM node identifier used to reference a node that may not have been pushed to the
# front-end.
type BackendNodeId extends integer
# Unique identifier for a CSS stylesheet.
type StyleSheetId extends string
# Backend node with a friendly name.
type BackendNode extends object
properties
# `Node`'s nodeType.
integer nodeType
# `Node`'s nodeName.
string nodeName
BackendNodeId backendNodeId
# Pseudo element type.
type PseudoType extends string
enum
first-line
first-letter
checkmark
before
after
picker-icon
interest-hint
marker
backdrop
column
selection
search-text
target-text
spelling-error
grammar-error
highlight
first-line-inherited
scroll-marker
scroll-marker-group
scroll-button
scrollbar
scrollbar-thumb
scrollbar-button
scrollbar-track
scrollbar-track-piece
scrollbar-corner
resizer
input-list-button
view-transition
view-transition-group
view-transition-image-pair
view-transition-group-children
view-transition-old
view-transition-new
placeholder
file-selector-button
details-content
picker
permission-icon
overscroll-area-parent
# Shadow root type.
type ShadowRootType extends string
enum
user-agent
open
closed
# Document compatibility mode.
type CompatibilityMode extends string
enum
QuirksMode
LimitedQuirksMode
NoQuirksMode
# ContainerSelector physical axes
type PhysicalAxes extends string
enum
Horizontal
Vertical
Both
# ContainerSelector logical axes
type LogicalAxes extends string
enum
Inline
Block
Both
# Physical scroll orientation
type ScrollOrientation extends string
enum
horizontal
vertical
# DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes.
# DOMNode is a base node mirror type.
type Node extends object
properties
# Node identifier that is passed into the rest of the DOM messages as the `nodeId`. Backend
# will only push node with given `id` once. It is aware of all requested nodes and will only
# fire DOM events for nodes known to the client.
NodeId nodeId
# The id of the parent node if any.
optional NodeId parentId
# The BackendNodeId for this node.
BackendNodeId backendNodeId
# `Node`'s nodeType.
integer nodeType
# `Node`'s nodeName.
string nodeName
# `Node`'s localName.
string localName
# `Node`'s nodeValue.
string nodeValue
# Child count for `Container` nodes.
optional integer childNodeCount
# Child nodes of this node when requested with children.
optional array of Node children
# Attributes of the `Element` node in the form of flat array `[name1, value1, name2, value2]`.
optional array of string attributes
# Document URL that `Document` or `FrameOwner` node points to.
optional string documentURL
# Base URL that `Document` or `FrameOwner` node uses for URL completion.
optional string baseURL
# `DocumentType`'s publicId.
optional string publicId
# `DocumentType`'s systemId.
optional string systemId
# `DocumentType`'s internalSubset.
optional string internalSubset
# `Document`'s XML version in case of XML documents.
optional string xmlVersion
# `Attr`'s name.
optional string name
# `Attr`'s value.
optional string value
# Pseudo element type for this node.
optional PseudoType pseudoType
# Pseudo element identifier for this node. Only present if there is a
# valid pseudoType.
optional string pseudoIdentifier
# Shadow root type.
optional ShadowRootType shadowRootType
# Frame ID for frame owner elements.
optional Page.FrameId frameId
# Content document for frame owner elements.
optional Node contentDocument
# Shadow root list for given element host.
optional array of Node shadowRoots
# Content document fragment for template elements.
optional Node templateContent
# Pseudo elements associated with this node.
optional array of Node pseudoElements
# Deprecated, as the HTML Imports API has been removed (crbug.com/937746).
# This property used to return the imported document for the HTMLImport links.
# The property is always undefined now.
deprecated optional Node importedDocument
# Distributed nodes for given insertion point.
optional array of BackendNode distributedNodes
# Whether the node is SVG.
optional boolean isSVG
optional CompatibilityMode compatibilityMode
optional BackendNode assignedSlot
experimental optional boolean isScrollable
experimental optional boolean affectedByStartingStyles
experimental optional array of StyleSheetId adoptedStyleSheets
# A structure to hold the top-level node of a detached tree and an array of its retained descendants.
type DetachedElementInfo extends object
properties
Node treeNode
array of NodeId retainedNodeIds
# A structure holding an RGBA color.
type RGBA extends object
properties
# The red component, in the [0-255] range.
integer r
# The green component, in the [0-255] range.
integer g
# The blue component, in the [0-255] range.
integer b
# The alpha component, in the [0-1] range (default: 1).
optional number a
# An array of quad vertices, x immediately followed by y for each point, points clock-wise.
type Quad extends array of number
# Box model.
type BoxModel extends object
properties
# Content box
Quad content
# Padding box
Quad padding
# Border box
Quad border
# Margin box
Quad margin
# Node width
integer width
# Node height
integer height
# Shape outside coordinates
optional ShapeOutsideInfo shapeOutside
# CSS Shape Outside details.
type ShapeOutsideInfo extends object
properties
# Shape bounds
Quad bounds
# Shape coordinate details
array of any shape
# Margin shape bounds
array of any marginShape
# Rectangle.
type Rect extends object
properties
# X coordinate
number x
# Y coordinate
number y
# Rectangle width
number width
# Rectangle height
number height
type CSSComputedStyleProperty extends object
properties
# Computed style property name.
string name
# Computed style property value.
string value
# Collects class names for the node with given id and all of it's child nodes.
experimental command collectClassNamesFromSubtree
parameters
# Id of the node to collect class names.
NodeId nodeId
returns
# Class name list.
array of string classNames
# Creates a deep copy of the specified node and places it into the target container before the
# given anchor.
experimental command copyTo
parameters
# Id of the node to copy.
NodeId nodeId
# Id of the element to drop the copy into.
NodeId targetNodeId
# Drop the copy before this node (if absent, the copy becomes the last child of
# `targetNodeId`).
optional NodeId insertBeforeNodeId
returns
# Id of the node clone.
NodeId nodeId
# Describes node given its id, does not require domain to be enabled. Does not start tracking any
# objects, can be used for automation.
command describeNode
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
# The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
# entire subtree or provide an integer larger than 0.
optional integer depth
# Whether or not iframes and shadow roots should be traversed when returning the subtree
# (default is false).
optional boolean pierce
returns
# Node description.
Node node
# Scrolls the specified rect of the given node into view if not already visible.
# Note: exactly one between nodeId, backendNodeId and objectId should be passed
# to identify the node.
command scrollIntoViewIfNeeded
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
# The rect to be scrolled into view, relative to the node's border box, in CSS pixels.
# When omitted, center of the node will be used, similar to Element.scrollIntoView.
optional Rect rect
# Disables DOM agent for the given page.
command disable
# Discards search results from the session with the given id. `getSearchResults` should no longer
# be called for that search.
experimental command discardSearchResults
parameters
# Unique search session identifier.
string searchId
# Enables DOM agent for the given page.
command enable
parameters
# Whether to include whitespaces in the children array of returned Nodes.
experimental optional enum includeWhitespace
# Strip whitespaces from child arrays (default).
none
# Return all children including block-level whitespace nodes.
all
# Focuses the given element.
command focus
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
# Returns attributes for the specified node.
command getAttributes
parameters
# Id of the node to retrieve attributes for.
NodeId nodeId
returns
# An interleaved array of node attribute names and values.
array of string attributes
# Returns boxes for the given node.
command getBoxModel
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
returns
# Box model for the node.
BoxModel model
# Returns quads that describe node position on the page. This method
# might return multiple quads for inline nodes.
experimental command getContentQuads
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
returns
# Quads that describe node layout relative to viewport.
array of Quad quads
# Returns the root DOM node (and optionally the subtree) to the caller.
# Implicitly enables the DOM domain events for the current target.
command getDocument
parameters
# The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
# entire subtree or provide an integer larger than 0.
optional integer depth
# Whether or not iframes and shadow roots should be traversed when returning the subtree
# (default is false).
optional boolean pierce
returns
# Resulting node.
Node root
# Returns the root DOM node (and optionally the subtree) to the caller.
# Deprecated, as it is not designed to work well with the rest of the DOM agent.
# Use DOMSnapshot.captureSnapshot instead.
deprecated command getFlattenedDocument
parameters
# The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
# entire subtree or provide an integer larger than 0.
optional integer depth
# Whether or not iframes and shadow roots should be traversed when returning the subtree
# (default is false).
optional boolean pierce
returns
# Resulting node.
array of Node nodes
# Finds nodes with a given computed style in a subtree.
experimental command getNodesForSubtreeByStyle
parameters
# Node ID pointing to the root of a subtree.
NodeId nodeId
# The style to filter nodes by (includes nodes if any of properties matches).
array of CSSComputedStyleProperty computedStyles
# Whether or not iframes and shadow roots in the same target should be traversed when returning the
# results (default is false).
optional boolean pierce
returns
# Resulting nodes.
array of NodeId nodeIds
# Returns node id at given location. Depending on whether DOM domain is enabled, nodeId is
# either returned or not.
command getNodeForLocation
parameters
# X coordinate.
integer x
# Y coordinate.
integer y
# False to skip to the nearest non-UA shadow root ancestor (default: false).
optional boolean includeUserAgentShadowDOM
# Whether to ignore pointer-events: none on elements and hit test them.
optional boolean ignorePointerEventsNone
returns
# Resulting node.
BackendNodeId backendNodeId
# Frame this node belongs to.
Page.FrameId frameId
# Id of the node at given coordinates, only when enabled and requested document.
optional NodeId nodeId
# Returns node's HTML markup.
command getOuterHTML
parameters
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
# Include all shadow roots. Equals to false if not specified.
experimental optional boolean includeShadowDOM
returns
# Outer HTML markup.
string outerHTML
# Returns the id of the nearest ancestor that is a relayout boundary.
experimental command getRelayoutBoundary
parameters
# Id of the node.
NodeId nodeId
returns
# Relayout boundary node id for the given node.
NodeId nodeId
# Returns search results from given `fromIndex` to given `toIndex` from the search with the given
# identifier.
experimental command getSearchResults
parameters
# Unique search session identifier.
string searchId
# Start index of the search result to be returned.
integer fromIndex
# End index of the search result to be returned.
integer toIndex
returns
# Ids of the search result nodes.
array of NodeId nodeIds
# Hides any highlight.
command hideHighlight
# Use 'Overlay.hideHighlight' instead
redirect Overlay
# Highlights DOM node.
command highlightNode
# Use 'Overlay.highlightNode' instead
redirect Overlay
# Highlights given rectangle.
command highlightRect
# Use 'Overlay.highlightRect' instead
redirect Overlay
# Marks last undoable state.
experimental command markUndoableState
# Moves node into the new container, places it before the given anchor.
command moveTo
parameters
# Id of the node to move.
NodeId nodeId
# Id of the element to drop the moved node into.
NodeId targetNodeId
# Drop node before this one (if absent, the moved node becomes the last child of
# `targetNodeId`).
optional NodeId insertBeforeNodeId
returns
# New id of the moved node.
NodeId nodeId
# Searches for a given string in the DOM tree. Use `getSearchResults` to access search results or
# `cancelSearch` to end this search session.
experimental command performSearch
parameters
# Plain text or query selector or XPath search query.
string query
# True to search in user agent shadow DOM.
optional boolean includeUserAgentShadowDOM
returns
# Unique search session identifier.
string searchId
# Number of search results.
integer resultCount
# Requests that the node is sent to the caller given its path. // FIXME, use XPath
experimental command pushNodeByPathToFrontend
parameters
# Path to node in the proprietary format.
string path
returns
# Id of the node for given path.
NodeId nodeId
# Requests that a batch of nodes is sent to the caller given their backend node ids.
experimental command pushNodesByBackendIdsToFrontend
parameters
# The array of backend node ids.
array of BackendNodeId backendNodeIds
returns
# The array of ids of pushed nodes that correspond to the backend ids specified in
# backendNodeIds.
array of NodeId nodeIds
# Executes `querySelector` on a given node.
command querySelector
parameters
# Id of the node to query upon.
NodeId nodeId
# Selector string.
string selector
returns
# Query selector result.
NodeId nodeId
# Executes `querySelectorAll` on a given node.
command querySelectorAll
parameters
# Id of the node to query upon.
NodeId nodeId
# Selector string.
string selector
returns
# Query selector result.
array of NodeId nodeIds
# Returns NodeIds of current top layer elements.
# Top layer is rendered closest to the user within a viewport, therefore its elements always
# appear on top of all other content.
experimental command getTopLayerElements
returns
# NodeIds of top layer elements
array of NodeId nodeIds
# Returns the NodeId of the matched element according to certain relations.
experimental command getElementByRelation
parameters
# Id of the node from which to query the relation.
NodeId nodeId
# Type of relation to get.
enum relation
# Get the popover target for a given element. In this case, this given
# element can only be an HTMLFormControlElement (<input>, <button>).
PopoverTarget
# Get the interestfor target (the attribute used to be named
# `interesttarget`) for for a given element.
InterestTarget
# Get the commandfor target for a given element. In this case, this given
# element can only be an HTMLButtonElement.
CommandFor
returns
# NodeId of the element matching the queried relation.
NodeId nodeId
# Re-does the last undone action.
experimental command redo
# Removes attribute with given name from an element with given id.
command removeAttribute
parameters
# Id of the element to remove attribute from.
NodeId nodeId
# Name of the attribute to remove.
string name
# Removes node with given id.
command removeNode
parameters
# Id of the node to remove.
NodeId nodeId
# Requests that children of the node with given id are returned to the caller in form of
# `setChildNodes` events where not only immediate children are retrieved, but all children down to
# the specified depth.
command requestChildNodes
parameters
# Id of the node to get children for.
NodeId nodeId
# The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
# entire subtree or provide an integer larger than 0.
optional integer depth
# Whether or not iframes and shadow roots should be traversed when returning the sub-tree
# (default is false).
optional boolean pierce
# Requests that the node is sent to the caller given the JavaScript node object reference. All
# nodes that form the path from the node to the root are also sent to the client as a series of
# `setChildNodes` notifications.
command requestNode
parameters
# JavaScript object id to convert into node.
Runtime.RemoteObjectId objectId
returns
# Node id for given object.
NodeId nodeId
# Resolves the JavaScript node object for a given NodeId or BackendNodeId.
command resolveNode
parameters
# Id of the node to resolve.
optional NodeId nodeId
# Backend identifier of the node to resolve.
optional DOM.BackendNodeId backendNodeId
# Symbolic group name that can be used to release multiple objects.
optional string objectGroup
# Execution context in which to resolve the node.
optional Runtime.ExecutionContextId executionContextId
returns
# JavaScript object wrapper for given node.
Runtime.RemoteObject object
# Sets attribute for an element with given id.
command setAttributeValue
parameters
# Id of the element to set attribute for.
NodeId nodeId
# Attribute name.
string name
# Attribute value.
string value
# Sets attributes on element with given id. This method is useful when user edits some existing
# attribute value and types in several attribute name/value pairs.
command setAttributesAsText
parameters
# Id of the element to set attributes for.
NodeId nodeId
# Text with a number of attributes. Will parse this text using HTML parser.
string text
# Attribute name to replace with new attributes derived from text in case text parsed
# successfully.
optional string name
# Sets files for the given file input element.
command setFileInputFiles
parameters
# Array of file paths to set.
array of string files
# Identifier of the node.
optional NodeId nodeId
# Identifier of the backend node.
optional BackendNodeId backendNodeId
# JavaScript object id of the node wrapper.
optional Runtime.RemoteObjectId objectId
# Sets if stack traces should be captured for Nodes. See `Node.getNodeStackTraces`. Default is disabled.
experimental command setNodeStackTracesEnabled
parameters
# Enable or disable.
boolean enable
# Gets stack traces associated with a Node. As of now, only provides stack trace for Node creation.
experimental command getNodeStackTraces
parameters
# Id of the node to get stack traces for.
NodeId nodeId
returns
# Creation stack trace, if available.
optional Runtime.StackTrace creation
# Returns file information for the given
# File wrapper.
experimental command getFileInfo
parameters
# JavaScript object id of the node wrapper.
Runtime.RemoteObjectId objectId
returns
string path
# Returns list of detached nodes
experimental command getDetachedDomNodes
returns
# The list of detached nodes
array of DetachedElementInfo detachedNodes
# Enables console to refer to the node with given id via $x (see Command Line API for more details
# $x functions).
experimental command setInspectedNode
parameters
# DOM node id to be accessible by means of $x command line API.
NodeId nodeId
# Sets node name for a node with given id.
command setNodeName
parameters
# Id of the node to set name for.
NodeId nodeId
# New node's name.
string name
returns
# New node's id.
NodeId nodeId
# Sets node value for a node with given id.
command setNodeValue
parameters
# Id of the node to set value for.
NodeId nodeId
# New node's value.
string value
# Sets node HTML markup, returns new node id.
command setOuterHTML
parameters
# Id of the node to set markup for.
NodeId nodeId
# Outer HTML markup to set.
string outerHTML
# Undoes the last performed action.
experimental command undo
# Returns iframe node that owns iframe with the given domain.
experimental command getFrameOwner
parameters
Page.FrameId frameId
returns
# Resulting node.
BackendNodeId backendNodeId
# Id of the node at given coordinates, only when enabled and requested document.
optional NodeId nodeId
# Returns the query container of the given node based on container query
# conditions: containerName, physical and logical axes, and whether it queries
# scroll-state or anchored elements. If no axes are provided and
# queriesScrollState is false, the style container is returned, which is the
# direct parent or the closest element with a matching container-name.
experimental command getContainerForNode
parameters
NodeId nodeId
optional string containerName
optional PhysicalAxes physicalAxes
optional LogicalAxes logicalAxes
optional boolean queriesScrollState
optional boolean queriesAnchored
returns
# The container node for the given node, or null if not found.
optional NodeId nodeId
# Returns the descendants of a container query container that have
# container queries against this container.
experimental command getQueryingDescendantsForContainer
parameters
# Id of the container node to find querying descendants from.
NodeId nodeId
returns
# Descendant nodes with container queries against the given container.
array of NodeId nodeIds
# Returns the target anchor element of the given anchor query according to
# https://www.w3.org/TR/css-anchor-position-1/#target.
experimental command getAnchorElement
parameters
# Id of the positioned element from which to find the anchor.
NodeId nodeId
# An optional anchor specifier, as defined in
# https://www.w3.org/TR/css-anchor-position-1/#anchor-specifier.
# If not provided, it will return the implicit anchor element for
# the given positioned element.
optional string anchorSpecifier
returns
# The anchor element of the given anchor query.
NodeId nodeId
# When enabling, this API force-opens the popover identified by nodeId
# and keeps it open until disabled.
experimental command forceShowPopover
parameters
# Id of the popover HTMLElement
NodeId nodeId
# If true, opens the popover and keeps it open. If false, closes the
# popover if it was previously force-opened.
boolean enable
returns
# List of popovers that were closed in order to respect popover stacking order.
array of NodeId nodeIds
# Fired when `Element`'s attribute is modified.
event attributeModified
parameters
# Id of the node that has changed.
NodeId nodeId
# Attribute name.
string name
# Attribute value.
string value
# Fired when `Element`'s adoptedStyleSheets are modified.
experimental event adoptedStyleSheetsModified
parameters
# Id of the node that has changed.
NodeId nodeId
# New adoptedStyleSheets array.
experimental array of StyleSheetId adoptedStyleSheets
# Fired when `Element`'s attribute is removed.
event attributeRemoved
parameters
# Id of the node that has changed.
NodeId nodeId
# A ttribute name.
string name
# Mirrors `DOMCharacterDataModified` event.
event characterDataModified
parameters
# Id of the node that has changed.
NodeId nodeId
# New text value.
string characterData
# Fired when `Container`'s child node count has changed.
event childNodeCountUpdated
parameters
# Id of the node that has changed.
NodeId nodeId
# New node count.
integer childNodeCount
# Mirrors `DOMNodeInserted` event.
event childNodeInserted
parameters
# Id of the node that has changed.
NodeId parentNodeId
# Id of the previous sibling.
NodeId previousNodeId
# Inserted node data.
Node node
# Mirrors `DOMNodeRemoved` event.
event childNodeRemoved
parameters
# Parent id.
NodeId parentNodeId
# Id of the node that has been removed.
NodeId nodeId
# Called when distribution is changed.
experimental event distributedNodesUpdated
parameters
# Insertion point where distributed nodes were updated.
NodeId insertionPointId
# Distributed nodes for given insertion point.
array of BackendNode distributedNodes
# Fired when `Document` has been totally updated. Node ids are no longer valid.
event documentUpdated
# Fired when `Element`'s inline style is modified via a CSS property modification.
experimental event inlineStyleInvalidated
parameters
# Ids of the nodes for which the inline styles have been invalidated.
array of NodeId nodeIds
# Called when a pseudo element is added to an element.
experimental event pseudoElementAdded
parameters
# Pseudo element's parent element id.
NodeId parentId
# The added pseudo element.
Node pseudoElement
# Called when top layer elements are changed.
experimental event topLayerElementsUpdated
# Fired when a node's scrollability state changes.
experimental event scrollableFlagUpdated
parameters
# The id of the node.
DOM.NodeId nodeId
# If the node is scrollable.
boolean isScrollable
# Fired when a node's starting styles changes.
experimental event affectedByStartingStylesFlagUpdated
parameters
# The id of the node.
DOM.NodeId nodeId
# If the node has starting styles.
boolean affectedByStartingStyles
# Called when a pseudo element is removed from an element.
experimental event pseudoElementRemoved
parameters
# Pseudo element's parent element id.
NodeId parentId
# The removed pseudo element id.
NodeId pseudoElementId
# Fired when backend wants to provide client with the missing DOM structure. This happens upon
# most of the calls requesting node ids.
event setChildNodes
parameters
# Parent node id to populate with children.
NodeId parentId
# Child nodes array.
array of Node nodes
# Called when shadow root is popped from the element.
experimental event shadowRootPopped
parameters
# Host element id.
NodeId hostId
# Shadow root id.
NodeId rootId
# Called when shadow root is pushed into the element.
experimental event shadowRootPushed
parameters
# Host element id.
NodeId hostId
# Shadow root.
Node root

View File

@@ -0,0 +1,128 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# DOM debugging allows setting breakpoints on particular DOM operations and events. JavaScript
# execution will stop on these operations as if there was a regular breakpoint set.
domain DOMDebugger
depends on DOM
depends on Runtime
# DOM breakpoint type.
type DOMBreakpointType extends string
enum
subtree-modified
attribute-modified
node-removed
# CSP Violation type.
experimental type CSPViolationType extends string
enum
trustedtype-sink-violation
trustedtype-policy-violation
# Object event listener.
type EventListener extends object
properties
# `EventListener`'s type.
string type
# `EventListener`'s useCapture.
boolean useCapture
# `EventListener`'s passive flag.
boolean passive
# `EventListener`'s once flag.
boolean once
# Script id of the handler code.
Runtime.ScriptId scriptId
# Line number in the script (0-based).
integer lineNumber
# Column number in the script (0-based).
integer columnNumber
# Event handler function value.
optional Runtime.RemoteObject handler
# Event original handler function value.
optional Runtime.RemoteObject originalHandler
# Node the listener is added to (if any).
optional DOM.BackendNodeId backendNodeId
# Returns event listeners of the given object.
command getEventListeners
parameters
# Identifier of the object to return listeners for.
Runtime.RemoteObjectId objectId
# The maximum depth at which Node children should be retrieved, defaults to 1. Use -1 for the
# entire subtree or provide an integer larger than 0.
optional integer depth
# Whether or not iframes and shadow roots should be traversed when returning the subtree
# (default is false). Reports listeners for all contexts if pierce is enabled.
optional boolean pierce
returns
# Array of relevant listeners.
array of EventListener listeners
# Removes DOM breakpoint that was set using `setDOMBreakpoint`.
command removeDOMBreakpoint
parameters
# Identifier of the node to remove breakpoint from.
DOM.NodeId nodeId
# Type of the breakpoint to remove.
DOMBreakpointType type
# Removes breakpoint on particular DOM event.
command removeEventListenerBreakpoint
parameters
# Event name.
string eventName
# EventTarget interface name.
experimental optional string targetName
# Removes breakpoint on particular native event.
experimental deprecated command removeInstrumentationBreakpoint
redirect EventBreakpoints
parameters
# Instrumentation name to stop on.
string eventName
# Removes breakpoint from XMLHttpRequest.
command removeXHRBreakpoint
parameters
# Resource URL substring.
string url
# Sets breakpoint on particular CSP violations.
experimental command setBreakOnCSPViolation
parameters
# CSP Violations to stop upon.
array of CSPViolationType violationTypes
# Sets breakpoint on particular operation with DOM.
command setDOMBreakpoint
parameters
# Identifier of the node to set breakpoint on.
DOM.NodeId nodeId
# Type of the operation to stop upon.
DOMBreakpointType type
# Sets breakpoint on particular DOM event.
command setEventListenerBreakpoint
parameters
# DOM Event name to stop on (any DOM event will do).
string eventName
# EventTarget interface name to stop on. If equal to `"*"` or not provided, will stop on any
# EventTarget.
experimental optional string targetName
# Sets breakpoint on particular native event.
experimental deprecated command setInstrumentationBreakpoint
redirect EventBreakpoints
parameters
# Instrumentation name to stop on.
string eventName
# Sets breakpoint on XMLHttpRequest.
command setXHRBreakpoint
parameters
# Resource URL substring. All XHRs having this substring in the URL will get stopped upon.
string url

View File

@@ -0,0 +1,319 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain facilitates obtaining document snapshots with DOM, layout, and style information.
experimental domain DOMSnapshot
depends on CSS
depends on DOM
depends on DOMDebugger
depends on Page
# A Node in the DOM tree.
type DOMNode extends object
properties
# `Node`'s nodeType.
integer nodeType
# `Node`'s nodeName.
string nodeName
# `Node`'s nodeValue.
string nodeValue
# Only set for textarea elements, contains the text value.
optional string textValue
# Only set for input elements, contains the input's associated text value.
optional string inputValue
# Only set for radio and checkbox input elements, indicates if the element has been checked
optional boolean inputChecked
# Only set for option elements, indicates if the element has been selected
optional boolean optionSelected
# `Node`'s id, corresponds to DOM.Node.backendNodeId.
DOM.BackendNodeId backendNodeId
# The indexes of the node's child nodes in the `domNodes` array returned by `getSnapshot`, if
# any.
optional array of integer childNodeIndexes
# Attributes of an `Element` node.
optional array of NameValue attributes
# Indexes of pseudo elements associated with this node in the `domNodes` array returned by
# `getSnapshot`, if any.
optional array of integer pseudoElementIndexes
# The index of the node's related layout tree node in the `layoutTreeNodes` array returned by
# `getSnapshot`, if any.
optional integer layoutNodeIndex
# Document URL that `Document` or `FrameOwner` node points to.
optional string documentURL
# Base URL that `Document` or `FrameOwner` node uses for URL completion.
optional string baseURL
# Only set for documents, contains the document's content language.
optional string contentLanguage
# Only set for documents, contains the document's character set encoding.
optional string documentEncoding
# `DocumentType` node's publicId.
optional string publicId
# `DocumentType` node's systemId.
optional string systemId
# Frame ID for frame owner elements and also for the document node.
optional Page.FrameId frameId
# The index of a frame owner element's content document in the `domNodes` array returned by
# `getSnapshot`, if any.
optional integer contentDocumentIndex
# Type of a pseudo element node.
optional DOM.PseudoType pseudoType
# Shadow root type.
optional DOM.ShadowRootType shadowRootType
# Whether this DOM node responds to mouse clicks. This includes nodes that have had click
# event listeners attached via JavaScript as well as anchor tags that naturally navigate when
# clicked.
optional boolean isClickable
# Details of the node's event listeners, if any.
optional array of DOMDebugger.EventListener eventListeners
# The selected url for nodes with a srcset attribute.
optional string currentSourceURL
# The url of the script (if any) that generates this node.
optional string originURL
# Scroll offsets, set when this node is a Document.
optional number scrollOffsetX
optional number scrollOffsetY
# Details of post layout rendered text positions. The exact layout should not be regarded as
# stable and may change between versions.
type InlineTextBox extends object
properties
# The bounding box in document coordinates. Note that scroll offset of the document is ignored.
DOM.Rect boundingBox
# The starting index in characters, for this post layout textbox substring. Characters that
# would be represented as a surrogate pair in UTF-16 have length 2.
integer startCharacterIndex
# The number of characters in this post layout textbox substring. Characters that would be
# represented as a surrogate pair in UTF-16 have length 2.
integer numCharacters
# Details of an element in the DOM tree with a LayoutObject.
type LayoutTreeNode extends object
properties
# The index of the related DOM node in the `domNodes` array returned by `getSnapshot`.
integer domNodeIndex
# The bounding box in document coordinates. Note that scroll offset of the document is ignored.
DOM.Rect boundingBox
# Contents of the LayoutText, if any.
optional string layoutText
# The post-layout inline text nodes, if any.
optional array of InlineTextBox inlineTextNodes
# Index into the `computedStyles` array returned by `getSnapshot`.
optional integer styleIndex
# Global paint order index, which is determined by the stacking order of the nodes. Nodes
# that are painted together will have the same index. Only provided if includePaintOrder in
# getSnapshot was true.
optional integer paintOrder
# Set to true to indicate the element begins a new stacking context.
optional boolean isStackingContext
# A subset of the full ComputedStyle as defined by the request whitelist.
type ComputedStyle extends object
properties
# Name/value pairs of computed style properties.
array of NameValue properties
# A name/value pair.
type NameValue extends object
properties
# Attribute/property name.
string name
# Attribute/property value.
string value
# Index of the string in the strings table.
type StringIndex extends integer
# Index of the string in the strings table.
type ArrayOfStrings extends array of StringIndex
# Data that is only present on rare nodes.
type RareStringData extends object
properties
array of integer index
array of StringIndex value
type RareBooleanData extends object
properties
array of integer index
type RareIntegerData extends object
properties
array of integer index
array of integer value
type Rectangle extends array of number
# Document snapshot.
type DocumentSnapshot extends object
properties
# Document URL that `Document` or `FrameOwner` node points to.
StringIndex documentURL
# Document title.
StringIndex title
# Base URL that `Document` or `FrameOwner` node uses for URL completion.
StringIndex baseURL
# Contains the document's content language.
StringIndex contentLanguage
# Contains the document's character set encoding.
StringIndex encodingName
# `DocumentType` node's publicId.
StringIndex publicId
# `DocumentType` node's systemId.
StringIndex systemId
# Frame ID for frame owner elements and also for the document node.
StringIndex frameId
# A table with dom nodes.
NodeTreeSnapshot nodes
# The nodes in the layout tree.
LayoutTreeSnapshot layout
# The post-layout inline text nodes.
TextBoxSnapshot textBoxes
# Horizontal scroll offset.
optional number scrollOffsetX
# Vertical scroll offset.
optional number scrollOffsetY
# Document content width.
optional number contentWidth
# Document content height.
optional number contentHeight
# Table containing nodes.
type NodeTreeSnapshot extends object
properties
# Parent node index.
optional array of integer parentIndex
# `Node`'s nodeType.
optional array of integer nodeType
# Type of the shadow root the `Node` is in. String values are equal to the `ShadowRootType` enum.
optional RareStringData shadowRootType
# `Node`'s nodeName.
optional array of StringIndex nodeName
# `Node`'s nodeValue.
optional array of StringIndex nodeValue
# `Node`'s id, corresponds to DOM.Node.backendNodeId.
optional array of DOM.BackendNodeId backendNodeId
# Attributes of an `Element` node. Flatten name, value pairs.
optional array of ArrayOfStrings attributes
# Only set for textarea elements, contains the text value.
optional RareStringData textValue
# Only set for input elements, contains the input's associated text value.
optional RareStringData inputValue
# Only set for radio and checkbox input elements, indicates if the element has been checked
optional RareBooleanData inputChecked
# Only set for option elements, indicates if the element has been selected
optional RareBooleanData optionSelected
# The index of the document in the list of the snapshot documents.
optional RareIntegerData contentDocumentIndex
# Type of a pseudo element node.
optional RareStringData pseudoType
# Pseudo element identifier for this node. Only present if there is a
# valid pseudoType.
optional RareStringData pseudoIdentifier
# Whether this DOM node responds to mouse clicks. This includes nodes that have had click
# event listeners attached via JavaScript as well as anchor tags that naturally navigate when
# clicked.
optional RareBooleanData isClickable
# The selected url for nodes with a srcset attribute.
optional RareStringData currentSourceURL
# The url of the script (if any) that generates this node.
optional RareStringData originURL
# Table of details of an element in the DOM tree with a LayoutObject.
type LayoutTreeSnapshot extends object
properties
# Index of the corresponding node in the `NodeTreeSnapshot` array returned by `captureSnapshot`.
array of integer nodeIndex
# Array of indexes specifying computed style strings, filtered according to the `computedStyles` parameter passed to `captureSnapshot`.
array of ArrayOfStrings styles
# The absolute position bounding box.
array of Rectangle bounds
# Contents of the LayoutText, if any.
array of StringIndex text
# Stacking context information.
RareBooleanData stackingContexts
# Global paint order index, which is determined by the stacking order of the nodes. Nodes
# that are painted together will have the same index. Only provided if includePaintOrder in
# captureSnapshot was true.
optional array of integer paintOrders
# The offset rect of nodes. Only available when includeDOMRects is set to true
optional array of Rectangle offsetRects
# The scroll rect of nodes. Only available when includeDOMRects is set to true
optional array of Rectangle scrollRects
# The client rect of nodes. Only available when includeDOMRects is set to true
optional array of Rectangle clientRects
# The list of background colors that are blended with colors of overlapping elements.
experimental optional array of StringIndex blendedBackgroundColors
# The list of computed text opacities.
experimental optional array of number textColorOpacities
# Table of details of the post layout rendered text positions. The exact layout should not be regarded as
# stable and may change between versions.
type TextBoxSnapshot extends object
properties
# Index of the layout tree node that owns this box collection.
array of integer layoutIndex
# The absolute position bounding box.
array of Rectangle bounds
# The starting index in characters, for this post layout textbox substring. Characters that
# would be represented as a surrogate pair in UTF-16 have length 2.
array of integer start
# The number of characters in this post layout textbox substring. Characters that would be
# represented as a surrogate pair in UTF-16 have length 2.
array of integer length
# Disables DOM snapshot agent for the given page.
command disable
# Enables DOM snapshot agent for the given page.
command enable
# Returns a document snapshot, including the full DOM tree of the root node (including iframes,
# template contents, and imported documents) in a flattened array, as well as layout and
# white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
# flattened.
deprecated command getSnapshot
parameters
# Whitelist of computed styles to return.
array of string computedStyleWhitelist
# Whether or not to retrieve details of DOM listeners (default false).
optional boolean includeEventListeners
# Whether to determine and include the paint order index of LayoutTreeNodes (default false).
optional boolean includePaintOrder
# Whether to include UA shadow tree in the snapshot (default false).
optional boolean includeUserAgentShadowTree
returns
# The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
array of DOMNode domNodes
# The nodes in the layout tree.
array of LayoutTreeNode layoutTreeNodes
# Whitelisted ComputedStyle properties for each node in the layout tree.
array of ComputedStyle computedStyles
# Returns a document snapshot, including the full DOM tree of the root node (including iframes,
# template contents, and imported documents) in a flattened array, as well as layout and
# white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
# flattened.
command captureSnapshot
parameters
# Whitelist of computed styles to return.
array of string computedStyles
# Whether to include layout object paint orders into the snapshot.
optional boolean includePaintOrder
# Whether to include DOM rectangles (offsetRects, clientRects, scrollRects) into the snapshot
optional boolean includeDOMRects
# Whether to include blended background colors in the snapshot (default: false).
# Blended background color is achieved by blending background colors of all elements
# that overlap with the current element.
experimental optional boolean includeBlendedBackgroundColors
# Whether to include text color opacity in the snapshot (default: false).
# An element might have the opacity property set that affects the text color of the element.
# The final text color opacity is computed based on the opacity of all overlapping elements.
experimental optional boolean includeTextColorOpacities
returns
# The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
array of DocumentSnapshot documents
# Shared string table that all string properties refer to with indexes.
array of string strings

View File

@@ -0,0 +1,72 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Query and modify DOM storage.
experimental domain DOMStorage
type SerializedStorageKey extends string
# DOM Storage identifier.
type StorageId extends object
properties
# Security origin for the storage.
optional string securityOrigin
# Represents a key by which DOM Storage keys its CachedStorageAreas
optional SerializedStorageKey storageKey
# Whether the storage is local storage (not session storage).
boolean isLocalStorage
# DOM Storage item.
type Item extends array of string
command clear
parameters
StorageId storageId
# Disables storage tracking, prevents storage events from being sent to the client.
command disable
# Enables storage tracking, storage events will now be delivered to the client.
command enable
command getDOMStorageItems
parameters
StorageId storageId
returns
array of Item entries
command removeDOMStorageItem
parameters
StorageId storageId
string key
command setDOMStorageItem
parameters
StorageId storageId
string key
string value
event domStorageItemAdded
parameters
StorageId storageId
string key
string newValue
event domStorageItemRemoved
parameters
StorageId storageId
string key
event domStorageItemUpdated
parameters
StorageId storageId
string key
string oldValue
string newValue
event domStorageItemsCleared
parameters
StorageId storageId

View File

@@ -0,0 +1,43 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain DeviceAccess
# Device request id.
type RequestId extends string
# A device id.
type DeviceId extends string
# Device information displayed in a user prompt to select a device.
type PromptDevice extends object
properties
DeviceId id
# Display name as it appears in a device request user prompt.
string name
# Enable events in this domain.
command enable
# Disable events in this domain.
command disable
# Select a device in response to a DeviceAccess.deviceRequestPrompted event.
command selectPrompt
parameters
RequestId id
DeviceId deviceId
# Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
command cancelPrompt
parameters
RequestId id
# A device request opened a user prompt to select a device. Respond with the
# selectPrompt or cancelPrompt command.
event deviceRequestPrompted
parameters
RequestId id
array of PromptDevice devices

View File

@@ -0,0 +1,20 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain DeviceOrientation
# Clears the overridden Device Orientation.
command clearDeviceOrientationOverride
# Overrides the Device Orientation.
command setDeviceOrientationOverride
parameters
# Mock alpha
number alpha
# Mock beta
number beta
# Mock gamma
number gamma

View File

@@ -0,0 +1,608 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain emulates different environments for the page.
domain Emulation
depends on DOM
depends on Page
depends on Runtime
experimental type SafeAreaInsets extends object
properties
# Overrides safe-area-inset-top.
optional integer top
# Overrides safe-area-max-inset-top.
optional integer topMax
# Overrides safe-area-inset-left.
optional integer left
# Overrides safe-area-max-inset-left.
optional integer leftMax
# Overrides safe-area-inset-bottom.
optional integer bottom
# Overrides safe-area-max-inset-bottom.
optional integer bottomMax
# Overrides safe-area-inset-right.
optional integer right
# Overrides safe-area-max-inset-right.
optional integer rightMax
# Screen orientation.
type ScreenOrientation extends object
properties
# Orientation type.
enum type
portraitPrimary
portraitSecondary
landscapePrimary
landscapeSecondary
# Orientation angle.
integer angle
type DisplayFeature extends object
properties
# Orientation of a display feature in relation to screen
enum orientation
vertical
horizontal
# The offset from the screen origin in either the x (for vertical
# orientation) or y (for horizontal orientation) direction.
integer offset
# A display feature may mask content such that it is not physically
# displayed - this length along with the offset describes this area.
# A display feature that only splits content will have a 0 mask_length.
integer maskLength
type DevicePosture extends object
properties
# Current posture of the device
enum type
continuous
folded
type MediaFeature extends object
properties
string name
string value
# advance: If the scheduler runs out of immediate work, the virtual time base may fast forward to
# allow the next delayed task (if any) to run; pause: The virtual time base may not advance;
# pauseIfNetworkFetchesPending: The virtual time base may not advance if there are any pending
# resource fetches.
experimental type VirtualTimePolicy extends string
enum
advance
pause
pauseIfNetworkFetchesPending
# Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
experimental type UserAgentBrandVersion extends object
properties
string brand
string version
# Used to specify User Agent Client Hints to emulate. See https://wicg.github.io/ua-client-hints
# Missing optional values will be filled in by the target with what it would normally use.
experimental type UserAgentMetadata extends object
properties
# Brands appearing in Sec-CH-UA.
optional array of UserAgentBrandVersion brands
# Brands appearing in Sec-CH-UA-Full-Version-List.
optional array of UserAgentBrandVersion fullVersionList
deprecated optional string fullVersion
string platform
string platformVersion
string architecture
string model
boolean mobile
optional string bitness
optional boolean wow64
# Used to specify User Agent form-factor values.
# See https://wicg.github.io/ua-client-hints/#sec-ch-ua-form-factors
optional array of string formFactors
# Used to specify sensor types to emulate.
# See https://w3c.github.io/sensors/#automation for more information.
experimental type SensorType extends string
enum
absolute-orientation
accelerometer
ambient-light
gravity
gyroscope
linear-acceleration
magnetometer
relative-orientation
experimental type SensorMetadata extends object
properties
optional boolean available
optional number minimumFrequency
optional number maximumFrequency
experimental type SensorReadingSingle extends object
properties
number value
experimental type SensorReadingXYZ extends object
properties
number x
number y
number z
experimental type SensorReadingQuaternion extends object
properties
number x
number y
number z
number w
experimental type SensorReading extends object
properties
optional SensorReadingSingle single
optional SensorReadingXYZ xyz
optional SensorReadingQuaternion quaternion
experimental type PressureSource extends string
enum
cpu
experimental type PressureState extends string
enum
nominal
fair
serious
critical
experimental type PressureMetadata extends object
properties
optional boolean available
experimental type WorkAreaInsets extends object
properties
# Work area top inset in pixels. Default is 0;
optional integer top
# Work area left inset in pixels. Default is 0;
optional integer left
# Work area bottom inset in pixels. Default is 0;
optional integer bottom
# Work area right inset in pixels. Default is 0;
optional integer right
experimental type ScreenId extends string
# Screen information similar to the one returned by window.getScreenDetails() method,
# see https://w3c.github.io/window-management/#screendetailed.
experimental type ScreenInfo extends object
properties
# Offset of the left edge of the screen.
integer left
# Offset of the top edge of the screen.
integer top
# Width of the screen.
integer width
# Height of the screen.
integer height
# Offset of the left edge of the available screen area.
integer availLeft
# Offset of the top edge of the available screen area.
integer availTop
# Width of the available screen area.
integer availWidth
# Height of the available screen area.
integer availHeight
# Specifies the screen's device pixel ratio.
number devicePixelRatio
# Specifies the screen's orientation.
ScreenOrientation orientation
# Specifies the screen's color depth in bits.
integer colorDepth
# Indicates whether the device has multiple screens.
boolean isExtended
# Indicates whether the screen is internal to the device or external, attached to the device.
boolean isInternal
# Indicates whether the screen is set as the the operating system primary screen.
boolean isPrimary
# Specifies the descriptive label for the screen.
string label
# Specifies the unique identifier of the screen.
ScreenId id
# Tells whether emulation is supported.
deprecated command canEmulate
returns
# True if emulation is supported.
boolean result
# Clears the overridden device metrics.
command clearDeviceMetricsOverride
# Clears the overridden Geolocation Position and Error.
command clearGeolocationOverride
# Requests that page scale factor is reset to initial values.
experimental command resetPageScaleFactor
# Enables or disables simulating a focused and active page.
experimental command setFocusEmulationEnabled
parameters
# Whether to enable to disable focus emulation.
boolean enabled
# Automatically render all web contents using a dark theme.
experimental command setAutoDarkModeOverride
parameters
# Whether to enable or disable automatic dark mode.
# If not specified, any existing override will be cleared.
optional boolean enabled
# Enables CPU throttling to emulate slow CPUs.
command setCPUThrottlingRate
parameters
# Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
number rate
# Sets or clears an override of the default background color of the frame. This override is used
# if the content does not specify one.
command setDefaultBackgroundColorOverride
parameters
# RGBA of the default background color. If not specified, any existing override will be
# cleared.
optional DOM.RGBA color
# Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
# respective variables to be undefined, even if previously overridden.
experimental command setSafeAreaInsetsOverride
parameters
SafeAreaInsets insets
# Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
# window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
# query results).
command setDeviceMetricsOverride
parameters
# Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
integer width
# Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
integer height
# Overriding device scale factor value. 0 disables the override.
number deviceScaleFactor
# Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
# autosizing and more.
boolean mobile
# Scale to apply to resulting view image.
experimental optional number scale
# Overriding screen width value in pixels (minimum 0, maximum 10000000).
experimental optional integer screenWidth
# Overriding screen height value in pixels (minimum 0, maximum 10000000).
experimental optional integer screenHeight
# Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
experimental optional integer positionX
# Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
experimental optional integer positionY
# Do not set visible view size, rely upon explicit setVisibleSize call.
experimental optional boolean dontSetVisibleSize
# Screen orientation override.
optional ScreenOrientation screenOrientation
# If set, the visible area of the page will be overridden to this viewport. This viewport
# change is not observed by the page, e.g. viewport-relative elements do not change positions.
experimental optional Page.Viewport viewport
# If set, the display feature of a multi-segment screen. If not set, multi-segment support
# is turned-off.
# Deprecated, use Emulation.setDisplayFeaturesOverride.
experimental deprecated optional DisplayFeature displayFeature
# If set, the posture of a foldable device. If not set the posture is set
# to continuous.
# Deprecated, use Emulation.setDevicePostureOverride.
experimental deprecated optional DevicePosture devicePosture
# Start reporting the given posture value to the Device Posture API.
# This override can also be set in setDeviceMetricsOverride().
experimental command setDevicePostureOverride
parameters
DevicePosture posture
# Clears a device posture override set with either setDeviceMetricsOverride()
# or setDevicePostureOverride() and starts using posture information from the
# platform again.
# Does nothing if no override is set.
experimental command clearDevicePostureOverride
# Start using the given display features to pupulate the Viewport Segments API.
# This override can also be set in setDeviceMetricsOverride().
experimental command setDisplayFeaturesOverride
parameters
array of DisplayFeature features
# Clears the display features override set with either setDeviceMetricsOverride()
# or setDisplayFeaturesOverride() and starts using display features from the
# platform again.
# Does nothing if no override is set.
experimental command clearDisplayFeaturesOverride
experimental command setScrollbarsHidden
parameters
# Whether scrollbars should be always hidden.
boolean hidden
experimental command setDocumentCookieDisabled
parameters
# Whether document.coookie API should be disabled.
boolean disabled
experimental command setEmitTouchEventsForMouse
parameters
# Whether touch emulation based on mouse input should be enabled.
boolean enabled
# Touch/gesture events configuration. Default: current platform.
optional enum configuration
mobile
desktop
# Emulates the given media type or media feature for CSS media queries.
command setEmulatedMedia
parameters
# Media type to emulate. Empty string disables the override.
optional string media
# Media features to emulate.
optional array of MediaFeature features
# Emulates the given vision deficiency.
command setEmulatedVisionDeficiency
parameters
# Vision deficiency to emulate. Order: best-effort emulations come first, followed by any
# physiologically accurate emulations for medically recognized color vision deficiencies.
enum type
none
blurredVision
reducedContrast
achromatopsia
deuteranopia
protanopia
tritanopia
# Emulates the given OS text scale.
command setEmulatedOSTextScale
parameters
optional number scale
# Overrides the Geolocation Position or Error. Omitting latitude, longitude or
# accuracy emulates position unavailable.
command setGeolocationOverride
parameters
# Mock latitude
optional number latitude
# Mock longitude
optional number longitude
# Mock accuracy
optional number accuracy
# Mock altitude
optional number altitude
# Mock altitudeAccuracy
optional number altitudeAccuracy
# Mock heading
optional number heading
# Mock speed
optional number speed
experimental command getOverriddenSensorInformation
parameters
SensorType type
returns
number requestedSamplingFrequency
# Overrides a platform sensor of a given type. If |enabled| is true, calls to
# Sensor.start() will use a virtual sensor as backend rather than fetching
# data from a real hardware sensor. Otherwise, existing virtual
# sensor-backend Sensor objects will fire an error event and new calls to
# Sensor.start() will attempt to use a real sensor instead.
experimental command setSensorOverrideEnabled
parameters
boolean enabled
SensorType type
optional SensorMetadata metadata
# Updates the sensor readings reported by a sensor type previously overridden
# by setSensorOverrideEnabled.
experimental command setSensorOverrideReadings
parameters
SensorType type
SensorReading reading
# Overrides a pressure source of a given type, as used by the Compute
# Pressure API, so that updates to PressureObserver.observe() are provided
# via setPressureStateOverride instead of being retrieved from
# platform-provided telemetry data.
experimental command setPressureSourceOverrideEnabled
parameters
boolean enabled
PressureSource source
optional PressureMetadata metadata
# TODO: OBSOLETE: To remove when setPressureDataOverride is merged.
# Provides a given pressure state that will be processed and eventually be
# delivered to PressureObserver users. |source| must have been previously
# overridden by setPressureSourceOverrideEnabled.
experimental command setPressureStateOverride
parameters
PressureSource source
PressureState state
# Provides a given pressure data set that will be processed and eventually be
# delivered to PressureObserver users. |source| must have been previously
# overridden by setPressureSourceOverrideEnabled.
experimental command setPressureDataOverride
parameters
PressureSource source
PressureState state
optional number ownContributionEstimate
# Overrides the Idle state.
command setIdleOverride
parameters
# Mock isUserActive
boolean isUserActive
# Mock isScreenUnlocked
boolean isScreenUnlocked
# Clears Idle state overrides.
command clearIdleOverride
# Overrides value returned by the javascript navigator object.
experimental deprecated command setNavigatorOverrides
parameters
# The platform navigator.platform should return.
string platform
# Sets a specified page scale factor.
experimental command setPageScaleFactor
parameters
# Page scale factor.
number pageScaleFactor
# Switches script execution in the page.
command setScriptExecutionDisabled
parameters
# Whether script execution should be disabled in the page.
boolean value
# Enables touch on platforms which do not support them.
command setTouchEmulationEnabled
parameters
# Whether the touch event emulation should be enabled.
boolean enabled
# Maximum touch points supported. Defaults to one.
optional integer maxTouchPoints
# Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets
# the current virtual time policy. Note this supersedes any previous time budget.
experimental command setVirtualTimePolicy
parameters
VirtualTimePolicy policy
# If set, after this many virtual milliseconds have elapsed virtual time will be paused and a
# virtualTimeBudgetExpired event is sent.
optional number budget
# If set this specifies the maximum number of tasks that can be run before virtual is forced
# forwards to prevent deadlock.
optional integer maxVirtualTimeTaskStarvationCount
# If set, base::Time::Now will be overridden to initially return this value.
optional Network.TimeSinceEpoch initialVirtualTime
returns
# Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
number virtualTimeTicksBase
# Overrides default host system locale with the specified one.
experimental command setLocaleOverride
parameters
# ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and
# restores default host system locale.
optional string locale
# Overrides default host system timezone with the specified one.
command setTimezoneOverride
parameters
# The timezone identifier. List of supported timezones:
# https://source.chromium.org/chromium/chromium/deps/icu.git/+/faee8bc70570192d82d2978a71e2a615788597d1:source/data/misc/metaZones.txt
# If empty, disables the override and restores default host system timezone.
string timezoneId
# Resizes the frame/viewport of the page. Note that this does not affect the frame's container
# (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported
# on Android.
experimental deprecated command setVisibleSize
parameters
# Frame width (DIP).
integer width
# Frame height (DIP).
integer height
# Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
experimental event virtualTimeBudgetExpired
# Enum of image types that can be disabled.
experimental type DisabledImageType extends string
enum
avif
webp
experimental command setDisabledImageTypes
parameters
# Image types to disable.
array of DisabledImageType imageTypes
# Override the value of navigator.connection.saveData
experimental command setDataSaverOverride
parameters
# Override value. Omitting the parameter disables the override.
optional boolean dataSaverEnabled
experimental command setHardwareConcurrencyOverride
parameters
# Hardware concurrency to report
integer hardwareConcurrency
# Allows overriding user agent with the given string.
# `userAgentMetadata` must be set for Client Hint headers to be sent.
command setUserAgentOverride
parameters
# User agent to use.
string userAgent
# Browser language to emulate.
optional string acceptLanguage
# The platform navigator.platform should return.
optional string platform
# To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
experimental optional UserAgentMetadata userAgentMetadata
# Allows overriding the automation flag.
experimental command setAutomationOverride
parameters
# Whether the override should be enabled.
boolean enabled
# Allows overriding the difference between the small and large viewport sizes, which determine the
# value of the `svh` and `lvh` unit, respectively. Only supported for top-level frames.
experimental command setSmallViewportHeightDifferenceOverride
parameters
# This will cause an element of size 100svh to be `difference` pixels smaller than an element
# of size 100lvh.
integer difference
# Returns device's screen configuration.
experimental command getScreenInfos
returns
array of ScreenInfo screenInfos
# Add a new screen to the device. Only supported in headless mode.
experimental command addScreen
parameters
# Offset of the left edge of the screen in pixels.
integer left
# Offset of the top edge of the screen in pixels.
integer top
# The width of the screen in pixels.
integer width
# The height of the screen in pixels.
integer height
# Specifies the screen's work area. Default is entire screen.
optional WorkAreaInsets workAreaInsets
# Specifies the screen's device pixel ratio. Default is 1.
optional number devicePixelRatio
# Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270. Default is 0.
optional integer rotation
# Specifies the screen's color depth in bits. Default is 24.
optional integer colorDepth
# Specifies the descriptive label for the screen. Default is none.
optional string label
# Indicates whether the screen is internal to the device or external, attached to the device. Default is false.
optional boolean isInternal
returns
ScreenInfo screenInfo
# Remove screen from the device. Only supported in headless mode.
experimental command removeScreen
parameters
ScreenId screenId

View File

@@ -0,0 +1,24 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# EventBreakpoints permits setting JavaScript breakpoints on operations and events
# occurring in native code invoked from JavaScript. Once breakpoint is hit, it is
# reported through Debugger domain, similarly to regular breakpoints being hit.
experimental domain EventBreakpoints
# Sets breakpoint on particular native event.
command setInstrumentationBreakpoint
parameters
# Instrumentation name to stop on.
string eventName
# Removes breakpoint on particular native event.
command removeInstrumentationBreakpoint
parameters
# Instrumentation name to stop on.
string eventName
# Removes all breakpoints
command disable

View File

@@ -0,0 +1,72 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Defines commands and events for browser extensions.
experimental domain Extensions
# Storage areas.
type StorageArea extends string
enum
session
local
sync
managed
# Installs an unpacked extension from the filesystem similar to
# --load-extension CLI flags. Returns extension ID once the extension
# has been installed. Available if the client is connected using the
# --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
# flag is set.
command loadUnpacked
parameters
# Absolute file path.
string path
returns
# Extension id.
string id
# Uninstalls an unpacked extension (others not supported) from the profile.
# Available if the client is connected using the --remote-debugging-pipe flag
# and the --enable-unsafe-extension-debugging.
command uninstall
parameters
# Extension id.
string id
# Gets data from extension storage in the given `storageArea`. If `keys` is
# specified, these are used to filter the result.
command getStorageItems
parameters
# ID of extension.
string id
# StorageArea to retrieve data from.
StorageArea storageArea
# Keys to retrieve.
optional array of string keys
returns
object data
# Removes `keys` from extension storage in the given `storageArea`.
command removeStorageItems
parameters
# ID of extension.
string id
# StorageArea to remove data from.
StorageArea storageArea
# Keys to remove.
array of string keys
# Clears extension storage in the given `storageArea`.
command clearStorageItems
parameters
# ID of extension.
string id
# StorageArea to remove data from.
StorageArea storageArea
# Sets `values` in extension storage in the given `storageArea`. The provided `values`
# will be merged with existing values in the storage area.
command setStorageItems
parameters
# ID of extension.
string id
# StorageArea to set data in.
StorageArea storageArea
# Values to set.
object values

100
node_modules/devtools-protocol/pdl/domains/FedCm.pdl generated vendored Normal file
View File

@@ -0,0 +1,100 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows interacting with the FedCM dialog.
experimental domain FedCm
# Whether this is a sign-up or sign-in action for this account, i.e.
# whether this account has ever been used to sign in to this RP before.
type LoginState extends string
enum
SignIn
SignUp
# The types of FedCM dialogs.
type DialogType extends string
enum
AccountChooser
AutoReauthn
ConfirmIdpLogin
Error
# The buttons on the FedCM dialog.
type DialogButton extends string
enum
ConfirmIdpLoginContinue
ErrorGotIt
ErrorMoreDetails
# The URLs that each account has
type AccountUrlType extends string
enum
TermsOfService
PrivacyPolicy
# Corresponds to IdentityRequestAccount
type Account extends object
properties
string accountId
string email
string name
string givenName
string pictureUrl
string idpConfigUrl
string idpLoginUrl
LoginState loginState
# These two are only set if the loginState is signUp
optional string termsOfServiceUrl
optional string privacyPolicyUrl
event dialogShown
parameters
string dialogId
DialogType dialogType
array of Account accounts
# These exist primarily so that the caller can verify the
# RP context was used appropriately.
string title
optional string subtitle
# Triggered when a dialog is closed, either by user action, JS abort,
# or a command below.
event dialogClosed
parameters
string dialogId
command enable
parameters
# Allows callers to disable the promise rejection delay that would
# normally happen, if this is unimportant to what's being tested.
# (step 4 of https://fedidcg.github.io/FedCM/#browser-api-rp-sign-in)
optional boolean disableRejectionDelay
command disable
command selectAccount
parameters
string dialogId
integer accountIndex
command clickDialogButton
parameters
string dialogId
DialogButton dialogButton
command openUrl
parameters
string dialogId
integer accountIndex
AccountUrlType accountUrlType
command dismissDialog
parameters
string dialogId
optional boolean triggerCooldown
# Resets the cooldown time, if any, to allow the next FedCM call to show
# a dialog even if one was recently dismissed by the user.
command resetCooldown

251
node_modules/devtools-protocol/pdl/domains/Fetch.pdl generated vendored Normal file
View File

@@ -0,0 +1,251 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# A domain for letting clients substitute browser's network layer with client code.
domain Fetch
depends on Network
depends on IO
depends on Page
# Unique request identifier.
# Note that this does not identify individual HTTP requests that are part of
# a network request.
type RequestId extends string
# Stages of the request to handle. Request will intercept before the request is
# sent. Response will intercept after the response is received (but before response
# body is received).
type RequestStage extends string
enum
Request
Response
type RequestPattern extends object
properties
# Wildcards (`'*'` -> zero or more, `'?'` -> exactly one) are allowed. Escape character is
# backslash. Omitting is equivalent to `"*"`.
optional string urlPattern
# If set, only requests for matching resource types will be intercepted.
optional Network.ResourceType resourceType
# Stage at which to begin intercepting requests. Default is Request.
optional RequestStage requestStage
# Response HTTP header entry
type HeaderEntry extends object
properties
string name
string value
# Authorization challenge for HTTP status code 401 or 407.
type AuthChallenge extends object
properties
# Source of the authentication challenge.
optional enum source
Server
Proxy
# Origin of the challenger.
string origin
# The authentication scheme used, such as basic or digest
string scheme
# The realm of the challenge. May be empty.
string realm
# Response to an AuthChallenge.
type AuthChallengeResponse extends object
properties
# The decision on what to do in response to the authorization challenge. Default means
# deferring to the default behavior of the net stack, which will likely either the Cancel
# authentication or display a popup dialog box.
enum response
Default
CancelAuth
ProvideCredentials
# The username to provide, possibly empty. Should only be set if response is
# ProvideCredentials.
optional string username
# The password to provide, possibly empty. Should only be set if response is
# ProvideCredentials.
optional string password
# Disables the fetch domain.
command disable
# Enables issuing of requestPaused events. A request will be paused until client
# calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
command enable
parameters
# If specified, only requests matching any of these patterns will produce
# fetchRequested event and will be paused until clients response. If not set,
# all requests will be affected.
optional array of RequestPattern patterns
# If true, authRequired events will be issued and requests will be paused
# expecting a call to continueWithAuth.
optional boolean handleAuthRequests
# Causes the request to fail with specified reason.
command failRequest
parameters
# An id the client received in requestPaused event.
RequestId requestId
# Causes the request to fail with the given reason.
Network.ErrorReason errorReason
# Provides response to the request.
command fulfillRequest
parameters
# An id the client received in requestPaused event.
RequestId requestId
# An HTTP response code.
integer responseCode
# Response headers.
optional array of HeaderEntry responseHeaders
# Alternative way of specifying response headers as a \0-separated
# series of name: value pairs. Prefer the above method unless you
# need to represent some non-UTF8 values that can't be transmitted
# over the protocol as text.
optional binary binaryResponseHeaders
# A response body. If absent, original response body will be used if
# the request is intercepted at the response stage and empty body
# will be used if the request is intercepted at the request stage.
optional binary body
# A textual representation of responseCode.
# If absent, a standard phrase matching responseCode is used.
optional string responsePhrase
# Continues the request, optionally modifying some of its parameters.
command continueRequest
parameters
# An id the client received in requestPaused event.
RequestId requestId
# If set, the request url will be modified in a way that's not observable by page.
optional string url
# If set, the request method is overridden.
optional string method
# If set, overrides the post data in the request.
optional binary postData
# If set, overrides the request headers. Note that the overrides do not
# extend to subsequent redirect hops, if a redirect happens. Another override
# may be applied to a different request produced by a redirect.
optional array of HeaderEntry headers
# If set, overrides response interception behavior for this request.
experimental optional boolean interceptResponse
# Continues a request supplying authChallengeResponse following authRequired event.
command continueWithAuth
parameters
# An id the client received in authRequired event.
RequestId requestId
# Response to with an authChallenge.
AuthChallengeResponse authChallengeResponse
# Continues loading of the paused response, optionally modifying the
# response headers. If either responseCode or headers are modified, all of them
# must be present.
experimental command continueResponse
parameters
# An id the client received in requestPaused event.
RequestId requestId
# An HTTP response code. If absent, original response code will be used.
optional integer responseCode
# A textual representation of responseCode.
# If absent, a standard phrase matching responseCode is used.
optional string responsePhrase
# Response headers. If absent, original response headers will be used.
optional array of HeaderEntry responseHeaders
# Alternative way of specifying response headers as a \0-separated
# series of name: value pairs. Prefer the above method unless you
# need to represent some non-UTF8 values that can't be transmitted
# over the protocol as text.
optional binary binaryResponseHeaders
# Causes the body of the response to be received from the server and
# returned as a single string. May only be issued for a request that
# is paused in the Response stage and is mutually exclusive with
# takeResponseBodyForInterceptionAsStream. Calling other methods that
# affect the request or disabling fetch domain before body is received
# results in an undefined behavior.
# Note that the response body is not available for redirects. Requests
# paused in the _redirect received_ state may be differentiated by
# `responseCode` and presence of `location` response header, see
# comments to `requestPaused` for details.
command getResponseBody
parameters
# Identifier for the intercepted request to get body for.
RequestId requestId
returns
# Response body.
string body
# True, if content was sent as base64.
boolean base64Encoded
# Returns a handle to the stream representing the response body.
# The request must be paused in the HeadersReceived stage.
# Note that after this command the request can't be continued
# as is -- client either needs to cancel it or to provide the
# response body.
# The stream only supports sequential read, IO.read will fail if the position
# is specified.
# This method is mutually exclusive with getResponseBody.
# Calling other methods that affect the request or disabling fetch
# domain before body is received results in an undefined behavior.
command takeResponseBodyAsStream
parameters
RequestId requestId
returns
IO.StreamHandle stream
# Issued when the domain is enabled and the request URL matches the
# specified filter. The request is paused until the client responds
# with one of continueRequest, failRequest or fulfillRequest.
# The stage of the request can be determined by presence of responseErrorReason
# and responseStatusCode -- the request is at the response stage if either
# of these fields is present and in the request stage otherwise.
# Redirect responses and subsequent requests are reported similarly to regular
# responses and requests. Redirect responses may be distinguished by the value
# of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
# presence of the `location` header. Requests resulting from a redirect will
# have `redirectedRequestId` field set.
event requestPaused
parameters
# Each request the page makes will have a unique id.
RequestId requestId
# The details of the request.
Network.Request request
# The id of the frame that initiated the request.
Page.FrameId frameId
# How the requested resource will be used.
Network.ResourceType resourceType
# Response error if intercepted at response stage.
optional Network.ErrorReason responseErrorReason
# Response code if intercepted at response stage.
optional integer responseStatusCode
# Response status text if intercepted at response stage.
optional string responseStatusText
# Response headers if intercepted at the response stage.
optional array of HeaderEntry responseHeaders
# If the intercepted request had a corresponding Network.requestWillBeSent event fired for it,
# then this networkId will be the same as the requestId present in the requestWillBeSent event.
optional Network.RequestId networkId
# If the request is due to a redirect response from the server, the id of the request that
# has caused the redirect.
experimental optional RequestId redirectedRequestId
# Issued when the domain is enabled with handleAuthRequests set to true.
# The request is paused until client responds with continueWithAuth.
event authRequired
parameters
# Each request the page makes will have a unique id.
RequestId requestId
# The details of the request.
Network.Request request
# The id of the frame that initiated the request.
Page.FrameId frameId
# How the requested resource will be used.
Network.ResourceType resourceType
# Details of the Authorization Challenge encountered.
# If this is set, client should respond with continueRequest that
# contains AuthChallengeResponse.
AuthChallenge authChallenge

View File

@@ -0,0 +1,41 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain FileSystem
depends on Network
depends on Storage
type File extends object
properties
string name
# Timestamp
Network.TimeSinceEpoch lastModified
# Size in bytes
number size
string type
type Directory extends object
properties
string name
array of string nestedDirectories
# Files that are directly nested under this directory.
array of File nestedFiles
type BucketFileSystemLocator extends object
properties
# Storage key
Storage.SerializedStorageKey storageKey
# Bucket name. Not passing a `bucketName` will retrieve the default Bucket. (https://developer.mozilla.org/en-US/docs/Web/API/Storage_API#storage_buckets)
optional string bucketName
# Path to the directory using each path component as an array item.
array of string pathComponents
command getDirectory
parameters
BucketFileSystemLocator bucketFileSystemLocator
returns
# Returns the directory object at the path.
Directory directory

View File

@@ -0,0 +1,56 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain provides experimental commands only supported in headless mode.
experimental domain HeadlessExperimental
depends on Page
depends on Runtime
# Encoding options for a screenshot.
type ScreenshotParams extends object
properties
# Image compression format (defaults to png).
optional enum format
jpeg
png
webp
# Compression quality from range [0..100] (jpeg and webp only).
optional integer quality
# Optimize image encoding for speed, not for resulting size (defaults to false)
optional boolean optimizeForSpeed
# Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
# screenshot from the resulting frame. Requires that the target was created with enabled
# BeginFrameControl. Designed for use with --run-all-compositor-stages-before-draw, see also
# https://goo.gle/chrome-headless-rendering for more background.
command beginFrame
parameters
# Timestamp of this BeginFrame in Renderer TimeTicks (milliseconds of uptime). If not set,
# the current time will be used.
optional number frameTimeTicks
# The interval between BeginFrames that is reported to the compositor, in milliseconds.
# Defaults to a 60 frames/second interval, i.e. about 16.666 milliseconds.
optional number interval
# Whether updates should not be committed and drawn onto the display. False by default. If
# true, only side effects of the BeginFrame will be run, such as layout and animations, but
# any visual updates may not be visible on the display or in screenshots.
optional boolean noDisplayUpdates
# If set, a screenshot of the frame will be captured and returned in the response. Otherwise,
# no screenshot will be captured. Note that capturing a screenshot can fail, for example,
# during renderer initialization. In such a case, no screenshot data will be returned.
optional ScreenshotParams screenshot
returns
# Whether the BeginFrame resulted in damage and, thus, a new frame was committed to the
# display. Reported for diagnostic uses, may be removed in the future.
boolean hasDamage
# Base64-encoded image data of the screenshot, if one was requested and successfully taken.
optional binary screenshotData
# Disables headless events for the target.
deprecated command disable
# Enables headless events for the target.
deprecated command enable

45
node_modules/devtools-protocol/pdl/domains/IO.pdl generated vendored Normal file
View File

@@ -0,0 +1,45 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Input/Output operations for streams produced by DevTools.
domain IO
# This is either obtained from another method or specified as `blob:<uuid>` where
# `<uuid>` is an UUID of a Blob.
type StreamHandle extends string
# Close the stream, discard any temporary backing storage.
command close
parameters
# Handle of the stream to close.
StreamHandle handle
# Read a chunk of the stream
command read
parameters
# Handle of the stream to read.
StreamHandle handle
# Seek to the specified offset before reading (if not specified, proceed with offset
# following the last read). Some types of streams may only support sequential reads.
optional integer offset
# Maximum number of bytes to read (left upon the agent discretion if not specified).
optional integer size
returns
# Set if the data is base64-encoded
optional boolean base64Encoded
# Data that were read.
string data
# Set if the end-of-file condition occurred while reading.
boolean eof
# Return UUID of Blob object specified by a remote object id.
command resolveBlob
parameters
# Object id of a Blob object wrapper.
Runtime.RemoteObjectId objectId
returns
# UUID of the specified Blob.
string uuid

View File

@@ -0,0 +1,226 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain IndexedDB
depends on Runtime
depends on Storage
# Database with an array of object stores.
type DatabaseWithObjectStores extends object
properties
# Database name.
string name
# Database version (type is not 'integer', as the standard
# requires the version number to be 'unsigned long long')
number version
# Object stores in this database.
array of ObjectStore objectStores
# Object store.
type ObjectStore extends object
properties
# Object store name.
string name
# Object store key path.
KeyPath keyPath
# If true, object store has auto increment flag set.
boolean autoIncrement
# Indexes in this object store.
array of ObjectStoreIndex indexes
# Object store index.
type ObjectStoreIndex extends object
properties
# Index name.
string name
# Index key path.
KeyPath keyPath
# If true, index is unique.
boolean unique
# If true, index allows multiple entries for a key.
boolean multiEntry
# Key.
type Key extends object
properties
# Key type.
enum type
number
string
date
array
# Number value.
optional number number
# String value.
optional string string
# Date value.
optional number date
# Array value.
optional array of Key array
# Key range.
type KeyRange extends object
properties
# Lower bound.
optional Key lower
# Upper bound.
optional Key upper
# If true lower bound is open.
boolean lowerOpen
# If true upper bound is open.
boolean upperOpen
# Data entry.
type DataEntry extends object
properties
# Key object.
Runtime.RemoteObject key
# Primary key object.
Runtime.RemoteObject primaryKey
# Value object.
Runtime.RemoteObject value
# Key path.
type KeyPath extends object
properties
# Key path type.
enum type
null
string
array
# String value.
optional string string
# Array value.
optional array of string array
# Clears all entries from an object store.
command clearObjectStore
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
string objectStoreName
# Deletes a database.
command deleteDatabase
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Delete a range of entries from an object store
command deleteObjectStoreEntries
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
string databaseName
string objectStoreName
# Range of entry keys to delete
KeyRange keyRange
# Disables events from backend.
command disable
# Enables events from backend.
command enable
# Requests data from object store or index.
command requestData
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
string objectStoreName
# Index name. If not specified, it performs an object store data request.
optional string indexName
# Number of records to skip.
integer skipCount
# Number of records to fetch.
integer pageSize
# Key range.
optional KeyRange keyRange
returns
# Array of object store data entries.
array of DataEntry objectStoreDataEntries
# If true, there are more entries to fetch in the given range.
boolean hasMore
# Gets metadata of an object store.
command getMetadata
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
# Object store name.
string objectStoreName
returns
# the entries count
number entriesCount
# the current value of key generator, to become the next inserted
# key into the object store. Valid if objectStore.autoIncrement
# is true.
number keyGeneratorValue
# Requests database with given name in given frame.
command requestDatabase
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
# Database name.
string databaseName
returns
# Database with an array of object stores.
DatabaseWithObjectStores databaseWithObjectStores
# Requests database names for given security origin.
command requestDatabaseNames
parameters
# At least and at most one of securityOrigin, storageKey, or storageBucket must be specified.
# Security origin.
optional string securityOrigin
# Storage key.
optional string storageKey
# Storage bucket. If not specified, it uses the default bucket.
optional Storage.StorageBucket storageBucket
returns
# Database names for origin.
array of string databaseNames

336
node_modules/devtools-protocol/pdl/domains/Input.pdl generated vendored Normal file
View File

@@ -0,0 +1,336 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
domain Input
type TouchPoint extends object
properties
# X coordinate of the event relative to the main frame's viewport in CSS pixels.
number x
# Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
# the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
number y
# X radius of the touch area (default: 1.0).
optional number radiusX
# Y radius of the touch area (default: 1.0).
optional number radiusY
# Rotation angle (default: 0.0).
optional number rotationAngle
# Force (default: 1.0).
optional number force
# The normalized tangential pressure, which has a range of [-1,1] (default: 0).
experimental optional number tangentialPressure
# The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0)
optional number tiltX
# The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
optional number tiltY
# The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
experimental optional integer twist
# Identifier used to track touch sources between events, must be unique within an event.
optional number id
experimental type GestureSourceType extends string
enum
default
touch
mouse
type MouseButton extends string
enum
none
left
middle
right
back
forward
# UTC time in seconds, counted from January 1, 1970.
type TimeSinceEpoch extends number
experimental type DragDataItem extends object
properties
# Mime type of the dragged data.
string mimeType
# Depending of the value of `mimeType`, it contains the dragged link,
# text, HTML markup or any other data.
string data
# Title associated with a link. Only valid when `mimeType` == "text/uri-list".
optional string title
# Stores the base URL for the contained markup. Only valid when `mimeType`
# == "text/html".
optional string baseURL
experimental type DragData extends object
properties
array of DragDataItem items
# List of filenames that should be included when dropping
optional array of string files
# Bit field representing allowed drag operations. Copy = 1, Link = 2, Move = 16
integer dragOperationsMask
# Dispatches a drag event into the page.
experimental command dispatchDragEvent
parameters
# Type of the drag event.
enum type
dragEnter
dragOver
drop
dragCancel
# X coordinate of the event relative to the main frame's viewport in CSS pixels.
number x
# Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
# the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
number y
DragData data
# Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
# (default: 0).
optional integer modifiers
# Dispatches a key event to the page.
command dispatchKeyEvent
parameters
# Type of the key event.
enum type
keyDown
keyUp
rawKeyDown
char
# Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
# (default: 0).
optional integer modifiers
# Time at which the event occurred.
optional TimeSinceEpoch timestamp
# Text as generated by processing a virtual key code with a keyboard layout. Not needed for
# for `keyUp` and `rawKeyDown` events (default: "")
optional string text
# Text that would have been generated by the keyboard if no modifiers were pressed (except for
# shift). Useful for shortcut (accelerator) key handling (default: "").
optional string unmodifiedText
# Unique key identifier (e.g., 'U+0041') (default: "").
optional string keyIdentifier
# Unique DOM defined string value for each physical key (e.g., 'KeyA') (default: "").
optional string code
# Unique DOM defined string value describing the meaning of the key in the context of active
# modifiers, keyboard layout, etc (e.g., 'AltGr') (default: "").
optional string key
# Windows virtual key code (default: 0).
optional integer windowsVirtualKeyCode
# Native virtual key code (default: 0).
optional integer nativeVirtualKeyCode
# Whether the event was generated from auto repeat (default: false).
optional boolean autoRepeat
# Whether the event was generated from the keypad (default: false).
optional boolean isKeypad
# Whether the event was a system key event (default: false).
optional boolean isSystemKey
# Whether the event was from the left or right side of the keyboard. 1=Left, 2=Right (default:
# 0).
optional integer location
# Editing commands to send with the key event (e.g., 'selectAll') (default: []).
# These are related to but not equal the command names used in `document.execCommand` and NSStandardKeyBindingResponding.
# See https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/editing/commands/editor_command_names.h for valid command names.
experimental optional array of string commands
# This method emulates inserting text that doesn't come from a key press,
# for example an emoji keyboard or an IME.
experimental command insertText
parameters
# The text to insert.
string text
# This method sets the current candidate text for IME.
# Use imeCommitComposition to commit the final text.
# Use imeSetComposition with empty string as text to cancel composition.
experimental command imeSetComposition
parameters
# The text to insert
string text
# selection start
integer selectionStart
# selection end
integer selectionEnd
# replacement start
optional integer replacementStart
# replacement end
optional integer replacementEnd
# Dispatches a mouse event to the page.
command dispatchMouseEvent
parameters
# Type of the mouse event.
enum type
mousePressed
mouseReleased
mouseMoved
mouseWheel
# X coordinate of the event relative to the main frame's viewport in CSS pixels.
number x
# Y coordinate of the event relative to the main frame's viewport in CSS pixels. 0 refers to
# the top of the viewport and Y increases as it proceeds towards the bottom of the viewport.
number y
# Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
# (default: 0).
optional integer modifiers
# Time at which the event occurred.
optional TimeSinceEpoch timestamp
# Mouse button (default: "none").
optional MouseButton button
# A number indicating which buttons are pressed on the mouse when a mouse event is triggered.
# Left=1, Right=2, Middle=4, Back=8, Forward=16, None=0.
optional integer buttons
# Number of times the mouse button was clicked (default: 0).
optional integer clickCount
# The normalized pressure, which has a range of [0,1] (default: 0).
experimental optional number force
# The normalized tangential pressure, which has a range of [-1,1] (default: 0).
experimental optional number tangentialPressure
# The plane angle between the Y-Z plane and the plane containing both the stylus axis and the Y axis, in degrees of the range [-90,90], a positive tiltX is to the right (default: 0).
optional number tiltX
# The plane angle between the X-Z plane and the plane containing both the stylus axis and the X axis, in degrees of the range [-90,90], a positive tiltY is towards the user (default: 0).
optional number tiltY
# The clockwise rotation of a pen stylus around its own major axis, in degrees in the range [0,359] (default: 0).
experimental optional integer twist
# X delta in CSS pixels for mouse wheel event (default: 0).
optional number deltaX
# Y delta in CSS pixels for mouse wheel event (default: 0).
optional number deltaY
# Pointer type (default: "mouse").
optional enum pointerType
mouse
pen
# Dispatches a touch event to the page.
command dispatchTouchEvent
parameters
# Type of the touch event. TouchEnd and TouchCancel must not contain any touch points, while
# TouchStart and TouchMove must contains at least one.
enum type
touchStart
touchEnd
touchMove
touchCancel
# Active touch points on the touch device. One event per any changed point (compared to
# previous touch event in a sequence) is generated, emulating pressing/moving/releasing points
# one by one.
array of TouchPoint touchPoints
# Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
# (default: 0).
optional integer modifiers
# Time at which the event occurred.
optional TimeSinceEpoch timestamp
# Cancels any active dragging in the page.
command cancelDragging
# Emulates touch event from the mouse event parameters.
experimental command emulateTouchFromMouseEvent
parameters
# Type of the mouse event.
enum type
mousePressed
mouseReleased
mouseMoved
mouseWheel
# X coordinate of the mouse pointer in DIP.
integer x
# Y coordinate of the mouse pointer in DIP.
integer y
# Mouse button. Only "none", "left", "right" are supported.
MouseButton button
# Time at which the event occurred (default: current time).
optional TimeSinceEpoch timestamp
# X delta in DIP for mouse wheel event (default: 0).
optional number deltaX
# Y delta in DIP for mouse wheel event (default: 0).
optional number deltaY
# Bit field representing pressed modifier keys. Alt=1, Ctrl=2, Meta/Command=4, Shift=8
# (default: 0).
optional integer modifiers
# Number of times the mouse button was clicked (default: 0).
optional integer clickCount
# Ignores input events (useful while auditing page).
command setIgnoreInputEvents
parameters
# Ignores input events processing when set to true.
boolean ignore
# Prevents default drag and drop behavior and instead emits `Input.dragIntercepted` events.
# Drag and drop behavior can be directly controlled via `Input.dispatchDragEvent`.
experimental command setInterceptDrags
parameters
boolean enabled
# Synthesizes a pinch gesture over a time period by issuing appropriate touch events.
experimental command synthesizePinchGesture
parameters
# X coordinate of the start of the gesture in CSS pixels.
number x
# Y coordinate of the start of the gesture in CSS pixels.
number y
# Relative scale factor after zooming (>1.0 zooms in, <1.0 zooms out).
number scaleFactor
# Relative pointer speed in pixels per second (default: 800).
optional integer relativeSpeed
# Which type of input events to be generated (default: 'default', which queries the platform
# for the preferred input type).
optional GestureSourceType gestureSourceType
# Synthesizes a scroll gesture over a time period by issuing appropriate touch events.
experimental command synthesizeScrollGesture
parameters
# X coordinate of the start of the gesture in CSS pixels.
number x
# Y coordinate of the start of the gesture in CSS pixels.
number y
# The distance to scroll along the X axis (positive to scroll left).
optional number xDistance
# The distance to scroll along the Y axis (positive to scroll up).
optional number yDistance
# The number of additional pixels to scroll back along the X axis, in addition to the given
# distance.
optional number xOverscroll
# The number of additional pixels to scroll back along the Y axis, in addition to the given
# distance.
optional number yOverscroll
# Prevent fling (default: true).
optional boolean preventFling
# Swipe speed in pixels per second (default: 800).
optional integer speed
# Which type of input events to be generated (default: 'default', which queries the platform
# for the preferred input type).
optional GestureSourceType gestureSourceType
# The number of times to repeat the gesture (default: 0).
optional integer repeatCount
# The number of milliseconds delay between each repeat. (default: 250).
optional integer repeatDelayMs
# The name of the interaction markers to generate, if not empty (default: "").
optional string interactionMarkerName
# Synthesizes a tap gesture over a time period by issuing appropriate touch events.
experimental command synthesizeTapGesture
parameters
# X coordinate of the start of the gesture in CSS pixels.
number x
# Y coordinate of the start of the gesture in CSS pixels.
number y
# Duration between touchdown and touchup events in ms (default: 50).
optional integer duration
# Number of times to perform the tap (e.g. 2 for double tap, default: 1).
optional integer tapCount
# Which type of input events to be generated (default: 'default', which queries the platform
# for the preferred input type).
optional GestureSourceType gestureSourceType
# Emitted only when `Input.setInterceptDrags` is enabled. Use this data with `Input.dispatchDragEvent` to
# restore normal drag and drop behavior.
experimental event dragIntercepted
parameters
DragData data

View File

@@ -0,0 +1,28 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Inspector
# Disables inspector domain notifications.
command disable
# Enables inspector domain notifications.
command enable
# Fired when remote debugging connection is about to be terminated. Contains detach reason.
event detached
parameters
# The reason why connection has been terminated.
string reason
# Fired when debugging target has crashed
event targetCrashed
# Fired when debugging target has reloaded after crash
event targetReloadedAfterCrash
# Fired on worker targets when main worker script and any imported scripts have been evaluated.
experimental event workerScriptLoaded

View File

@@ -0,0 +1,178 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain LayerTree
depends on DOM
# Unique Layer identifier.
type LayerId extends string
# Unique snapshot identifier.
type SnapshotId extends string
# Rectangle where scrolling happens on the main thread.
type ScrollRect extends object
properties
# Rectangle itself.
DOM.Rect rect
# Reason for rectangle to force scrolling on the main thread
enum type
RepaintsOnScroll
TouchEventHandler
WheelEventHandler
# Sticky position constraints.
type StickyPositionConstraint extends object
properties
# Layout rectangle of the sticky element before being shifted
DOM.Rect stickyBoxRect
# Layout rectangle of the containing block of the sticky element
DOM.Rect containingBlockRect
# The nearest sticky layer that shifts the sticky box
optional LayerId nearestLayerShiftingStickyBox
# The nearest sticky layer that shifts the containing block
optional LayerId nearestLayerShiftingContainingBlock
# Serialized fragment of layer picture along with its offset within the layer.
type PictureTile extends object
properties
# Offset from owning layer left boundary
number x
# Offset from owning layer top boundary
number y
# Base64-encoded snapshot data.
binary picture
# Information about a compositing layer.
type Layer extends object
properties
# The unique id for this layer.
LayerId layerId
# The id of parent (not present for root).
optional LayerId parentLayerId
# The backend id for the node associated with this layer.
optional DOM.BackendNodeId backendNodeId
# Offset from parent layer, X coordinate.
number offsetX
# Offset from parent layer, Y coordinate.
number offsetY
# Layer width.
number width
# Layer height.
number height
# Transformation matrix for layer, default is identity matrix
optional array of number transform
# Transform anchor point X, absent if no transform specified
optional number anchorX
# Transform anchor point Y, absent if no transform specified
optional number anchorY
# Transform anchor point Z, absent if no transform specified
optional number anchorZ
# Indicates how many time this layer has painted.
integer paintCount
# Indicates whether this layer hosts any content, rather than being used for
# transform/scrolling purposes only.
boolean drawsContent
# Set if layer is not visible.
optional boolean invisible
# Rectangles scrolling on main thread only.
optional array of ScrollRect scrollRects
# Sticky position constraint information
optional StickyPositionConstraint stickyPositionConstraint
# Array of timings, one per paint step.
type PaintProfile extends array of number
# Provides the reasons why the given layer was composited.
command compositingReasons
parameters
# The id of the layer for which we want to get the reasons it was composited.
LayerId layerId
returns
# A list of strings specifying reasons for the given layer to become composited.
array of string compositingReasons
# A list of strings specifying reason IDs for the given layer to become composited.
array of string compositingReasonIds
# Disables compositing tree inspection.
command disable
# Enables compositing tree inspection.
command enable
# Returns the snapshot identifier.
command loadSnapshot
parameters
# An array of tiles composing the snapshot.
array of PictureTile tiles
returns
# The id of the snapshot.
SnapshotId snapshotId
# Returns the layer snapshot identifier.
command makeSnapshot
parameters
# The id of the layer.
LayerId layerId
returns
# The id of the layer snapshot.
SnapshotId snapshotId
command profileSnapshot
parameters
# The id of the layer snapshot.
SnapshotId snapshotId
# The maximum number of times to replay the snapshot (1, if not specified).
optional integer minRepeatCount
# The minimum duration (in seconds) to replay the snapshot.
optional number minDuration
# The clip rectangle to apply when replaying the snapshot.
optional DOM.Rect clipRect
returns
# The array of paint profiles, one per run.
array of PaintProfile timings
# Releases layer snapshot captured by the back-end.
command releaseSnapshot
parameters
# The id of the layer snapshot.
SnapshotId snapshotId
# Replays the layer snapshot and returns the resulting bitmap.
command replaySnapshot
parameters
# The id of the layer snapshot.
SnapshotId snapshotId
# The first step to replay from (replay from the very start if not specified).
optional integer fromStep
# The last step to replay to (replay till the end if not specified).
optional integer toStep
# The scale to apply while replaying (defaults to 1).
optional number scale
returns
# A data: URL for resulting image.
string dataURL
# Replays the layer snapshot and returns canvas log.
command snapshotCommandLog
parameters
# The id of the layer snapshot.
SnapshotId snapshotId
returns
# The array of canvas function calls.
array of object commandLog
event layerPainted
parameters
# The id of the painted layer.
LayerId layerId
# Clip rectangle.
DOM.Rect clip
event layerTreeDidChange
parameters
# Layer tree, absent if not in the compositing mode.
optional array of Layer layers

93
node_modules/devtools-protocol/pdl/domains/Log.pdl generated vendored Normal file
View File

@@ -0,0 +1,93 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Provides access to log entries.
domain Log
depends on Runtime
depends on Network
# Log entry.
type LogEntry extends object
properties
# Log entry source.
enum source
xml
javascript
network
storage
appcache
rendering
security
deprecation
worker
violation
intervention
recommendation
other
# Log entry severity.
enum level
verbose
info
warning
error
# Logged text.
string text
optional enum category
cors
# Timestamp when this entry was added.
Runtime.Timestamp timestamp
# URL of the resource if known.
optional string url
# Line number in the resource.
optional integer lineNumber
# JavaScript stack trace.
optional Runtime.StackTrace stackTrace
# Identifier of the network request associated with this entry.
optional Network.RequestId networkRequestId
# Identifier of the worker associated with this entry.
optional string workerId
# Call arguments.
optional array of Runtime.RemoteObject args
# Violation configuration setting.
type ViolationSetting extends object
properties
# Violation type.
enum name
longTask
longLayout
blockedEvent
blockedParser
discouragedAPIUse
handler
recurringHandler
# Time threshold to trigger upon.
number threshold
# Clears the log.
command clear
# Disables log domain, prevents further log entries from being reported to the client.
command disable
# Enables log domain, sends the entries collected so far to the client by means of the
# `entryAdded` notification.
command enable
# start violation reporting.
command startViolationsReport
parameters
# Configuration for violations.
array of ViolationSetting config
# Stop violation reporting.
command stopViolationsReport
# Issued when new message was logged.
event entryAdded
parameters
# The entry.
LogEntry entry

111
node_modules/devtools-protocol/pdl/domains/Media.pdl generated vendored Normal file
View File

@@ -0,0 +1,111 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows detailed inspection of media elements.
experimental domain Media
# Players will get an ID that is unique within the agent context.
type PlayerId extends string
type Timestamp extends number
# Have one type per entry in MediaLogRecord::Type
# Corresponds to kMessage
type PlayerMessage extends object
properties
# Keep in sync with MediaLogMessageLevel
# We are currently keeping the message level 'error' separate from the
# PlayerError type because right now they represent different things,
# this one being a DVLOG(ERROR) style log message that gets printed
# based on what log level is selected in the UI, and the other is a
# representation of a media::PipelineStatus object. Soon however we're
# going to be moving away from using PipelineStatus for errors and
# introducing a new error type which should hopefully let us integrate
# the error log level into the PlayerError type.
enum level
error
warning
info
debug
string message
# Corresponds to kMediaPropertyChange
type PlayerProperty extends object
properties
string name
string value
# Corresponds to kMediaEventTriggered
type PlayerEvent extends object
properties
Timestamp timestamp
string value
# Represents logged source line numbers reported in an error.
# NOTE: file and line are from chromium c++ implementation code, not js.
type PlayerErrorSourceLocation extends object
properties
string file
integer line
# Corresponds to kMediaError
type PlayerError extends object
properties
string errorType
# Code is the numeric enum entry for a specific set of error codes, such
# as PipelineStatusCodes in media/base/pipeline_status.h
integer code
# A trace of where this error was caused / where it passed through.
array of PlayerErrorSourceLocation stack
# Errors potentially have a root cause error, ie, a DecoderError might be
# caused by an WindowsError
array of PlayerError cause
# Extra data attached to an error, such as an HRESULT, Video Codec, etc.
object data
type Player extends object
properties
PlayerId playerId
optional DOM.BackendNodeId domNodeId
# This can be called multiple times, and can be used to set / override /
# remove player properties. A null propValue indicates removal.
event playerPropertiesChanged
parameters
PlayerId playerId
array of PlayerProperty properties
# Send events as a list, allowing them to be batched on the browser for less
# congestion. If batched, events must ALWAYS be in chronological order.
event playerEventsAdded
parameters
PlayerId playerId
array of PlayerEvent events
# Send a list of any messages that need to be delivered.
event playerMessagesLogged
parameters
PlayerId playerId
array of PlayerMessage messages
# Send a list of any errors that need to be delivered.
event playerErrorsRaised
parameters
PlayerId playerId
array of PlayerError errors
# Called whenever a player is created, or when a new agent joins and receives
# a list of active players. If an agent is restored, it will receive one
# event for each active player.
event playerCreated
parameters
Player player
# Enables the Media domain
command enable
# Disables the Media domain.
command disable

112
node_modules/devtools-protocol/pdl/domains/Memory.pdl generated vendored Normal file
View File

@@ -0,0 +1,112 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Memory
# Memory pressure level.
type PressureLevel extends string
enum
moderate
critical
# Retruns current DOM object counters.
command getDOMCounters
returns
integer documents
integer nodes
integer jsEventListeners
# Retruns DOM object counters after preparing renderer for leak detection.
command getDOMCountersForLeakDetection
returns
# DOM object counters.
array of DOMCounter counters
# Prepares for leak detection by terminating workers, stopping spellcheckers,
# dropping non-essential internal caches, running garbage collections, etc.
command prepareForLeakDetection
# Simulate OomIntervention by purging V8 memory.
command forciblyPurgeJavaScriptMemory
# Enable/disable suppressing memory pressure notifications in all processes.
command setPressureNotificationsSuppressed
parameters
# If true, memory pressure notifications will be suppressed.
boolean suppressed
# Simulate a memory pressure notification in all processes.
command simulatePressureNotification
parameters
# Memory pressure level of the notification.
PressureLevel level
# Start collecting native memory profile.
command startSampling
parameters
# Average number of bytes between samples.
optional integer samplingInterval
# Do not randomize intervals between samples.
optional boolean suppressRandomness
# Stop collecting native memory profile.
command stopSampling
# Retrieve native memory allocations profile
# collected since renderer process startup.
command getAllTimeSamplingProfile
returns
SamplingProfile profile
# Retrieve native memory allocations profile
# collected since browser process startup.
command getBrowserSamplingProfile
returns
SamplingProfile profile
# Retrieve native memory allocations profile collected since last
# `startSampling` call.
command getSamplingProfile
returns
SamplingProfile profile
# Heap profile sample.
type SamplingProfileNode extends object
properties
# Size of the sampled allocation.
number size
# Total bytes attributed to this sample.
number total
# Execution stack at the point of allocation.
array of string stack
# Array of heap profile samples.
type SamplingProfile extends object
properties
array of SamplingProfileNode samples
array of Module modules
# Executable module information
type Module extends object
properties
# Name of the module.
string name
# UUID of the module.
string uuid
# Base address where the module is loaded into memory. Encoded as a decimal
# or hexadecimal (0x prefixed) string.
string baseAddress
# Size of the module in bytes.
number size
# DOM object counter data.
type DOMCounter extends object
properties
# Object name. Note: object names should be presumed volatile and clients should not expect
# the returned names to be consistent across runs.
string name
# Object count.
integer count

2340
node_modules/devtools-protocol/pdl/domains/Network.pdl generated vendored Normal file

File diff suppressed because it is too large Load Diff

498
node_modules/devtools-protocol/pdl/domains/Overlay.pdl generated vendored Normal file
View File

@@ -0,0 +1,498 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain provides various functionality related to drawing atop the inspected page.
experimental domain Overlay
depends on DOM
depends on Page
depends on Runtime
# Configuration data for drawing the source order of an elements children.
type SourceOrderConfig extends object
properties
# the color to outline the given element in.
DOM.RGBA parentOutlineColor
# the color to outline the child elements in.
DOM.RGBA childOutlineColor
# Configuration data for the highlighting of Grid elements.
type GridHighlightConfig extends object
properties
# Whether the extension lines from grid cells to the rulers should be shown (default: false).
optional boolean showGridExtensionLines
# Show Positive line number labels (default: false).
optional boolean showPositiveLineNumbers
# Show Negative line number labels (default: false).
optional boolean showNegativeLineNumbers
# Show area name labels (default: false).
optional boolean showAreaNames
# Show line name labels (default: false).
optional boolean showLineNames
# Show track size labels (default: false).
optional boolean showTrackSizes
# The grid container border highlight color (default: transparent).
optional DOM.RGBA gridBorderColor
# The cell border color (default: transparent). Deprecated, please use rowLineColor and columnLineColor instead.
deprecated optional DOM.RGBA cellBorderColor
# The row line color (default: transparent).
optional DOM.RGBA rowLineColor
# The column line color (default: transparent).
optional DOM.RGBA columnLineColor
# Whether the grid border is dashed (default: false).
optional boolean gridBorderDash
# Whether the cell border is dashed (default: false). Deprecated, please us rowLineDash and columnLineDash instead.
deprecated optional boolean cellBorderDash
# Whether row lines are dashed (default: false).
optional boolean rowLineDash
# Whether column lines are dashed (default: false).
optional boolean columnLineDash
# The row gap highlight fill color (default: transparent).
optional DOM.RGBA rowGapColor
# The row gap hatching fill color (default: transparent).
optional DOM.RGBA rowHatchColor
# The column gap highlight fill color (default: transparent).
optional DOM.RGBA columnGapColor
# The column gap hatching fill color (default: transparent).
optional DOM.RGBA columnHatchColor
# The named grid areas border color (Default: transparent).
optional DOM.RGBA areaBorderColor
# The grid container background color (Default: transparent).
optional DOM.RGBA gridBackgroundColor
# Configuration data for the highlighting of Flex container elements.
type FlexContainerHighlightConfig extends object
properties
# The style of the container border
optional LineStyle containerBorder
# The style of the separator between lines
optional LineStyle lineSeparator
# The style of the separator between items
optional LineStyle itemSeparator
# Style of content-distribution space on the main axis (justify-content).
optional BoxStyle mainDistributedSpace
# Style of content-distribution space on the cross axis (align-content).
optional BoxStyle crossDistributedSpace
# Style of empty space caused by row gaps (gap/row-gap).
optional BoxStyle rowGapSpace
# Style of empty space caused by columns gaps (gap/column-gap).
optional BoxStyle columnGapSpace
# Style of the self-alignment line (align-items).
optional LineStyle crossAlignment
# Configuration data for the highlighting of Flex item elements.
type FlexItemHighlightConfig extends object
properties
# Style of the box representing the item's base size
optional BoxStyle baseSizeBox
# Style of the border around the box representing the item's base size
optional LineStyle baseSizeBorder
# Style of the arrow representing if the item grew or shrank
optional LineStyle flexibilityArrow
# Style information for drawing a line.
type LineStyle extends object
properties
# The color of the line (default: transparent)
optional DOM.RGBA color
# The line pattern (default: solid)
optional enum pattern
dashed
dotted
# Style information for drawing a box.
type BoxStyle extends object
properties
# The background color for the box (default: transparent)
optional DOM.RGBA fillColor
# The hatching color for the box (default: transparent)
optional DOM.RGBA hatchColor
type ContrastAlgorithm extends string
enum
aa
aaa
apca
# Configuration data for the highlighting of page elements.
type HighlightConfig extends object
properties
# Whether the node info tooltip should be shown (default: false).
optional boolean showInfo
# Whether the node styles in the tooltip (default: false).
optional boolean showStyles
# Whether the rulers should be shown (default: false).
optional boolean showRulers
# Whether the a11y info should be shown (default: true).
optional boolean showAccessibilityInfo
# Whether the extension lines from node to the rulers should be shown (default: false).
optional boolean showExtensionLines
# The content box highlight fill color (default: transparent).
optional DOM.RGBA contentColor
# The padding highlight fill color (default: transparent).
optional DOM.RGBA paddingColor
# The border highlight fill color (default: transparent).
optional DOM.RGBA borderColor
# The margin highlight fill color (default: transparent).
optional DOM.RGBA marginColor
# The event target element highlight fill color (default: transparent).
optional DOM.RGBA eventTargetColor
# The shape outside fill color (default: transparent).
optional DOM.RGBA shapeColor
# The shape margin fill color (default: transparent).
optional DOM.RGBA shapeMarginColor
# The grid layout color (default: transparent).
optional DOM.RGBA cssGridColor
# The color format used to format color styles (default: hex).
optional ColorFormat colorFormat
# The grid layout highlight configuration (default: all transparent).
optional GridHighlightConfig gridHighlightConfig
# The flex container highlight configuration (default: all transparent).
optional FlexContainerHighlightConfig flexContainerHighlightConfig
# The flex item highlight configuration (default: all transparent).
optional FlexItemHighlightConfig flexItemHighlightConfig
# The contrast algorithm to use for the contrast ratio (default: aa).
optional ContrastAlgorithm contrastAlgorithm
# The container query container highlight configuration (default: all transparent).
optional ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
type ColorFormat extends string
enum
rgb
hsl
hwb
hex
# Configurations for Persistent Grid Highlight
type GridNodeHighlightConfig extends object
properties
# A descriptor for the highlight appearance.
GridHighlightConfig gridHighlightConfig
# Identifier of the node to highlight.
DOM.NodeId nodeId
type FlexNodeHighlightConfig extends object
properties
# A descriptor for the highlight appearance of flex containers.
FlexContainerHighlightConfig flexContainerHighlightConfig
# Identifier of the node to highlight.
DOM.NodeId nodeId
type ScrollSnapContainerHighlightConfig extends object
properties
# The style of the snapport border (default: transparent)
optional LineStyle snapportBorder
# The style of the snap area border (default: transparent)
optional LineStyle snapAreaBorder
# The margin highlight fill color (default: transparent).
optional DOM.RGBA scrollMarginColor
# The padding highlight fill color (default: transparent).
optional DOM.RGBA scrollPaddingColor
type ScrollSnapHighlightConfig extends object
properties
# A descriptor for the highlight appearance of scroll snap containers.
ScrollSnapContainerHighlightConfig scrollSnapContainerHighlightConfig
# Identifier of the node to highlight.
DOM.NodeId nodeId
# Configuration for dual screen hinge
type HingeConfig extends object
properties
# A rectangle represent hinge
DOM.Rect rect
# The content box highlight fill color (default: a dark color).
optional DOM.RGBA contentColor
# The content box highlight outline color (default: transparent).
optional DOM.RGBA outlineColor
# Configuration for Window Controls Overlay
type WindowControlsOverlayConfig extends object
properties
# Whether the title bar CSS should be shown when emulating the Window Controls Overlay.
boolean showCSS
# Selected platforms to show the overlay.
string selectedPlatform
# The theme color defined in app manifest.
string themeColor
type ContainerQueryHighlightConfig extends object
properties
# A descriptor for the highlight appearance of container query containers.
ContainerQueryContainerHighlightConfig containerQueryContainerHighlightConfig
# Identifier of the container node to highlight.
DOM.NodeId nodeId
type ContainerQueryContainerHighlightConfig extends object
properties
# The style of the container border.
optional LineStyle containerBorder
# The style of the descendants' borders.
optional LineStyle descendantBorder
type IsolatedElementHighlightConfig extends object
properties
# A descriptor for the highlight appearance of an element in isolation mode.
IsolationModeHighlightConfig isolationModeHighlightConfig
# Identifier of the isolated element to highlight.
DOM.NodeId nodeId
type IsolationModeHighlightConfig extends object
properties
# The fill color of the resizers (default: transparent).
optional DOM.RGBA resizerColor
# The fill color for resizer handles (default: transparent).
optional DOM.RGBA resizerHandleColor
# The fill color for the mask covering non-isolated elements (default: transparent).
optional DOM.RGBA maskColor
type InspectMode extends string
enum
searchForNode
searchForUAShadowDOM
captureAreaScreenshot
none
# Disables domain notifications.
command disable
# Enables domain notifications.
command enable
# For testing.
command getHighlightObjectForTest
parameters
# Id of the node to get highlight object for.
DOM.NodeId nodeId
# Whether to include distance info.
optional boolean includeDistance
# Whether to include style info.
optional boolean includeStyle
# The color format to get config with (default: hex).
optional ColorFormat colorFormat
# Whether to show accessibility info (default: true).
optional boolean showAccessibilityInfo
returns
# Highlight data for the node.
object highlight
# For Persistent Grid testing.
command getGridHighlightObjectsForTest
parameters
# Ids of the node to get highlight object for.
array of DOM.NodeId nodeIds
returns
# Grid Highlight data for the node ids provided.
object highlights
# For Source Order Viewer testing.
command getSourceOrderHighlightObjectForTest
parameters
# Id of the node to highlight.
DOM.NodeId nodeId
returns
# Source order highlight data for the node id provided.
object highlight
# Hides any highlight.
command hideHighlight
# Highlights owner element of the frame with given id.
# Deprecated: Doesn't work reliably and cannot be fixed due to process
# separation (the owner node might be in a different process). Determine
# the owner node in the client and use highlightNode.
deprecated command highlightFrame
parameters
# Identifier of the frame to highlight.
Page.FrameId frameId
# The content box highlight fill color (default: transparent).
optional DOM.RGBA contentColor
# The content box highlight outline color (default: transparent).
optional DOM.RGBA contentOutlineColor
# Highlights DOM node with given id or with the given JavaScript object wrapper. Either nodeId or
# objectId must be specified.
command highlightNode
parameters
# A descriptor for the highlight appearance.
HighlightConfig highlightConfig
# Identifier of the node to highlight.
optional DOM.NodeId nodeId
# Identifier of the backend node to highlight.
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node to be highlighted.
optional Runtime.RemoteObjectId objectId
# Selectors to highlight relevant nodes.
optional string selector
# Highlights given quad. Coordinates are absolute with respect to the main frame viewport.
command highlightQuad
parameters
# Quad to highlight
DOM.Quad quad
# The highlight fill color (default: transparent).
optional DOM.RGBA color
# The highlight outline color (default: transparent).
optional DOM.RGBA outlineColor
# Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport.
# Issue: the method does not handle device pixel ratio (DPR) correctly.
# The coordinates currently have to be adjusted by the client
# if DPR is not 1 (see crbug.com/437807128).
command highlightRect
parameters
# X coordinate
integer x
# Y coordinate
integer y
# Rectangle width
integer width
# Rectangle height
integer height
# The highlight fill color (default: transparent).
optional DOM.RGBA color
# The highlight outline color (default: transparent).
optional DOM.RGBA outlineColor
# Highlights the source order of the children of the DOM node with given id or with the given
# JavaScript object wrapper. Either nodeId or objectId must be specified.
command highlightSourceOrder
parameters
# A descriptor for the appearance of the overlay drawing.
SourceOrderConfig sourceOrderConfig
# Identifier of the node to highlight.
optional DOM.NodeId nodeId
# Identifier of the backend node to highlight.
optional DOM.BackendNodeId backendNodeId
# JavaScript object id of the node to be highlighted.
optional Runtime.RemoteObjectId objectId
# Enters the 'inspect' mode. In this mode, elements that user is hovering over are highlighted.
# Backend then generates 'inspectNodeRequested' event upon element selection.
command setInspectMode
parameters
# Set an inspection mode.
InspectMode mode
# A descriptor for the highlight appearance of hovered-over nodes. May be omitted if `enabled
# == false`.
optional HighlightConfig highlightConfig
# Highlights owner element of all frames detected to be ads.
command setShowAdHighlights
parameters
# True for showing ad highlights
boolean show
command setPausedInDebuggerMessage
parameters
# The message to display, also triggers resume and step over controls.
optional string message
# Requests that backend shows debug borders on layers
command setShowDebugBorders
parameters
# True for showing debug borders
boolean show
# Requests that backend shows the FPS counter
command setShowFPSCounter
parameters
# True for showing the FPS counter
boolean show
# Highlight multiple elements with the CSS Grid overlay.
command setShowGridOverlays
parameters
# An array of node identifiers and descriptors for the highlight appearance.
array of GridNodeHighlightConfig gridNodeHighlightConfigs
command setShowFlexOverlays
parameters
# An array of node identifiers and descriptors for the highlight appearance.
array of FlexNodeHighlightConfig flexNodeHighlightConfigs
command setShowScrollSnapOverlays
parameters
# An array of node identifiers and descriptors for the highlight appearance.
array of ScrollSnapHighlightConfig scrollSnapHighlightConfigs
command setShowContainerQueryOverlays
parameters
# An array of node identifiers and descriptors for the highlight appearance.
array of ContainerQueryHighlightConfig containerQueryHighlightConfigs
# Requests that backend shows paint rectangles
command setShowPaintRects
parameters
# True for showing paint rectangles
boolean result
# Requests that backend shows layout shift regions
command setShowLayoutShiftRegions
parameters
# True for showing layout shift regions
boolean result
# Requests that backend shows scroll bottleneck rects
command setShowScrollBottleneckRects
parameters
# True for showing scroll bottleneck rects
boolean show
# Deprecated, no longer has any effect.
deprecated command setShowHitTestBorders
parameters
# True for showing hit-test borders
boolean show
# Deprecated, no longer has any effect.
deprecated command setShowWebVitals
parameters
boolean show
# Paints viewport size upon main frame resize.
command setShowViewportSizeOnResize
parameters
# Whether to paint size or not.
boolean show
# Add a dual screen device hinge
command setShowHinge
parameters
# hinge data, null means hideHinge
optional HingeConfig hingeConfig
# Show elements in isolation mode with overlays.
command setShowIsolatedElements
parameters
# An array of node identifiers and descriptors for the highlight appearance.
array of IsolatedElementHighlightConfig isolatedElementHighlightConfigs
# Show Window Controls Overlay for PWA
command setShowWindowControlsOverlay
parameters
# Window Controls Overlay data, null means hide Window Controls Overlay
optional WindowControlsOverlayConfig windowControlsOverlayConfig
# Fired when the node should be inspected. This happens after call to `setInspectMode` or when
# user manually inspects an element.
event inspectNodeRequested
parameters
# Id of the node to inspect.
DOM.BackendNodeId backendNodeId
# Fired when the node should be highlighted. This happens after call to `setInspectMode`.
event nodeHighlightRequested
parameters
DOM.NodeId nodeId
# Fired when user asks to capture screenshot of some area on the page.
event screenshotRequested
parameters
# Viewport to capture, in device independent pixels (dip).
Page.Viewport viewport
# Fired when user cancels the inspect mode.
event inspectModeCanceled

143
node_modules/devtools-protocol/pdl/domains/PWA.pdl generated vendored Normal file
View File

@@ -0,0 +1,143 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows interacting with the browser to control PWAs.
experimental domain PWA
# The following types are the replica of
# https://crsrc.org/c/chrome/browser/web_applications/proto/web_app_os_integration_state.proto;drc=9910d3be894c8f142c977ba1023f30a656bc13fc;l=67
type FileHandlerAccept extends object
properties
# New name of the mimetype according to
# https://www.iana.org/assignments/media-types/media-types.xhtml
string mediaType
array of string fileExtensions
type FileHandler extends object
properties
string action
array of FileHandlerAccept accepts
string displayName
# Returns the following OS state for the given manifest id.
command getOsAppState
parameters
# The id from the webapp's manifest file, commonly it's the url of the
# site installing the webapp. See
# https://web.dev/learn/pwa/web-app-manifest.
string manifestId
returns
integer badgeCount
array of FileHandler fileHandlers
# Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
#
# IWA-specific install description:
# manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
#
# File installation mode:
# The installUrlOrBundleUrl can be either file:// or http(s):// pointing
# to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
# The .swbn file's signing key.
#
# Dev proxy installation mode:
# installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
# web_package::SignedWebBundleId must be of type dev proxy.
#
# The advantage of dev proxy mode is that all changes to IWA
# automatically will be reflected in the running app without
# reinstallation.
#
# To generate bundle id for proxy mode:
# 1. Generate 32 random bytes.
# 2. Add a specific suffix at the end following the documentation
# https://github.com/WICG/isolated-web-apps/blob/main/Scheme.md#suffix
# 3. Encode the entire sequence using Base32 without padding.
#
# If Chrome is not in IWA dev
# mode, the installation will fail, regardless of the state of the allowlist.
command install
parameters
string manifestId
# The location of the app or bundle overriding the one derived from the
# manifestId.
optional string installUrlOrBundleUrl
# Uninstalls the given manifest_id and closes any opened app windows.
command uninstall
parameters
string manifestId
# Launches the installed web app, or an url in the same web app instead of the
# default start url if it is provided. Returns a page Target.TargetID which
# can be used to attach to via Target.attachToTarget or similar APIs.
command launch
parameters
string manifestId
optional string url
returns
# ID of the tab target created as a result.
Target.TargetID targetId
# Opens one or more local files from an installed web app identified by its
# manifestId. The web app needs to have file handlers registered to process
# the files. The API returns one or more page Target.TargetIDs which can be
# used to attach to via Target.attachToTarget or similar APIs.
# If some files in the parameters cannot be handled by the web app, they will
# be ignored. If none of the files can be handled, this API returns an error.
# If no files are provided as the parameter, this API also returns an error.
#
# According to the definition of the file handlers in the manifest file, one
# Target.TargetID may represent a page handling one or more files. The order
# of the returned Target.TargetIDs is not guaranteed.
#
# TODO(crbug.com/339454034): Check the existences of the input files.
command launchFilesInApp
parameters
string manifestId
array of string files
returns
# IDs of the tab targets created as the result.
array of Target.TargetID targetIds
# Opens the current page in its web app identified by the manifest id, needs
# to be called on a page target. This function returns immediately without
# waiting for the app to finish loading.
command openCurrentPageInApp
parameters
string manifestId
# If user prefers opening the app in browser or an app window.
type DisplayMode extends string
enum
standalone
browser
# Changes user settings of the web app identified by its manifestId. If the
# app was not installed, this command returns an error. Unset parameters will
# be ignored; unrecognized values will cause an error.
#
# Unlike the ones defined in the manifest files of the web apps, these
# settings are provided by the browser and controlled by the users, they
# impact the way the browser handling the web apps.
#
# See the comment of each parameter.
command changeAppUserSettings
parameters
string manifestId
# If user allows the links clicked on by the user in the app's scope, or
# extended scope if the manifest has scope extensions and the flags
# `DesktopPWAsLinkCapturingWithScopeExtensions` and
# `WebAppEnableScopeExtensions` are enabled.
#
# Note, the API does not support resetting the linkCapturing to the
# initial value, uninstalling and installing the web app again will reset
# it.
#
# TODO(crbug.com/339453269): Setting this value on ChromeOS is not
# supported yet.
optional boolean linkCapturing
optional DisplayMode displayMode

1784
node_modules/devtools-protocol/pdl/domains/Page.pdl generated vendored Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,54 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
domain Performance
# Run-time execution metric.
type Metric extends object
properties
# Metric name.
string name
# Metric value.
number value
# Disable collecting and reporting metrics.
command disable
# Enable collecting and reporting metrics.
command enable
parameters
# Time domain to use for collecting and reporting duration metrics.
optional enum timeDomain
# Use monotonically increasing abstract time (default).
timeTicks
# Use thread running time.
threadTicks
# Sets time domain to use for collecting and reporting duration metrics.
# Note that this must be called before enabling metrics collection. Calling
# this method while metrics collection is enabled returns an error.
experimental deprecated command setTimeDomain
parameters
# Time domain
enum timeDomain
# Use monotonically increasing abstract time (default).
timeTicks
# Use thread running time.
threadTicks
# Retrieve current values of run-time metrics.
command getMetrics
returns
# Current values for run-time metrics.
array of Metric metrics
# Current values of the metrics.
event metrics
parameters
# Current values of the metrics.
array of Metric metrics
# Timestamp title.
string title

View File

@@ -0,0 +1,71 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Reporting of performance timeline events, as specified in
# https://w3c.github.io/performance-timeline/#dom-performanceobserver.
experimental domain PerformanceTimeline
depends on DOM
depends on Network
# See https://github.com/WICG/LargestContentfulPaint and largest_contentful_paint.idl
type LargestContentfulPaint extends object
properties
Network.TimeSinceEpoch renderTime
Network.TimeSinceEpoch loadTime
# The number of pixels being painted.
number size
# The id attribute of the element, if available.
optional string elementId
# The URL of the image (may be trimmed).
optional string url
optional DOM.BackendNodeId nodeId
type LayoutShiftAttribution extends object
properties
DOM.Rect previousRect
DOM.Rect currentRect
optional DOM.BackendNodeId nodeId
# See https://wicg.github.io/layout-instability/#sec-layout-shift and layout_shift.idl
type LayoutShift extends object
properties
# Score increment produced by this event.
number value
boolean hadRecentInput
Network.TimeSinceEpoch lastInputTime
array of LayoutShiftAttribution sources
type TimelineEvent extends object
properties
# Identifies the frame that this event is related to. Empty for non-frame targets.
Page.FrameId frameId
# The event type, as specified in https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
# This determines which of the optional "details" fields is present.
string type
# Name may be empty depending on the type.
string name
# Time in seconds since Epoch, monotonically increasing within document lifetime.
Network.TimeSinceEpoch time
# Event duration, if applicable.
optional number duration
optional LargestContentfulPaint lcpDetails
optional LayoutShift layoutShiftDetails
# Previously buffered events would be reported before method returns.
# See also: timelineEventAdded
command enable
parameters
# The types of event to report, as specified in
# https://w3c.github.io/performance-timeline/#dom-performanceentry-entrytype
# The specified filter overrides any previous filters, passing empty
# filter disables recording.
# Note that not all types exposed to the web platform are currently supported.
array of string eventTypes
# Sent when a performance timeline event is added. See reportPerformanceTimeline method.
event timelineEventAdded
parameters
TimelineEvent event

294
node_modules/devtools-protocol/pdl/domains/Preload.pdl generated vendored Normal file
View File

@@ -0,0 +1,294 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Preload
# Unique id
type RuleSetId extends string
# Corresponds to SpeculationRuleSet
type RuleSet extends object
properties
RuleSetId id
# Identifies a document which the rule set is associated with.
Network.LoaderId loaderId
# Source text of JSON representing the rule set. If it comes from
# `<script>` tag, it is the textContent of the node. Note that it is
# a JSON for valid case.
#
# See also:
# - https://wicg.github.io/nav-speculation/speculation-rules.html
# - https://github.com/WICG/nav-speculation/blob/main/triggers.md
string sourceText
# A speculation rule set is either added through an inline
# `<script>` tag or through an external resource via the
# 'Speculation-Rules' HTTP header. For the first case, we include
# the BackendNodeId of the relevant `<script>` tag. For the second
# case, we include the external URL where the rule set was loaded
# from, and also RequestId if Network domain is enabled.
#
# See also:
# - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-script
# - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-header
optional DOM.BackendNodeId backendNodeId
optional string url
optional Network.RequestId requestId
# Error information
# `errorMessage` is null iff `errorType` is null.
optional RuleSetErrorType errorType
# TODO(https://crbug.com/1425354): Replace this property with structured error.
deprecated optional string errorMessage
# For more details, see:
# https://github.com/WICG/nav-speculation/blob/main/speculation-rules-tags.md
optional string tag
type RuleSetErrorType extends string
enum
SourceIsNotJsonObject
InvalidRulesSkipped
InvalidRulesetLevelTag
# The type of preloading attempted. It corresponds to
# mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
# isn't being used by clients).
type SpeculationAction extends string
enum
Prefetch
Prerender
PrerenderUntilScript
# Corresponds to mojom::SpeculationTargetHint.
# See https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
type SpeculationTargetHint extends string
enum
Blank
Self
# A key that identifies a preloading attempt.
#
# The url used is the url specified by the trigger (i.e. the initial URL), and
# not the final url that is navigated to. For example, prerendering allows
# same-origin main frame navigations during the attempt, but the attempt is
# still keyed with the initial URL.
type PreloadingAttemptKey extends object
properties
Network.LoaderId loaderId
SpeculationAction action
string url
optional SpeculationTargetHint targetHint
# Lists sources for a preloading attempt, specifically the ids of rule sets
# that had a speculation rule that triggered the attempt, and the
# BackendNodeIds of <a href> or <area href> elements that triggered the
# attempt (in the case of attempts triggered by a document rule). It is
# possible for multiple rule sets and links to trigger a single attempt.
type PreloadingAttemptSource extends object
properties
PreloadingAttemptKey key
array of RuleSetId ruleSetIds
array of DOM.BackendNodeId nodeIds
# Chrome manages different types of preloads together using a
# concept of preloading pipeline. For example, if a site uses a
# SpeculationRules for prerender, Chrome first starts a prefetch and
# then upgrades it to prerender.
#
# CDP events for them are emitted separately but they share
# `PreloadPipelineId`.
type PreloadPipelineId extends string
command enable
command disable
# Upsert. Currently, it is only emitted when a rule set added.
event ruleSetUpdated
parameters
RuleSet ruleSet
event ruleSetRemoved
parameters
RuleSetId id
# List of FinalStatus reasons for Prerender2.
type PrerenderFinalStatus extends string
enum
Activated
Destroyed
LowEndDevice
InvalidSchemeRedirect
InvalidSchemeNavigation
NavigationRequestBlockedByCsp
MojoBinderPolicy
RendererProcessCrashed
RendererProcessKilled
Download
TriggerDestroyed
NavigationNotCommitted
NavigationBadHttpStatus
ClientCertRequested
NavigationRequestNetworkError
CancelAllHostsForTesting
DidFailLoad
Stop
SslCertificateError
LoginAuthRequested
UaChangeRequiresReload
BlockedByClient
AudioOutputDeviceRequested
MixedContent
TriggerBackgrounded
MemoryLimitExceeded
DataSaverEnabled
TriggerUrlHasEffectiveUrl
ActivatedBeforeStarted
InactivePageRestriction
StartFailed
TimeoutBackgrounded
CrossSiteRedirectInInitialNavigation
CrossSiteNavigationInInitialNavigation
SameSiteCrossOriginRedirectNotOptInInInitialNavigation
SameSiteCrossOriginNavigationNotOptInInInitialNavigation
ActivationNavigationParameterMismatch
ActivatedInBackground
EmbedderHostDisallowed
ActivationNavigationDestroyedBeforeSuccess
TabClosedByUserGesture
TabClosedWithoutUserGesture
PrimaryMainFrameRendererProcessCrashed
PrimaryMainFrameRendererProcessKilled
ActivationFramePolicyNotCompatible
PreloadingDisabled
BatterySaverEnabled
ActivatedDuringMainFrameNavigation
PreloadingUnsupportedByWebContents
CrossSiteRedirectInMainFrameNavigation
CrossSiteNavigationInMainFrameNavigation
SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation
SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation
MemoryPressureOnTrigger
MemoryPressureAfterTriggered
PrerenderingDisabledByDevTools
SpeculationRuleRemoved
ActivatedWithAuxiliaryBrowsingContexts
MaxNumOfRunningEagerPrerendersExceeded
MaxNumOfRunningNonEagerPrerendersExceeded
MaxNumOfRunningEmbedderPrerendersExceeded
PrerenderingUrlHasEffectiveUrl
RedirectedPrerenderingUrlHasEffectiveUrl
ActivationUrlHasEffectiveUrl
JavaScriptInterfaceAdded
JavaScriptInterfaceRemoved
AllPrerenderingCanceled
WindowClosed
SlowNetwork
OtherPrerenderedPageActivated
V8OptimizerDisabled
PrerenderFailedDuringPrefetch
BrowsingDataRemoved
PrerenderHostReused
# Fired when a preload enabled state is updated.
event preloadEnabledStateUpdated
parameters
boolean disabledByPreference
boolean disabledByDataSaver
boolean disabledByBatterySaver
boolean disabledByHoldbackPrefetchSpeculationRules
boolean disabledByHoldbackPrerenderSpeculationRules
# Preloading status values, see also PreloadingTriggeringOutcome. This
# status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
type PreloadingStatus extends string
enum
Pending
Running
Ready
Success
Failure
# PreloadingTriggeringOutcome which not used by prefetch nor prerender.
NotSupported
# TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
# filter out the ones that aren't necessary to the developers.
type PrefetchStatus extends string
enum
# Prefetch is not disabled by PrefetchHeldback.
PrefetchAllowed
PrefetchFailedIneligibleRedirect
PrefetchFailedInvalidRedirect
PrefetchFailedMIMENotSupported
PrefetchFailedNetError
PrefetchFailedNon2XX
PrefetchEvictedAfterBrowsingDataRemoved
PrefetchEvictedAfterCandidateRemoved
PrefetchEvictedForNewerPrefetch
PrefetchHeldback
# A previous prefetch to the origin got a HTTP 503 response with an
# Retry-After header that has no elapsed yet.
PrefetchIneligibleRetryAfter
PrefetchIsPrivacyDecoy
PrefetchIsStale
PrefetchNotEligibleBrowserContextOffTheRecord
PrefetchNotEligibleDataSaverEnabled
PrefetchNotEligibleExistingProxy
PrefetchNotEligibleHostIsNonUnique
PrefetchNotEligibleNonDefaultStoragePartition
PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy
PrefetchNotEligibleSchemeIsNotHttps
PrefetchNotEligibleUserHasCookies
PrefetchNotEligibleUserHasServiceWorker
PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler
PrefetchNotEligibleRedirectFromServiceWorker
PrefetchNotEligibleRedirectToServiceWorker
PrefetchNotEligibleBatterySaverEnabled
PrefetchNotEligiblePreloadingDisabled
PrefetchNotFinishedInTime
PrefetchNotStarted
PrefetchNotUsedCookiesChanged
PrefetchProxyNotAvailable
# The response of the prefetch is used for the next navigation. This is
# the final successful state.
PrefetchResponseUsed
# The prefetch finished successfully but was never used.
PrefetchSuccessfulButNotUsed
PrefetchNotUsedProbeFailed
# Fired when a prefetch attempt is updated.
event prefetchStatusUpdated
parameters
PreloadingAttemptKey key
PreloadPipelineId pipelineId
# The frame id of the frame initiating prefetch.
Page.FrameId initiatingFrameId
string prefetchUrl
PreloadingStatus status
PrefetchStatus prefetchStatus
Network.RequestId requestId
# Information of headers to be displayed when the header mismatch occurred.
type PrerenderMismatchedHeaders extends object
properties
string headerName
optional string initialValue
optional string activationValue
# Fired when a prerender attempt is updated.
event prerenderStatusUpdated
parameters
PreloadingAttemptKey key
PreloadPipelineId pipelineId
PreloadingStatus status
optional PrerenderFinalStatus prerenderStatus
# This is used to give users more information about the name of Mojo interface
# that is incompatible with prerender and has caused the cancellation of the attempt.
optional string disallowedMojoInterface
optional array of PrerenderMismatchedHeaders mismatchedHeaders
# Send a list of sources for all preloading attempts in a document.
event preloadingAttemptSourcesUpdated
parameters
Network.LoaderId loaderId
array of PreloadingAttemptSource preloadingAttemptSources

196
node_modules/devtools-protocol/pdl/domains/Security.pdl generated vendored Normal file
View File

@@ -0,0 +1,196 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
domain Security
# An internal certificate ID value.
type CertificateId extends integer
# A description of mixed content (HTTP resources on HTTPS pages), as defined by
# https://www.w3.org/TR/mixed-content/#categories
type MixedContentType extends string
enum
blockable
optionally-blockable
none
# The security level of a page or resource.
type SecurityState extends string
enum
unknown
neutral
insecure
secure
info
insecure-broken
# Details about the security state of the page certificate.
experimental type CertificateSecurityState extends object
properties
# Protocol name (e.g. "TLS 1.2" or "QUIC").
string protocol
# Key Exchange used by the connection, or the empty string if not applicable.
string keyExchange
# (EC)DH group used by the connection, if applicable.
optional string keyExchangeGroup
# Cipher name.
string cipher
# TLS MAC. Note that AEAD ciphers do not have separate MACs.
optional string mac
# Page certificate.
array of string certificate
# Certificate subject name.
string subjectName
# Name of the issuing CA.
string issuer
# Certificate valid from date.
Network.TimeSinceEpoch validFrom
# Certificate valid to (expiration) date
Network.TimeSinceEpoch validTo
# The highest priority network error code, if the certificate has an error.
optional string certificateNetworkError
# True if the certificate uses a weak signature algorithm.
boolean certificateHasWeakSignature
# True if the certificate has a SHA1 signature in the chain.
boolean certificateHasSha1Signature
# True if modern SSL
boolean modernSSL
# True if the connection is using an obsolete SSL protocol.
boolean obsoleteSslProtocol
# True if the connection is using an obsolete SSL key exchange.
boolean obsoleteSslKeyExchange
# True if the connection is using an obsolete SSL cipher.
boolean obsoleteSslCipher
# True if the connection is using an obsolete SSL signature.
boolean obsoleteSslSignature
experimental type SafetyTipStatus extends string
enum
badReputation
lookalike
experimental type SafetyTipInfo extends object
properties
# Describes whether the page triggers any safety tips or reputation warnings. Default is unknown.
SafetyTipStatus safetyTipStatus
# The URL the safety tip suggested ("Did you mean?"). Only filled in for lookalike matches.
optional string safeUrl
# Security state information about the page.
experimental type VisibleSecurityState extends object
properties
# The security level of the page.
SecurityState securityState
# Security state details about the page certificate.
optional CertificateSecurityState certificateSecurityState
# The type of Safety Tip triggered on the page. Note that this field will be set even if the Safety Tip UI was not actually shown.
optional SafetyTipInfo safetyTipInfo
# Array of security state issues ids.
array of string securityStateIssueIds
# An explanation of an factor contributing to the security state.
type SecurityStateExplanation extends object
properties
# Security state representing the severity of the factor being explained.
SecurityState securityState
# Title describing the type of factor.
string title
# Short phrase describing the type of factor.
string summary
# Full text explanation of the factor.
string description
# The type of mixed content described by the explanation.
MixedContentType mixedContentType
# Page certificate.
array of string certificate
# Recommendations to fix any issues.
optional array of string recommendations
# Information about insecure content on the page.
deprecated type InsecureContentStatus extends object
properties
# Always false.
boolean ranMixedContent
# Always false.
boolean displayedMixedContent
# Always false.
boolean containedMixedForm
# Always false.
boolean ranContentWithCertErrors
# Always false.
boolean displayedContentWithCertErrors
# Always set to unknown.
SecurityState ranInsecureContentStyle
# Always set to unknown.
SecurityState displayedInsecureContentStyle
# The action to take when a certificate error occurs. continue will continue processing the
# request and cancel will cancel the request.
type CertificateErrorAction extends string
enum
continue
cancel
# Disables tracking security state changes.
command disable
# Enables tracking security state changes.
command enable
# Enable/disable whether all certificate errors should be ignored.
command setIgnoreCertificateErrors
parameters
# If true, all certificate errors will be ignored.
boolean ignore
# Handles a certificate error that fired a certificateError event.
deprecated command handleCertificateError
parameters
# The ID of the event.
integer eventId
# The action to take on the certificate error.
CertificateErrorAction action
# Enable/disable overriding certificate errors. If enabled, all certificate error events need to
# be handled by the DevTools client and should be answered with `handleCertificateError` commands.
deprecated command setOverrideCertificateErrors
parameters
# If true, certificate errors will be overridden.
boolean override
# There is a certificate error. If overriding certificate errors is enabled, then it should be
# handled with the `handleCertificateError` command. Note: this event does not fire if the
# certificate error has been allowed internally. Only one client per target should override
# certificate errors at the same time.
deprecated event certificateError
parameters
# The ID of the event.
integer eventId
# The type of the error.
string errorType
# The url that was requested.
string requestURL
# The security state of the page changed.
experimental event visibleSecurityStateChanged
parameters
# Security state information about the page.
VisibleSecurityState visibleSecurityState
# The security state of the page changed. No longer being sent.
deprecated event securityStateChanged
parameters
# Security state.
SecurityState securityState
# True if the page was loaded over cryptographic transport such as HTTPS.
deprecated boolean schemeIsCryptographic
# Previously a list of explanations for the security state. Now always
# empty.
deprecated array of SecurityStateExplanation explanations
# Information about insecure content on the page.
deprecated InsecureContentStatus insecureContentStatus
# Overrides user-visible description of the state. Always omitted.
deprecated optional string summary

View File

@@ -0,0 +1,121 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain ServiceWorker
depends on Target
type RegistrationID extends string
# ServiceWorker registration.
type ServiceWorkerRegistration extends object
properties
RegistrationID registrationId
string scopeURL
boolean isDeleted
type ServiceWorkerVersionRunningStatus extends string
enum
stopped
starting
running
stopping
type ServiceWorkerVersionStatus extends string
enum
new
installing
installed
activating
activated
redundant
# ServiceWorker version.
type ServiceWorkerVersion extends object
properties
string versionId
RegistrationID registrationId
string scriptURL
ServiceWorkerVersionRunningStatus runningStatus
ServiceWorkerVersionStatus status
# The Last-Modified header value of the main script.
optional number scriptLastModified
# The time at which the response headers of the main script were received from the server.
# For cached script it is the last time the cache entry was validated.
optional number scriptResponseTime
optional array of Target.TargetID controlledClients
optional Target.TargetID targetId
optional string routerRules
# ServiceWorker error message.
type ServiceWorkerErrorMessage extends object
properties
string errorMessage
RegistrationID registrationId
string versionId
string sourceURL
integer lineNumber
integer columnNumber
command deliverPushMessage
parameters
string origin
RegistrationID registrationId
string data
command disable
command dispatchSyncEvent
parameters
string origin
RegistrationID registrationId
string tag
boolean lastChance
command dispatchPeriodicSyncEvent
parameters
string origin
RegistrationID registrationId
string tag
command enable
command setForceUpdateOnPageLoad
parameters
boolean forceUpdateOnPageLoad
command skipWaiting
parameters
string scopeURL
command startWorker
parameters
string scopeURL
command stopAllWorkers
command stopWorker
parameters
string versionId
command unregister
parameters
string scopeURL
command updateRegistration
parameters
string scopeURL
event workerErrorReported
parameters
ServiceWorkerErrorMessage errorMessage
event workerRegistrationUpdated
parameters
array of ServiceWorkerRegistration registrations
event workerVersionUpdated
parameters
array of ServiceWorkerVersion versions

922
node_modules/devtools-protocol/pdl/domains/Storage.pdl generated vendored Normal file
View File

@@ -0,0 +1,922 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
experimental domain Storage
depends on Browser
depends on Network
type SerializedStorageKey extends string
# Enum of possible storage types.
type StorageType extends string
enum
cookies
file_systems
indexeddb
local_storage
shader_cache
websql
service_workers
cache_storage
interest_groups
shared_storage
storage_buckets
all
other
# Usage for a storage type.
type UsageForType extends object
properties
# Name of storage type.
StorageType storageType
# Storage usage (bytes).
number usage
# Pair of issuer origin and number of available (signed, but not used) Trust
# Tokens from that issuer.
experimental type TrustTokens extends object
properties
string issuerOrigin
number count
# Protected audience interest group auction identifier.
type InterestGroupAuctionId extends string
# Enum of interest group access types.
type InterestGroupAccessType extends string
enum
join
leave
update
loaded
bid
win
additionalBid
additionalBidWin
topLevelBid
topLevelAdditionalBid
clear
# Enum of auction events.
type InterestGroupAuctionEventType extends string
enum
started
configResolved
# Enum of network fetches auctions can do.
type InterestGroupAuctionFetchType extends string
enum
bidderJs
bidderWasm
sellerJs
bidderTrustedSignals
sellerTrustedSignals
# Enum of shared storage access scopes.
type SharedStorageAccessScope extends string
enum
window
sharedStorageWorklet
protectedAudienceWorklet
header
# Enum of shared storage access methods.
type SharedStorageAccessMethod extends string
enum
addModule
createWorklet
selectURL
run
batchUpdate
set
append
delete
clear
get
keys
values
entries
length
remainingBudget
# Struct for a single key-value pair in an origin's shared storage.
type SharedStorageEntry extends object
properties
string key
string value
# Details for an origin's shared storage.
type SharedStorageMetadata extends object
properties
# Time when the origin's shared storage was last created.
Network.TimeSinceEpoch creationTime
# Number of key-value pairs stored in origin's shared storage.
integer length
# Current amount of bits of entropy remaining in the navigation budget.
number remainingBudget
# Total number of bytes stored as key-value pairs in origin's shared
# storage.
integer bytesUsed
# Represents a dictionary object passed in as privateAggregationConfig to
# run or selectURL.
type SharedStoragePrivateAggregationConfig extends object
properties
# The chosen aggregation service deployment.
optional string aggregationCoordinatorOrigin
# The context ID provided.
optional string contextId
# Configures the maximum size allowed for filtering IDs.
integer filteringIdMaxBytes
# The limit on the number of contributions in the final report.
optional integer maxContributions
# Pair of reporting metadata details for a candidate URL for `selectURL()`.
type SharedStorageReportingMetadata extends object
properties
string eventType
string reportingUrl
# Bundles a candidate URL with its reporting metadata.
type SharedStorageUrlWithMetadata extends object
properties
# Spec of candidate URL.
string url
# Any associated reporting metadata.
array of SharedStorageReportingMetadata reportingMetadata
# Bundles the parameters for shared storage access events whose
# presence/absence can vary according to SharedStorageAccessType.
type SharedStorageAccessParams extends object
properties
# Spec of the module script URL.
# Present only for SharedStorageAccessMethods: addModule and
# createWorklet.
optional string scriptSourceUrl
# String denoting "context-origin", "script-origin", or a custom
# origin to be used as the worklet's data origin.
# Present only for SharedStorageAccessMethod: createWorklet.
optional string dataOrigin
# Name of the registered operation to be run.
# Present only for SharedStorageAccessMethods: run and selectURL.
optional string operationName
# ID of the operation call.
# Present only for SharedStorageAccessMethods: run and selectURL.
optional string operationId
# Whether or not to keep the worket alive for future run or selectURL
# calls.
# Present only for SharedStorageAccessMethods: run and selectURL.
optional boolean keepAlive
# Configures the private aggregation options.
# Present only for SharedStorageAccessMethods: run and selectURL.
optional SharedStoragePrivateAggregationConfig privateAggregationConfig
# The operation's serialized data in bytes (converted to a string).
# Present only for SharedStorageAccessMethods: run and selectURL.
# TODO(crbug.com/401011862): Consider updating this parameter to binary.
optional string serializedData
# Array of candidate URLs' specs, along with any associated metadata.
# Present only for SharedStorageAccessMethod: selectURL.
optional array of SharedStorageUrlWithMetadata urlsWithMetadata
# Spec of the URN:UUID generated for a selectURL call.
# Present only for SharedStorageAccessMethod: selectURL.
optional string urnUuid
# Key for a specific entry in an origin's shared storage.
# Present only for SharedStorageAccessMethods: set, append, delete, and
# get.
optional string key
# Value for a specific entry in an origin's shared storage.
# Present only for SharedStorageAccessMethods: set and append.
optional string value
# Whether or not to set an entry for a key if that key is already present.
# Present only for SharedStorageAccessMethod: set.
optional boolean ignoreIfPresent
# A number denoting the (0-based) order of the worklet's
# creation relative to all other shared storage worklets created by
# documents using the current storage partition.
# Present only for SharedStorageAccessMethods: addModule, createWorklet.
optional integer workletOrdinal
# Hex representation of the DevTools token used as the TargetID for the
# associated shared storage worklet.
# Present only for SharedStorageAccessMethods: addModule, createWorklet,
# run, selectURL, and any other SharedStorageAccessMethod when the
# SharedStorageAccessScope is sharedStorageWorklet.
optional Target.TargetID workletTargetId
# Name of the lock to be acquired, if present.
# Optionally present only for SharedStorageAccessMethods: batchUpdate,
# set, append, delete, and clear.
optional string withLock
# If the method has been called as part of a batchUpdate, then this
# number identifies the batch to which it belongs.
# Optionally present only for SharedStorageAccessMethods:
# batchUpdate (required), set, append, delete, and clear.
optional string batchUpdateId
# Number of modifier methods sent in batch.
# Present only for SharedStorageAccessMethod: batchUpdate.
optional integer batchSize
type StorageBucketsDurability extends string
enum
relaxed
strict
type StorageBucket extends object
properties
SerializedStorageKey storageKey
# If not specified, it is the default bucket of the storageKey.
optional string name
type StorageBucketInfo extends object
properties
StorageBucket bucket
string id
Network.TimeSinceEpoch expiration
# Storage quota (bytes).
number quota
boolean persistent
StorageBucketsDurability durability
# Returns a storage key given a frame id.
# Deprecated. Please use Storage.getStorageKey instead.
deprecated command getStorageKeyForFrame
parameters
Page.FrameId frameId
returns
SerializedStorageKey storageKey
# Returns storage key for the given frame. If no frame ID is provided,
# the storage key of the target executing this command is returned.
experimental command getStorageKey
parameters
optional Page.FrameId frameId
returns
SerializedStorageKey storageKey
# Clears storage for origin.
command clearDataForOrigin
parameters
# Security origin.
string origin
# Comma separated list of StorageType to clear.
string storageTypes
# Clears storage for storage key.
command clearDataForStorageKey
parameters
# Storage key.
string storageKey
# Comma separated list of StorageType to clear.
string storageTypes
# Returns all browser cookies.
command getCookies
parameters
# Browser context to use when called on the browser endpoint.
optional Browser.BrowserContextID browserContextId
returns
# Array of cookie objects.
array of Network.Cookie cookies
# Sets given cookies.
command setCookies
parameters
# Cookies to be set.
array of Network.CookieParam cookies
# Browser context to use when called on the browser endpoint.
optional Browser.BrowserContextID browserContextId
# Clears cookies.
command clearCookies
parameters
# Browser context to use when called on the browser endpoint.
optional Browser.BrowserContextID browserContextId
# Returns usage and quota in bytes.
command getUsageAndQuota
parameters
# Security origin.
string origin
returns
# Storage usage (bytes).
number usage
# Storage quota (bytes).
number quota
# Whether or not the origin has an active storage quota override
boolean overrideActive
# Storage usage per type (bytes).
array of UsageForType usageBreakdown
# Override quota for the specified origin
experimental command overrideQuotaForOrigin
parameters
# Security origin.
string origin
# The quota size (in bytes) to override the original quota with.
# If this is called multiple times, the overridden quota will be equal to
# the quotaSize provided in the final call. If this is called without
# specifying a quotaSize, the quota will be reset to the default value for
# the specified origin. If this is called multiple times with different
# origins, the override will be maintained for each origin until it is
# disabled (called without a quotaSize).
optional number quotaSize
# Registers origin to be notified when an update occurs to its cache storage list.
command trackCacheStorageForOrigin
parameters
# Security origin.
string origin
# Registers storage key to be notified when an update occurs to its cache storage list.
command trackCacheStorageForStorageKey
parameters
# Storage key.
string storageKey
# Registers origin to be notified when an update occurs to its IndexedDB.
command trackIndexedDBForOrigin
parameters
# Security origin.
string origin
# Registers storage key to be notified when an update occurs to its IndexedDB.
command trackIndexedDBForStorageKey
parameters
# Storage key.
string storageKey
# Unregisters origin from receiving notifications for cache storage.
command untrackCacheStorageForOrigin
parameters
# Security origin.
string origin
# Unregisters storage key from receiving notifications for cache storage.
command untrackCacheStorageForStorageKey
parameters
# Storage key.
string storageKey
# Unregisters origin from receiving notifications for IndexedDB.
command untrackIndexedDBForOrigin
parameters
# Security origin.
string origin
# Unregisters storage key from receiving notifications for IndexedDB.
command untrackIndexedDBForStorageKey
parameters
# Storage key.
string storageKey
# Returns the number of stored Trust Tokens per issuer for the
# current browsing context.
experimental command getTrustTokens
returns
array of TrustTokens tokens
# Removes all Trust Tokens issued by the provided issuerOrigin.
# Leaves other stored data, including the issuer's Redemption Records, intact.
experimental command clearTrustTokens
parameters
string issuerOrigin
returns
# True if any tokens were deleted, false otherwise.
boolean didDeleteTokens
# Gets details for a named interest group.
experimental command getInterestGroupDetails
parameters
string ownerOrigin
string name
returns
# This largely corresponds to:
# https://wicg.github.io/turtledove/#dictdef-generatebidinterestgroup
# but has absolute expirationTime instead of relative lifetimeMs and
# also adds joiningOrigin.
object details
# Enables/Disables issuing of interestGroupAccessed events.
experimental command setInterestGroupTracking
parameters
boolean enable
# Enables/Disables issuing of interestGroupAuctionEventOccurred and
# interestGroupAuctionNetworkRequestCreated.
experimental command setInterestGroupAuctionTracking
parameters
boolean enable
# Gets metadata for an origin's shared storage.
experimental command getSharedStorageMetadata
parameters
string ownerOrigin
returns
SharedStorageMetadata metadata
# Gets the entries in an given origin's shared storage.
experimental command getSharedStorageEntries
parameters
string ownerOrigin
returns
array of SharedStorageEntry entries
# Sets entry with `key` and `value` for a given origin's shared storage.
experimental command setSharedStorageEntry
parameters
string ownerOrigin
string key
string value
# If `ignoreIfPresent` is included and true, then only sets the entry if
# `key` doesn't already exist.
optional boolean ignoreIfPresent
# Deletes entry for `key` (if it exists) for a given origin's shared storage.
experimental command deleteSharedStorageEntry
parameters
string ownerOrigin
string key
# Clears all entries for a given origin's shared storage.
experimental command clearSharedStorageEntries
parameters
string ownerOrigin
# Resets the budget for `ownerOrigin` by clearing all budget withdrawals.
experimental command resetSharedStorageBudget
parameters
string ownerOrigin
# Enables/disables issuing of sharedStorageAccessed events.
experimental command setSharedStorageTracking
parameters
boolean enable
# Set tracking for a storage key's buckets.
experimental command setStorageBucketTracking
parameters
string storageKey
boolean enable
# Deletes the Storage Bucket with the given storage key and bucket name.
experimental command deleteStorageBucket
parameters
StorageBucket bucket
# Deletes state for sites identified as potential bounce trackers, immediately.
experimental command runBounceTrackingMitigations
returns
array of string deletedSites
# A cache's contents have been modified.
event cacheStorageContentUpdated
parameters
# Origin to update.
string origin
# Storage key to update.
string storageKey
# Storage bucket to update.
string bucketId
# Name of cache in origin.
string cacheName
# A cache has been added/deleted.
event cacheStorageListUpdated
parameters
# Origin to update.
string origin
# Storage key to update.
string storageKey
# Storage bucket to update.
string bucketId
# The origin's IndexedDB object store has been modified.
event indexedDBContentUpdated
parameters
# Origin to update.
string origin
# Storage key to update.
string storageKey
# Storage bucket to update.
string bucketId
# Database to update.
string databaseName
# ObjectStore to update.
string objectStoreName
# The origin's IndexedDB database list has been modified.
event indexedDBListUpdated
parameters
# Origin to update.
string origin
# Storage key to update.
string storageKey
# Storage bucket to update.
string bucketId
# One of the interest groups was accessed. Note that these events are global
# to all targets sharing an interest group store.
event interestGroupAccessed
parameters
Network.TimeSinceEpoch accessTime
InterestGroupAccessType type
string ownerOrigin
string name
# For topLevelBid/topLevelAdditionalBid, and when appropriate,
# win and additionalBidWin
optional string componentSellerOrigin
# For bid or somethingBid event, if done locally and not on a server.
optional number bid
optional string bidCurrency
# For non-global events --- links to interestGroupAuctionEvent
optional InterestGroupAuctionId uniqueAuctionId
# An auction involving interest groups is taking place. These events are
# target-specific.
event interestGroupAuctionEventOccurred
parameters
Network.TimeSinceEpoch eventTime
InterestGroupAuctionEventType type
InterestGroupAuctionId uniqueAuctionId
# Set for child auctions.
optional InterestGroupAuctionId parentAuctionId
# Set for started and configResolved
optional object auctionConfig
# Specifies which auctions a particular network fetch may be related to, and
# in what role. Note that it is not ordered with respect to
# Network.requestWillBeSent (but will happen before loadingFinished
# loadingFailed).
event interestGroupAuctionNetworkRequestCreated
parameters
InterestGroupAuctionFetchType type
Network.RequestId requestId
# This is the set of the auctions using the worklet that issued this
# request. In the case of trusted signals, it's possible that only some of
# them actually care about the keys being queried.
array of InterestGroupAuctionId auctions
# Shared storage was accessed by the associated page.
# The following parameters are included in all events.
event sharedStorageAccessed
parameters
# Time of the access.
Network.TimeSinceEpoch accessTime
# Enum value indicating the access scope.
SharedStorageAccessScope scope
# Enum value indicating the Shared Storage API method invoked.
SharedStorageAccessMethod method
# DevTools Frame Token for the primary frame tree's root.
Page.FrameId mainFrameId
# Serialization of the origin owning the Shared Storage data.
string ownerOrigin
# Serialization of the site owning the Shared Storage data.
string ownerSite
# The sub-parameters wrapped by `params` are all optional and their
# presence/absence depends on `type`.
SharedStorageAccessParams params
# A shared storage run or selectURL operation finished its execution.
# The following parameters are included in all events.
event sharedStorageWorkletOperationExecutionFinished
parameters
# Time that the operation finished.
Network.TimeSinceEpoch finishedTime
# Time, in microseconds, from start of shared storage JS API call until
# end of operation execution in the worklet.
integer executionTime
# Enum value indicating the Shared Storage API method invoked.
SharedStorageAccessMethod method
# ID of the operation call.
string operationId
# Hex representation of the DevTools token used as the TargetID for the
# associated shared storage worklet.
Target.TargetID workletTargetId
# DevTools Frame Token for the primary frame tree's root.
Page.FrameId mainFrameId
# Serialization of the origin owning the Shared Storage data.
string ownerOrigin
event storageBucketCreatedOrUpdated
parameters
StorageBucketInfo bucketInfo
event storageBucketDeleted
parameters
string bucketId
# https://wicg.github.io/attribution-reporting-api/
experimental command setAttributionReportingLocalTestingMode
parameters
# If enabled, noise is suppressed and reports are sent immediately.
boolean enabled
# Enables/disables issuing of Attribution Reporting events.
experimental command setAttributionReportingTracking
parameters
boolean enable
# Sends all pending Attribution Reports immediately, regardless of their
# scheduled report time.
experimental command sendPendingAttributionReports
returns
# The number of reports that were sent.
integer numSent
experimental type AttributionReportingSourceType extends string
enum
navigation
event
experimental type UnsignedInt64AsBase10 extends string
experimental type UnsignedInt128AsBase16 extends string
experimental type SignedInt64AsBase10 extends string
experimental type AttributionReportingFilterDataEntry extends object
properties
string key
array of string values
experimental type AttributionReportingFilterConfig extends object
properties
array of AttributionReportingFilterDataEntry filterValues
# duration in seconds
optional integer lookbackWindow
experimental type AttributionReportingFilterPair extends object
properties
array of AttributionReportingFilterConfig filters
array of AttributionReportingFilterConfig notFilters
experimental type AttributionReportingAggregationKeysEntry extends object
properties
string key
UnsignedInt128AsBase16 value
experimental type AttributionReportingEventReportWindows extends object
properties
# duration in seconds
integer start
# duration in seconds
array of integer ends
experimental type AttributionReportingTriggerDataMatching extends string
enum
exact
modulus
experimental type AttributionReportingAggregatableDebugReportingData extends object
properties
UnsignedInt128AsBase16 keyPiece
# number instead of integer because not all uint32 can be represented by
# int
number value
array of string types
experimental type AttributionReportingAggregatableDebugReportingConfig extends object
properties
# number instead of integer because not all uint32 can be represented by
# int, only present for source registrations
optional number budget
UnsignedInt128AsBase16 keyPiece
array of AttributionReportingAggregatableDebugReportingData debugData
optional string aggregationCoordinatorOrigin
experimental type AttributionScopesData extends object
properties
array of string values
# number instead of integer because not all uint32 can be represented by
# int
number limit
number maxEventStates
experimental type AttributionReportingNamedBudgetDef extends object
properties
string name
integer budget
experimental type AttributionReportingSourceRegistration extends object
properties
Network.TimeSinceEpoch time
# duration in seconds
integer expiry
# number instead of integer because not all uint32 can be represented by
# int
array of number triggerData
AttributionReportingEventReportWindows eventReportWindows
# duration in seconds
integer aggregatableReportWindow
AttributionReportingSourceType type
string sourceOrigin
string reportingOrigin
array of string destinationSites
UnsignedInt64AsBase10 eventId
SignedInt64AsBase10 priority
array of AttributionReportingFilterDataEntry filterData
array of AttributionReportingAggregationKeysEntry aggregationKeys
optional UnsignedInt64AsBase10 debugKey
AttributionReportingTriggerDataMatching triggerDataMatching
SignedInt64AsBase10 destinationLimitPriority
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
optional AttributionScopesData scopesData
integer maxEventLevelReports
array of AttributionReportingNamedBudgetDef namedBudgets
boolean debugReporting
number eventLevelEpsilon
experimental type AttributionReportingSourceRegistrationResult extends string
enum
success
internalError
insufficientSourceCapacity
insufficientUniqueDestinationCapacity
excessiveReportingOrigins
prohibitedByBrowserPolicy
successNoised
destinationReportingLimitReached
destinationGlobalLimitReached
destinationBothLimitsReached
reportingOriginsPerSiteLimitReached
exceedsMaxChannelCapacity
exceedsMaxScopesChannelCapacity
exceedsMaxTriggerStateCardinality
exceedsMaxEventStatesLimit
destinationPerDayReportingLimitReached
experimental event attributionReportingSourceRegistered
parameters
AttributionReportingSourceRegistration registration
AttributionReportingSourceRegistrationResult result
experimental type AttributionReportingSourceRegistrationTimeConfig extends string
enum
include
exclude
experimental type AttributionReportingAggregatableValueDictEntry extends object
properties
string key
# number instead of integer because not all uint32 can be represented by
# int
number value
UnsignedInt64AsBase10 filteringId
experimental type AttributionReportingAggregatableValueEntry extends object
properties
array of AttributionReportingAggregatableValueDictEntry values
AttributionReportingFilterPair filters
experimental type AttributionReportingEventTriggerData extends object
properties
UnsignedInt64AsBase10 data
SignedInt64AsBase10 priority
optional UnsignedInt64AsBase10 dedupKey
AttributionReportingFilterPair filters
experimental type AttributionReportingAggregatableTriggerData extends object
properties
UnsignedInt128AsBase16 keyPiece
array of string sourceKeys
AttributionReportingFilterPair filters
experimental type AttributionReportingAggregatableDedupKey extends object
properties
optional UnsignedInt64AsBase10 dedupKey
AttributionReportingFilterPair filters
experimental type AttributionReportingNamedBudgetCandidate extends object
properties
optional string name
AttributionReportingFilterPair filters
experimental type AttributionReportingTriggerRegistration extends object
properties
AttributionReportingFilterPair filters
optional UnsignedInt64AsBase10 debugKey
array of AttributionReportingAggregatableDedupKey aggregatableDedupKeys
array of AttributionReportingEventTriggerData eventTriggerData
array of AttributionReportingAggregatableTriggerData aggregatableTriggerData
array of AttributionReportingAggregatableValueEntry aggregatableValues
integer aggregatableFilteringIdMaxBytes
boolean debugReporting
optional string aggregationCoordinatorOrigin
AttributionReportingSourceRegistrationTimeConfig sourceRegistrationTimeConfig
optional string triggerContextId
AttributionReportingAggregatableDebugReportingConfig aggregatableDebugReportingConfig
array of string scopes
array of AttributionReportingNamedBudgetCandidate namedBudgets
experimental type AttributionReportingEventLevelResult extends string
enum
success
successDroppedLowerPriority
internalError
noCapacityForAttributionDestination
noMatchingSources
deduplicated
excessiveAttributions
priorityTooLow
neverAttributedSource
excessiveReportingOrigins
noMatchingSourceFilterData
prohibitedByBrowserPolicy
noMatchingConfigurations
excessiveReports
falselyAttributedSource
reportWindowPassed
notRegistered
reportWindowNotStarted
noMatchingTriggerData
experimental type AttributionReportingAggregatableResult extends string
enum
success
internalError
noCapacityForAttributionDestination
noMatchingSources
excessiveAttributions
excessiveReportingOrigins
noHistograms
insufficientBudget
insufficientNamedBudget
noMatchingSourceFilterData
notRegistered
prohibitedByBrowserPolicy
deduplicated
reportWindowPassed
excessiveReports
experimental event attributionReportingTriggerRegistered
parameters
AttributionReportingTriggerRegistration registration
AttributionReportingEventLevelResult eventLevel
AttributionReportingAggregatableResult aggregatable
experimental type AttributionReportingReportResult extends string
enum
# A network request was attempted for the report.
sent
# No request was attempted because of browser policy.
prohibited
# No request was attempted because of an error in report assembly,
# e.g. the aggregation service was unavailable.
failedToAssemble
# No request was attempted because the report's expiry passed.
expired
experimental event attributionReportingReportSent
parameters
string url
object body
AttributionReportingReportResult result
# If result is `sent`, populated with net/HTTP status.
optional integer netError
optional string netErrorName
optional integer httpStatusCode
experimental event attributionReportingVerboseDebugReportSent
parameters
string url
optional array of object body
optional integer netError
optional string netErrorName
optional integer httpStatusCode
# A single Related Website Set object.
experimental type RelatedWebsiteSet extends object
properties
# The primary site of this set, along with the ccTLDs if there is any.
array of string primarySites
# The associated sites of this set, along with the ccTLDs if there is any.
array of string associatedSites
# The service sites of this set, along with the ccTLDs if there is any.
array of string serviceSites
# Returns the effective Related Website Sets in use by this profile for the browser
# session. The effective Related Website Sets will not change during a browser session.
experimental command getRelatedWebsiteSets
returns
array of RelatedWebsiteSet sets
# Returns the list of URLs from a page and its embedded resources that match
# existing grace period URL pattern rules.
# https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
experimental command getAffectedUrlsForThirdPartyCookieMetadata
parameters
# The URL of the page currently being visited.
string firstPartyUrl
# The list of embedded resource URLs from the page.
array of string thirdPartyUrls
returns
# Array of matching URLs. If there is a primary pattern match for the first-
# party URL, only the first-party URL is returned in the array.
array of string matchedUrls
command setProtectedAudienceKAnonymity
parameters
string owner
string name
array of binary hashes

View File

@@ -0,0 +1,130 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# The SystemInfo domain defines methods and events for querying low-level system information.
experimental domain SystemInfo
# Describes a single graphics processor (GPU).
type GPUDevice extends object
properties
# PCI ID of the GPU vendor, if available; 0 otherwise.
number vendorId
# PCI ID of the GPU device, if available; 0 otherwise.
number deviceId
# Sub sys ID of the GPU, only available on Windows.
optional number subSysId
# Revision of the GPU, only available on Windows.
optional number revision
# String description of the GPU vendor, if the PCI ID is not available.
string vendorString
# String description of the GPU device, if the PCI ID is not available.
string deviceString
# String description of the GPU driver vendor.
string driverVendor
# String description of the GPU driver version.
string driverVersion
# Describes the width and height dimensions of an entity.
type Size extends object
properties
# Width in pixels.
integer width
# Height in pixels.
integer height
# Describes a supported video decoding profile with its associated minimum and
# maximum resolutions.
type VideoDecodeAcceleratorCapability extends object
properties
# Video codec profile that is supported, e.g. VP9 Profile 2.
string profile
# Maximum video dimensions in pixels supported for this |profile|.
Size maxResolution
# Minimum video dimensions in pixels supported for this |profile|.
Size minResolution
# Describes a supported video encoding profile with its associated maximum
# resolution and maximum framerate.
type VideoEncodeAcceleratorCapability extends object
properties
# Video codec profile that is supported, e.g H264 Main.
string profile
# Maximum video dimensions in pixels supported for this |profile|.
Size maxResolution
# Maximum encoding framerate in frames per second supported for this
# |profile|, as fraction's numerator and denominator, e.g. 24/1 fps,
# 24000/1001 fps, etc.
integer maxFramerateNumerator
integer maxFramerateDenominator
# YUV subsampling type of the pixels of a given image.
type SubsamplingFormat extends string
enum
yuv420
yuv422
yuv444
# Image format of a given image.
type ImageType extends string
enum
jpeg
webp
unknown
# Provides information about the GPU(s) on the system.
type GPUInfo extends object
properties
# The graphics devices on the system. Element 0 is the primary GPU.
array of GPUDevice devices
# An optional dictionary of additional GPU related attributes.
optional object auxAttributes
# An optional dictionary of graphics features and their status.
optional object featureStatus
# An optional array of GPU driver bug workarounds.
array of string driverBugWorkarounds
# Supported accelerated video decoding capabilities.
array of VideoDecodeAcceleratorCapability videoDecoding
# Supported accelerated video encoding capabilities.
array of VideoEncodeAcceleratorCapability videoEncoding
# Represents process info.
type ProcessInfo extends object
properties
# Specifies process type.
string type
# Specifies process id.
integer id
# Specifies cumulative CPU usage in seconds across all threads of the
# process since the process start.
number cpuTime
# Returns information about the system.
command getInfo
returns
# Information about the GPUs on the system.
GPUInfo gpu
# A platform-dependent description of the model of the machine. On Mac OS, this is, for
# example, 'MacBookPro'. Will be the empty string if not supported.
string modelName
# A platform-dependent description of the version of the machine. On Mac OS, this is, for
# example, '10.1'. Will be the empty string if not supported.
string modelVersion
# The command line string used to launch the browser. Will be the empty string if not
# supported.
string commandLine
# Returns information about the feature state.
command getFeatureState
parameters
string featureState
returns
boolean featureEnabled
# Returns information about all running processes.
command getProcessInfo
returns
# An array of process info blocks.
array of ProcessInfo processInfo

343
node_modules/devtools-protocol/pdl/domains/Target.pdl generated vendored Normal file
View File

@@ -0,0 +1,343 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# Supports additional targets discovery and allows to attach to them.
domain Target
type TargetID extends string
# Unique identifier of attached debugging session.
type SessionID extends string
type TargetInfo extends object
properties
TargetID targetId
# List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22
string type
string title
string url
# Whether the target has an attached client.
boolean attached
# Opener target Id
optional TargetID openerId
# Whether the target has access to the originating window.
experimental boolean canAccessOpener
# Frame id of originating window (is only set if target has an opener).
experimental optional Page.FrameId openerFrameId
# Id of the parent frame, only present for the "iframe" targets.
experimental optional Page.FrameId parentFrameId
experimental optional Browser.BrowserContextID browserContextId
# Provides additional details for specific target types. For example, for
# the type of "page", this may be set to "prerender".
experimental optional string subtype
# A filter used by target query/discovery/auto-attach operations.
experimental type FilterEntry extends object
properties
# If set, causes exclusion of matching targets from the list.
optional boolean exclude
# If not present, matches any type.
optional string type
# The entries in TargetFilter are matched sequentially against targets and
# the first entry that matches determines if the target is included or not,
# depending on the value of `exclude` field in the entry.
# If filter is not specified, the one assumed is
# [{type: "browser", exclude: true}, {type: "tab", exclude: true}, {}]
# (i.e. include everything but `browser` and `tab`).
experimental type TargetFilter extends array of FilterEntry
experimental type RemoteLocation extends object
properties
string host
integer port
# The state of the target window.
experimental type WindowState extends string
enum
normal
minimized
maximized
fullscreen
# Activates (focuses) the target.
command activateTarget
parameters
TargetID targetId
# Attaches to the target with given id.
command attachToTarget
parameters
TargetID targetId
# Enables "flat" access to the session via specifying sessionId attribute in the commands.
# We plan to make this the default, deprecate non-flattened mode,
# and eventually retire it. See crbug.com/991325.
optional boolean flatten
returns
# Id assigned to the session.
SessionID sessionId
# Attaches to the browser target, only uses flat sessionId mode.
experimental command attachToBrowserTarget
returns
# Id assigned to the session.
SessionID sessionId
# Closes the target. If the target is a page that gets closed too.
command closeTarget
parameters
TargetID targetId
returns
# Always set to true. If an error occurs, the response indicates protocol error.
deprecated boolean success
# Inject object to the target's main frame that provides a communication
# channel with browser target.
#
# Injected object will be available as `window[bindingName]`.
#
# The object has the following API:
# - `binding.send(json)` - a method to send messages over the remote debugging protocol
# - `binding.onmessage = json => handleMessage(json)` - a callback that will be called for the protocol notifications and command responses.
experimental command exposeDevToolsProtocol
parameters
TargetID targetId
# Binding name, 'cdp' if not specified.
optional string bindingName
# If true, inherits the current root session's permissions (default: false).
optional boolean inheritPermissions
# Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
# one.
command createBrowserContext
parameters
# If specified, disposes this context when debugging session disconnects.
experimental optional boolean disposeOnDetach
# Proxy server, similar to the one passed to --proxy-server
experimental optional string proxyServer
# Proxy bypass list, similar to the one passed to --proxy-bypass-list
experimental optional string proxyBypassList
# An optional list of origins to grant unlimited cross-origin access to.
# Parts of the URL other than those constituting origin are ignored.
experimental optional array of string originsWithUniversalNetworkAccess
returns
# The id of the context created.
Browser.BrowserContextID browserContextId
# Returns all browser contexts created with `Target.createBrowserContext` method.
command getBrowserContexts
returns
# An array of browser context ids.
array of Browser.BrowserContextID browserContextIds
# The id of the default browser context if available.
experimental optional Browser.BrowserContextID defaultBrowserContextId
# Creates a new page.
command createTarget
parameters
# The initial URL the page will be navigated to. An empty string indicates about:blank.
string url
# Frame left origin in DIP (requires newWindow to be true or headless shell).
experimental optional integer left
# Frame top origin in DIP (requires newWindow to be true or headless shell).
experimental optional integer top
# Frame width in DIP (requires newWindow to be true or headless shell).
optional integer width
# Frame height in DIP (requires newWindow to be true or headless shell).
optional integer height
# Frame window state (requires newWindow to be true or headless shell).
# Default is normal.
optional WindowState windowState
# The browser context to create the page in.
experimental optional Browser.BrowserContextID browserContextId
# Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
# not supported on MacOS yet, false by default).
experimental optional boolean enableBeginFrameControl
# Whether to create a new Window or Tab (false by default, not supported by headless shell).
optional boolean newWindow
# Whether to create the target in background or foreground (false by default, not supported
# by headless shell).
optional boolean background
# Whether to create the target of type "tab".
experimental optional boolean forTab
# Whether to create a hidden target. The hidden target is observable via protocol, but not
# present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
# `background: false`. The life-time of the tab is limited to the life-time of the session.
experimental optional boolean hidden
returns
# The id of the page opened.
TargetID targetId
# Detaches session with given id.
command detachFromTarget
parameters
# Session to detach.
optional SessionID sessionId
# Deprecated.
deprecated optional TargetID targetId
# Deletes a BrowserContext. All the belonging pages will be closed without calling their
# beforeunload hooks.
command disposeBrowserContext
parameters
Browser.BrowserContextID browserContextId
# Returns information about a target.
experimental command getTargetInfo
parameters
optional TargetID targetId
returns
TargetInfo targetInfo
# Retrieves a list of available targets.
command getTargets
parameters
# Only targets matching filter will be reported. If filter is not specified
# and target discovery is currently enabled, a filter used for target discovery
# is used for consistency.
experimental optional TargetFilter filter
returns
# The list of targets.
array of TargetInfo targetInfos
# Sends protocol message over session with given id.
# Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
# and crbug.com/991325.
deprecated command sendMessageToTarget
parameters
string message
# Identifier of the session.
optional SessionID sessionId
# Deprecated.
deprecated optional TargetID targetId
# Controls whether to automatically attach to new targets which are considered
# to be directly related to this one (for example, iframes or workers).
# When turned on, attaches to all existing related targets as well. When turned off,
# automatically detaches from all currently attached targets.
# This also clears all targets added by `autoAttachRelated` from the list of targets to watch
# for creation of related targets.
# You might want to call this recursively for auto-attached targets to attach
# to all available targets.
command setAutoAttach
parameters
# Whether to auto-attach to related targets.
boolean autoAttach
# Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
# to run paused targets.
boolean waitForDebuggerOnStart
# Enables "flat" access to the session via specifying sessionId attribute in the commands.
# We plan to make this the default, deprecate non-flattened mode,
# and eventually retire it. See crbug.com/991325.
experimental optional boolean flatten
# Only targets matching filter will be attached.
experimental optional TargetFilter filter
# Adds the specified target to the list of targets that will be monitored for any related target
# creation (such as child frames, child workers and new versions of service worker) and reported
# through `attachedToTarget`. The specified target is also auto-attached.
# This cancels the effect of any previous `setAutoAttach` and is also cancelled by subsequent
# `setAutoAttach`. Only available at the Browser target.
experimental command autoAttachRelated
parameters
TargetID targetId
# Whether to pause new targets when attaching to them. Use `Runtime.runIfWaitingForDebugger`
# to run paused targets.
boolean waitForDebuggerOnStart
# Only targets matching filter will be attached.
experimental optional TargetFilter filter
# Controls whether to discover available targets and notify via
# `targetCreated/targetInfoChanged/targetDestroyed` events.
command setDiscoverTargets
parameters
# Whether to discover available targets.
boolean discover
# Only targets matching filter will be attached. If `discover` is false,
# `filter` must be omitted or empty.
experimental optional TargetFilter filter
# Enables target discovery for the specified locations, when `setDiscoverTargets` was set to
# `true`.
experimental command setRemoteLocations
parameters
# List of remote locations.
array of RemoteLocation locations
# Gets the targetId of the DevTools page target opened for the given target
# (if any).
experimental command getDevToolsTarget
parameters
# Page or tab target ID.
TargetID targetId
returns
# The targetId of DevTools page target if exists.
optional TargetID targetId
# Issued when attached to target because of auto-attach or `attachToTarget` command.
experimental event attachedToTarget
parameters
# Identifier assigned to the session used to send/receive messages.
SessionID sessionId
TargetInfo targetInfo
boolean waitingForDebugger
# Issued when detached from target for any reason (including `detachFromTarget` command). Can be
# issued multiple times per target if multiple sessions have been attached to it.
experimental event detachedFromTarget
parameters
# Detached session identifier.
SessionID sessionId
# Deprecated.
deprecated optional TargetID targetId
# Notifies about a new protocol message received from the session (as reported in
# `attachedToTarget` event).
event receivedMessageFromTarget
parameters
# Identifier of a session which sends a message.
SessionID sessionId
string message
# Deprecated.
deprecated optional TargetID targetId
# Issued when a possible inspection target is created.
event targetCreated
parameters
TargetInfo targetInfo
# Issued when a target is destroyed.
event targetDestroyed
parameters
TargetID targetId
# Issued when a target has crashed.
event targetCrashed
parameters
TargetID targetId
# Termination status type.
string status
# Termination error code.
integer errorCode
# Issued when some information about a target has changed. This only happens between
# `targetCreated` and `targetDestroyed`.
event targetInfoChanged
parameters
TargetInfo targetInfo
# Opens a DevTools window for the target.
experimental command openDevTools
parameters
# This can be the page or tab target ID.
TargetID targetId
# The id of the panel we want DevTools to open initially. Currently
# supported panels are elements, console, network, sources, resources
# and performance.
optional string panelId
returns
# The targetId of DevTools page target.
TargetID targetId

View File

@@ -0,0 +1,28 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# The Tethering domain defines methods and events for browser port binding.
experimental domain Tethering
# Request browser port binding.
command bind
parameters
# Port number to bind.
integer port
# Request browser port unbinding.
command unbind
parameters
# Port number to unbind.
integer port
# Informs that port was successfully bound and got a specified connection id.
event accepted
parameters
# Port number that was successfully bound.
integer port
# Connection id to be used.
string connectionId

163
node_modules/devtools-protocol/pdl/domains/Tracing.pdl generated vendored Normal file
View File

@@ -0,0 +1,163 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
domain Tracing
depends on IO
# Configuration for memory dump. Used only when "memory-infra" category is enabled.
experimental type MemoryDumpConfig extends object
type TraceConfig extends object
properties
# Controls how the trace buffer stores data. The default is `recordUntilFull`.
experimental optional enum recordMode
recordUntilFull
recordContinuously
recordAsMuchAsPossible
echoToConsole
# Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value
# of 200 MB would be used.
experimental optional number traceBufferSizeInKb
# Turns on JavaScript stack sampling.
experimental optional boolean enableSampling
# Turns on system tracing.
experimental optional boolean enableSystrace
# Turns on argument filter.
experimental optional boolean enableArgumentFilter
# Included category filters.
optional array of string includedCategories
# Excluded category filters.
optional array of string excludedCategories
# Configuration to synthesize the delays in tracing.
experimental optional array of string syntheticDelays
# Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
experimental optional MemoryDumpConfig memoryDumpConfig
# Data format of a trace. Can be either the legacy JSON format or the
# protocol buffer format. Note that the JSON format will be deprecated soon.
experimental type StreamFormat extends string
enum
json
proto
# Compression type to use for traces returned via streams.
experimental type StreamCompression extends string
enum
none
gzip
# Details exposed when memory request explicitly declared.
# Keep consistent with memory_dump_request_args.h and
# memory_instrumentation.mojom
experimental type MemoryDumpLevelOfDetail extends string
enum
background
light
detailed
# Backend type to use for tracing. `chrome` uses the Chrome-integrated
# tracing service and is supported on all platforms. `system` is only
# supported on Chrome OS and uses the Perfetto system tracing service.
# `auto` chooses `system` when the perfettoConfig provided to Tracing.start
# specifies at least one non-Chrome data source; otherwise uses `chrome`.
experimental type TracingBackend extends string
enum
auto
chrome
system
# Stop trace events collection.
command end
# Gets supported tracing categories.
experimental command getCategories
returns
# A list of supported tracing categories.
array of string categories
# Return a descriptor for all available tracing categories.
experimental command getTrackEventDescriptor
returns
# Base64-encoded serialized perfetto.protos.TrackEventDescriptor protobuf message.
binary descriptor
# Record a clock sync marker in the trace.
experimental command recordClockSyncMarker
parameters
# The ID of this clock sync marker
string syncId
# Request a global memory dump.
experimental command requestMemoryDump
parameters
# Enables more deterministic results by forcing garbage collection
optional boolean deterministic
# Specifies level of details in memory dump. Defaults to "detailed".
optional MemoryDumpLevelOfDetail levelOfDetail
returns
# GUID of the resulting global memory dump.
string dumpGuid
# True iff the global memory dump succeeded.
boolean success
# Start trace events collection.
command start
parameters
# Category/tag filter
experimental deprecated optional string categories
# Tracing options
experimental deprecated optional string options
# If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
experimental optional number bufferUsageReportingInterval
# Whether to report trace events as series of dataCollected events or to save trace to a
# stream (defaults to `ReportEvents`).
optional enum transferMode
ReportEvents
ReturnAsStream
# Trace data format to use. This only applies when using `ReturnAsStream`
# transfer mode (defaults to `json`).
optional StreamFormat streamFormat
# Compression format to use. This only applies when using `ReturnAsStream`
# transfer mode (defaults to `none`)
experimental optional StreamCompression streamCompression
optional TraceConfig traceConfig
# Base64-encoded serialized perfetto.protos.TraceConfig protobuf message
# When specified, the parameters `categories`, `options`, `traceConfig`
# are ignored.
experimental optional binary perfettoConfig
# Backend type (defaults to `auto`)
experimental optional TracingBackend tracingBackend
experimental event bufferUsage
parameters
# A number in range [0..1] that indicates the used size of event buffer as a fraction of its
# total size.
optional number percentFull
# An approximate number of events in the trace log.
optional number eventCount
# A number in range [0..1] that indicates the used size of event buffer as a fraction of its
# total size.
optional number value
# Contains a bucket of collected trace events. When tracing is stopped collected events will be
# sent as a sequence of dataCollected events followed by tracingComplete event.
experimental event dataCollected
parameters
array of object value
# Signals that tracing is stopped and there is no trace buffers pending flush, all data were
# delivered via dataCollected events.
event tracingComplete
parameters
# Indicates whether some trace data is known to have been lost, e.g. because the trace ring
# buffer wrapped around.
boolean dataLossOccurred
# A handle of the stream that holds resulting trace data.
optional IO.StreamHandle stream
# Trace data format of returned stream.
optional StreamFormat traceFormat
# Compression format of returned stream.
optional StreamCompression streamCompression

205
node_modules/devtools-protocol/pdl/domains/WebAudio.pdl generated vendored Normal file
View File

@@ -0,0 +1,205 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows inspection of Web Audio API.
# https://webaudio.github.io/web-audio-api/
experimental domain WebAudio
# An unique ID for a graph object (AudioContext, AudioNode, AudioParam) in Web Audio API
type GraphObjectId extends string
# Enum of BaseAudioContext types
type ContextType extends string
enum
realtime
offline
# Enum of AudioContextState from the spec
type ContextState extends string
enum
suspended
running
closed
interrupted
# Enum of AudioNode types
type NodeType extends string
# Enum of AudioNode::ChannelCountMode from the spec
type ChannelCountMode extends string
enum
clamped-max
explicit
max
# Enum of AudioNode::ChannelInterpretation from the spec
type ChannelInterpretation extends string
enum
discrete
speakers
# Enum of AudioParam types
type ParamType extends string
# Enum of AudioParam::AutomationRate from the spec
type AutomationRate extends string
enum
a-rate
k-rate
# Fields in AudioContext that change in real-time.
type ContextRealtimeData extends object
properties
# The current context time in second in BaseAudioContext.
number currentTime
# The time spent on rendering graph divided by render quantum duration,
# and multiplied by 100. 100 means the audio renderer reached the full
# capacity and glitch may occur.
number renderCapacity
# A running mean of callback interval.
number callbackIntervalMean
# A running variance of callback interval.
number callbackIntervalVariance
# Protocol object for BaseAudioContext
type BaseAudioContext extends object
properties
GraphObjectId contextId
ContextType contextType
ContextState contextState
optional ContextRealtimeData realtimeData
# Platform-dependent callback buffer size.
number callbackBufferSize
# Number of output channels supported by audio hardware in use.
number maxOutputChannelCount
# Context sample rate.
number sampleRate
# Protocol object for AudioListener
type AudioListener extends object
properties
GraphObjectId listenerId
GraphObjectId contextId
# Protocol object for AudioNode
type AudioNode extends object
properties
GraphObjectId nodeId
GraphObjectId contextId
NodeType nodeType
number numberOfInputs
number numberOfOutputs
number channelCount
ChannelCountMode channelCountMode
ChannelInterpretation channelInterpretation
# Protocol object for AudioParam
type AudioParam extends object
properties
GraphObjectId paramId
GraphObjectId nodeId
GraphObjectId contextId
ParamType paramType
AutomationRate rate
number defaultValue
number minValue
number maxValue
# Enables the WebAudio domain and starts sending context lifetime events.
command enable
# Disables the WebAudio domain.
command disable
# Fetch the realtime data from the registered contexts.
command getRealtimeData
parameters
GraphObjectId contextId
returns
ContextRealtimeData realtimeData
# Notifies that a new BaseAudioContext has been created.
event contextCreated
parameters
BaseAudioContext context
# Notifies that an existing BaseAudioContext will be destroyed.
event contextWillBeDestroyed
parameters
GraphObjectId contextId
# Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
event contextChanged
parameters
BaseAudioContext context
# Notifies that the construction of an AudioListener has finished.
event audioListenerCreated
parameters
AudioListener listener
# Notifies that a new AudioListener has been created.
event audioListenerWillBeDestroyed
parameters
GraphObjectId contextId
GraphObjectId listenerId
# Notifies that a new AudioNode has been created.
event audioNodeCreated
parameters
AudioNode node
# Notifies that an existing AudioNode has been destroyed.
event audioNodeWillBeDestroyed
parameters
GraphObjectId contextId
GraphObjectId nodeId
# Notifies that a new AudioParam has been created.
event audioParamCreated
parameters
AudioParam param
# Notifies that an existing AudioParam has been destroyed.
event audioParamWillBeDestroyed
parameters
GraphObjectId contextId
GraphObjectId nodeId
GraphObjectId paramId
# Notifies that two AudioNodes are connected.
event nodesConnected
parameters
GraphObjectId contextId
GraphObjectId sourceId
GraphObjectId destinationId
optional number sourceOutputIndex
optional number destinationInputIndex
# Notifies that AudioNodes are disconnected. The destination can be null, and it means all the outgoing connections from the source are disconnected.
event nodesDisconnected
parameters
GraphObjectId contextId
GraphObjectId sourceId
GraphObjectId destinationId
optional number sourceOutputIndex
optional number destinationInputIndex
# Notifies that an AudioNode is connected to an AudioParam.
event nodeParamConnected
parameters
GraphObjectId contextId
GraphObjectId sourceId
GraphObjectId destinationId
optional number sourceOutputIndex
# Notifies that an AudioNode is disconnected to an AudioParam.
event nodeParamDisconnected
parameters
GraphObjectId contextId
GraphObjectId sourceId
GraphObjectId destinationId
optional number sourceOutputIndex

230
node_modules/devtools-protocol/pdl/domains/WebAuthn.pdl generated vendored Normal file
View File

@@ -0,0 +1,230 @@
# Copyright 2017 The Chromium Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
#
# Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
# This domain allows configuring virtual authenticators to test the WebAuthn
# API.
experimental domain WebAuthn
type AuthenticatorId extends string
type AuthenticatorProtocol extends string
enum
# Universal 2nd Factor.
u2f
# Client To Authenticator Protocol 2.
ctap2
type Ctap2Version extends string
enum
ctap2_0
ctap2_1
type AuthenticatorTransport extends string
enum
# Cross-Platform authenticator attachments:
usb
nfc
ble
cable
# Platform authenticator attachment:
internal
type VirtualAuthenticatorOptions extends object
properties
AuthenticatorProtocol protocol
# Defaults to ctap2_0. Ignored if |protocol| == u2f.
optional Ctap2Version ctap2Version
AuthenticatorTransport transport
# Defaults to false.
optional boolean hasResidentKey
# Defaults to false.
optional boolean hasUserVerification
# If set to true, the authenticator will support the largeBlob extension.
# https://w3c.github.io/webauthn#largeBlob
# Defaults to false.
optional boolean hasLargeBlob
# If set to true, the authenticator will support the credBlob extension.
# https://fidoalliance.org/specs/fido-v2.1-rd-20201208/fido-client-to-authenticator-protocol-v2.1-rd-20201208.html#sctn-credBlob-extension
# Defaults to false.
optional boolean hasCredBlob
# If set to true, the authenticator will support the minPinLength extension.
# https://fidoalliance.org/specs/fido-v2.1-ps-20210615/fido-client-to-authenticator-protocol-v2.1-ps-20210615.html#sctn-minpinlength-extension
# Defaults to false.
optional boolean hasMinPinLength
# If set to true, the authenticator will support the prf extension.
# https://w3c.github.io/webauthn/#prf-extension
# Defaults to false.
optional boolean hasPrf
# If set to true, tests of user presence will succeed immediately.
# Otherwise, they will not be resolved. Defaults to true.
optional boolean automaticPresenceSimulation
# Sets whether User Verification succeeds or fails for an authenticator.
# Defaults to false.
optional boolean isUserVerified
# Credentials created by this authenticator will have the backup
# eligibility (BE) flag set to this value. Defaults to false.
# https://w3c.github.io/webauthn/#sctn-credential-backup
optional boolean defaultBackupEligibility
# Credentials created by this authenticator will have the backup state
# (BS) flag set to this value. Defaults to false.
# https://w3c.github.io/webauthn/#sctn-credential-backup
optional boolean defaultBackupState
type Credential extends object
properties
binary credentialId
boolean isResidentCredential
# Relying Party ID the credential is scoped to. Must be set when adding a
# credential.
optional string rpId
# The ECDSA P-256 private key in PKCS#8 format.
binary privateKey
# An opaque byte sequence with a maximum size of 64 bytes mapping the
# credential to a specific user.
optional binary userHandle
# Signature counter. This is incremented by one for each successful
# assertion.
# See https://w3c.github.io/webauthn/#signature-counter
integer signCount
# The large blob associated with the credential.
# See https://w3c.github.io/webauthn/#sctn-large-blob-extension
optional binary largeBlob
# Assertions returned by this credential will have the backup eligibility
# (BE) flag set to this value. Defaults to the authenticator's
# defaultBackupEligibility value.
optional boolean backupEligibility
# Assertions returned by this credential will have the backup state (BS)
# flag set to this value. Defaults to the authenticator's
# defaultBackupState value.
optional boolean backupState
# The credential's user.name property. Equivalent to empty if not set.
# https://w3c.github.io/webauthn/#dom-publickeycredentialentity-name
optional string userName
# The credential's user.displayName property. Equivalent to empty if
# not set.
# https://w3c.github.io/webauthn/#dom-publickeycredentialuserentity-displayname
optional string userDisplayName
# Enable the WebAuthn domain and start intercepting credential storage and
# retrieval with a virtual authenticator.
command enable
parameters
# Whether to enable the WebAuthn user interface. Enabling the UI is
# recommended for debugging and demo purposes, as it is closer to the real
# experience. Disabling the UI is recommended for automated testing.
# Supported at the embedder's discretion if UI is available.
# Defaults to false.
optional boolean enableUI
# Disable the WebAuthn domain.
command disable
# Creates and adds a virtual authenticator.
command addVirtualAuthenticator
parameters
VirtualAuthenticatorOptions options
returns
AuthenticatorId authenticatorId
# Resets parameters isBogusSignature, isBadUV, isBadUP to false if they are not present.
command setResponseOverrideBits
parameters
AuthenticatorId authenticatorId
# If isBogusSignature is set, overrides the signature in the authenticator response to be zero.
# Defaults to false.
optional boolean isBogusSignature
# If isBadUV is set, overrides the UV bit in the flags in the authenticator response to
# be zero. Defaults to false.
optional boolean isBadUV
# If isBadUP is set, overrides the UP bit in the flags in the authenticator response to
# be zero. Defaults to false.
optional boolean isBadUP
# Removes the given authenticator.
command removeVirtualAuthenticator
parameters
AuthenticatorId authenticatorId
# Adds the credential to the specified authenticator.
command addCredential
parameters
AuthenticatorId authenticatorId
Credential credential
# Returns a single credential stored in the given virtual authenticator that
# matches the credential ID.
command getCredential
parameters
AuthenticatorId authenticatorId
binary credentialId
returns
Credential credential
# Returns all the credentials stored in the given virtual authenticator.
command getCredentials
parameters
AuthenticatorId authenticatorId
returns
array of Credential credentials
# Removes a credential from the authenticator.
command removeCredential
parameters
AuthenticatorId authenticatorId
binary credentialId
# Clears all the credentials from the specified device.
command clearCredentials
parameters
AuthenticatorId authenticatorId
# Sets whether User Verification succeeds or fails for an authenticator.
# The default is true.
command setUserVerified
parameters
AuthenticatorId authenticatorId
boolean isUserVerified
# Sets whether tests of user presence will succeed immediately (if true) or fail to resolve (if false) for an authenticator.
# The default is true.
command setAutomaticPresenceSimulation
parameters
AuthenticatorId authenticatorId
boolean enabled
# Allows setting credential properties.
# https://w3c.github.io/webauthn/#sctn-automation-set-credential-properties
command setCredentialProperties
parameters
AuthenticatorId authenticatorId
binary credentialId
optional boolean backupEligibility
optional boolean backupState
# Triggered when a credential is added to an authenticator.
event credentialAdded
parameters
AuthenticatorId authenticatorId
Credential credential
# Triggered when a credential is deleted, e.g. through
# PublicKeyCredential.signalUnknownCredential().
event credentialDeleted
parameters
AuthenticatorId authenticatorId
binary credentialId
# Triggered when a credential is updated, e.g. through
# PublicKeyCredential.signalCurrentUserDetails().
event credentialUpdated
parameters
AuthenticatorId authenticatorId
Credential credential
# Triggered when a credential is used in a webauthn assertion.
event credentialAsserted
parameters
AuthenticatorId authenticatorId
Credential credential

1843
node_modules/devtools-protocol/pdl/js_protocol.pdl generated vendored Normal file

File diff suppressed because it is too large Load Diff