devtools-protocol 0.0.1498597 → 0.0.1501779

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/json/browser_protocol.json +17960 -17689
  2. package/json/js_protocol.json +6 -0
  3. package/package.json +1 -1
  4. package/pdl/browser_protocol.pdl +47 -13824
  5. package/pdl/domains/Accessibility.pdl +290 -0
  6. package/pdl/domains/Animation.pdl +195 -0
  7. package/pdl/domains/Audits.pdl +755 -0
  8. package/pdl/domains/Autofill.pdl +106 -0
  9. package/pdl/domains/BackgroundService.pdl +77 -0
  10. package/pdl/domains/BluetoothEmulation.pdl +227 -0
  11. package/pdl/domains/Browser.pdl +345 -0
  12. package/pdl/domains/CSS.pdl +996 -0
  13. package/pdl/domains/CacheStorage.pdl +125 -0
  14. package/pdl/domains/Cast.pdl +62 -0
  15. package/pdl/domains/DOM.pdl +932 -0
  16. package/pdl/domains/DOMDebugger.pdl +128 -0
  17. package/pdl/domains/DOMSnapshot.pdl +319 -0
  18. package/pdl/domains/DOMStorage.pdl +72 -0
  19. package/pdl/domains/DeviceAccess.pdl +43 -0
  20. package/pdl/domains/DeviceOrientation.pdl +20 -0
  21. package/pdl/domains/Emulation.pdl +608 -0
  22. package/pdl/domains/EventBreakpoints.pdl +24 -0
  23. package/pdl/domains/Extensions.pdl +72 -0
  24. package/pdl/domains/FedCm.pdl +100 -0
  25. package/pdl/domains/Fetch.pdl +251 -0
  26. package/pdl/domains/FileSystem.pdl +41 -0
  27. package/pdl/domains/HeadlessExperimental.pdl +56 -0
  28. package/pdl/domains/IO.pdl +45 -0
  29. package/pdl/domains/IndexedDB.pdl +226 -0
  30. package/pdl/domains/Input.pdl +336 -0
  31. package/pdl/domains/Inspector.pdl +25 -0
  32. package/pdl/domains/LayerTree.pdl +178 -0
  33. package/pdl/domains/Log.pdl +93 -0
  34. package/pdl/domains/Media.pdl +106 -0
  35. package/pdl/domains/Memory.pdl +112 -0
  36. package/pdl/domains/Network.pdl +2039 -0
  37. package/pdl/domains/Overlay.pdl +498 -0
  38. package/pdl/domains/PWA.pdl +142 -0
  39. package/pdl/domains/Page.pdl +1767 -0
  40. package/pdl/domains/Performance.pdl +54 -0
  41. package/pdl/domains/PerformanceTimeline.pdl +71 -0
  42. package/pdl/domains/Preload.pdl +290 -0
  43. package/pdl/domains/Security.pdl +196 -0
  44. package/pdl/domains/ServiceWorker.pdl +121 -0
  45. package/pdl/domains/Storage.pdl +913 -0
  46. package/pdl/domains/SystemInfo.pdl +145 -0
  47. package/pdl/domains/Target.pdl +327 -0
  48. package/pdl/domains/Tethering.pdl +28 -0
  49. package/pdl/domains/Tracing.pdl +157 -0
  50. package/pdl/domains/WebAudio.pdl +205 -0
  51. package/pdl/domains/WebAuthn.pdl +230 -0
  52. package/types/protocol-mapping.d.ts +992 -615
  53. package/types/protocol-proxy-api.d.ts +543 -522
  54. package/types/protocol-tests-proxy-api.d.ts +628 -607
  55. package/types/protocol.d.ts +8059 -7903
@@ -0,0 +1,996 @@
1
+ # Copyright 2017 The Chromium Authors
2
+ # Use of this source code is governed by a BSD-style license that can be
3
+ # found in the LICENSE file.
4
+ #
5
+ # Contributing to Chrome DevTools Protocol: https://goo.gle/devtools-contribution-guide-cdp
6
+
7
+ # This domain exposes CSS read/write operations. All CSS objects (stylesheets, rules, and styles)
8
+ # have an associated `id` used in subsequent operations on the related object. Each object type has
9
+ # a specific `id` structure, and those are not interchangeable between objects of different kinds.
10
+ # CSS objects can be loaded using the `get*ForNode()` calls (which accept a DOM node id). A client
11
+ # can also keep track of stylesheets via the `styleSheetAdded`/`styleSheetRemoved` events and
12
+ # subsequently load the required stylesheet contents using the `getStyleSheet[Text]()` methods.
13
+ experimental domain CSS
14
+ depends on DOM
15
+ depends on Page
16
+
17
+ type StyleSheetId extends string
18
+
19
+ # Stylesheet type: "injected" for stylesheets injected via extension, "user-agent" for user-agent
20
+ # stylesheets, "inspector" for stylesheets created by the inspector (i.e. those holding the "via
21
+ # inspector" rules), "regular" for regular stylesheets.
22
+ type StyleSheetOrigin extends string
23
+ enum
24
+ injected
25
+ user-agent
26
+ inspector
27
+ regular
28
+
29
+ # CSS rule collection for a single pseudo style.
30
+ type PseudoElementMatches extends object
31
+ properties
32
+ # Pseudo element type.
33
+ DOM.PseudoType pseudoType
34
+ # Pseudo element custom ident.
35
+ optional string pseudoIdentifier
36
+ # Matches of CSS rules applicable to the pseudo style.
37
+ array of RuleMatch matches
38
+
39
+ # CSS style coming from animations with the name of the animation.
40
+ type CSSAnimationStyle extends object
41
+ properties
42
+ # The name of the animation.
43
+ optional string name
44
+ # The style coming from the animation.
45
+ CSSStyle style
46
+
47
+ # Inherited CSS rule collection from ancestor node.
48
+ type InheritedStyleEntry extends object
49
+ properties
50
+ # The ancestor node's inline style, if any, in the style inheritance chain.
51
+ optional CSSStyle inlineStyle
52
+ # Matches of CSS rules matching the ancestor node in the style inheritance chain.
53
+ array of RuleMatch matchedCSSRules
54
+
55
+ # Inherited CSS style collection for animated styles from ancestor node.
56
+ type InheritedAnimatedStyleEntry extends object
57
+ properties
58
+ # Styles coming from the animations of the ancestor, if any, in the style inheritance chain.
59
+ optional array of CSSAnimationStyle animationStyles
60
+ # The style coming from the transitions of the ancestor, if any, in the style inheritance chain.
61
+ optional CSSStyle transitionsStyle
62
+
63
+ # Inherited pseudo element matches from pseudos of an ancestor node.
64
+ type InheritedPseudoElementMatches extends object
65
+ properties
66
+ # Matches of pseudo styles from the pseudos of an ancestor node.
67
+ array of PseudoElementMatches pseudoElements
68
+
69
+ # Match data for a CSS rule.
70
+ type RuleMatch extends object
71
+ properties
72
+ # CSS rule in the match.
73
+ CSSRule rule
74
+ # Matching selector indices in the rule's selectorList selectors (0-based).
75
+ array of integer matchingSelectors
76
+
77
+ # Data for a simple selector (these are delimited by commas in a selector list).
78
+ type Value extends object
79
+ properties
80
+ # Value text.
81
+ string text
82
+ # Value range in the underlying resource (if available).
83
+ optional SourceRange range
84
+ # Specificity of the selector.
85
+ experimental optional Specificity specificity
86
+
87
+ # Specificity:
88
+ # https://drafts.csswg.org/selectors/#specificity-rules
89
+ experimental type Specificity extends object
90
+ properties
91
+ # The a component, which represents the number of ID selectors.
92
+ integer a
93
+ # The b component, which represents the number of class selectors, attributes selectors, and
94
+ # pseudo-classes.
95
+ integer b
96
+ # The c component, which represents the number of type selectors and pseudo-elements.
97
+ integer c
98
+
99
+ # Selector list data.
100
+ type SelectorList extends object
101
+ properties
102
+ # Selectors in the list.
103
+ array of Value selectors
104
+ # Rule selector text.
105
+ string text
106
+
107
+ # CSS stylesheet metainformation.
108
+ type CSSStyleSheetHeader extends object
109
+ properties
110
+ # The stylesheet identifier.
111
+ StyleSheetId styleSheetId
112
+ # Owner frame identifier.
113
+ Page.FrameId frameId
114
+ # Stylesheet resource URL. Empty if this is a constructed stylesheet created using
115
+ # new CSSStyleSheet() (but non-empty if this is a constructed stylesheet imported
116
+ # as a CSS module script).
117
+ string sourceURL
118
+ # URL of source map associated with the stylesheet (if any).
119
+ optional string sourceMapURL
120
+ # Stylesheet origin.
121
+ StyleSheetOrigin origin
122
+ # Stylesheet title.
123
+ string title
124
+ # The backend id for the owner node of the stylesheet.
125
+ optional DOM.BackendNodeId ownerNode
126
+ # Denotes whether the stylesheet is disabled.
127
+ boolean disabled
128
+ # Whether the sourceURL field value comes from the sourceURL comment.
129
+ optional boolean hasSourceURL
130
+ # Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
131
+ # document.written STYLE tags.
132
+ boolean isInline
133
+ # Whether this stylesheet is mutable. Inline stylesheets become mutable
134
+ # after they have been modified via CSSOM API.
135
+ # `<link>` element's stylesheets become mutable only if DevTools modifies them.
136
+ # Constructed stylesheets (new CSSStyleSheet()) are mutable immediately after creation.
137
+ boolean isMutable
138
+ # True if this stylesheet is created through new CSSStyleSheet() or imported as a
139
+ # CSS module script.
140
+ boolean isConstructed
141
+ # Line offset of the stylesheet within the resource (zero based).
142
+ number startLine
143
+ # Column offset of the stylesheet within the resource (zero based).
144
+ number startColumn
145
+ # Size of the content (in characters).
146
+ number length
147
+ # Line offset of the end of the stylesheet within the resource (zero based).
148
+ number endLine
149
+ # Column offset of the end of the stylesheet within the resource (zero based).
150
+ number endColumn
151
+ # If the style sheet was loaded from a network resource, this indicates when the resource failed to load
152
+ experimental optional boolean loadingFailed
153
+
154
+ # CSS rule representation.
155
+ type CSSRule extends object
156
+ properties
157
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
158
+ # stylesheet rules) this rule came from.
159
+ optional StyleSheetId styleSheetId
160
+ # Rule selector data.
161
+ SelectorList selectorList
162
+ # Array of selectors from ancestor style rules, sorted by distance from the current rule.
163
+ experimental optional array of string nestingSelectors
164
+ # Parent stylesheet's origin.
165
+ StyleSheetOrigin origin
166
+ # Associated style declaration.
167
+ CSSStyle style
168
+ # Media list array (for rules involving media queries). The array enumerates media queries
169
+ # starting with the innermost one, going outwards.
170
+ optional array of CSSMedia media
171
+ # Container query list array (for rules involving container queries).
172
+ # The array enumerates container queries starting with the innermost one, going outwards.
173
+ experimental optional array of CSSContainerQuery containerQueries
174
+ # @supports CSS at-rule array.
175
+ # The array enumerates @supports at-rules starting with the innermost one, going outwards.
176
+ experimental optional array of CSSSupports supports
177
+ # Cascade layer array. Contains the layer hierarchy that this rule belongs to starting
178
+ # with the innermost layer and going outwards.
179
+ experimental optional array of CSSLayer layers
180
+ # @scope CSS at-rule array.
181
+ # The array enumerates @scope at-rules starting with the innermost one, going outwards.
182
+ experimental optional array of CSSScope scopes
183
+ # The array keeps the types of ancestor CSSRules from the innermost going outwards.
184
+ experimental optional array of CSSRuleType ruleTypes
185
+ # @starting-style CSS at-rule array.
186
+ # The array enumerates @starting-style at-rules starting with the innermost one, going outwards.
187
+ experimental optional array of CSSStartingStyle startingStyles
188
+
189
+ # Enum indicating the type of a CSS rule, used to represent the order of a style rule's ancestors.
190
+ # This list only contains rule types that are collected during the ancestor rule collection.
191
+ experimental type CSSRuleType extends string
192
+ enum
193
+ MediaRule
194
+ SupportsRule
195
+ ContainerRule
196
+ LayerRule
197
+ ScopeRule
198
+ StyleRule
199
+ StartingStyleRule
200
+
201
+ # CSS coverage information.
202
+ type RuleUsage extends object
203
+ properties
204
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
205
+ # stylesheet rules) this rule came from.
206
+ StyleSheetId styleSheetId
207
+ # Offset of the start of the rule (including selector) from the beginning of the stylesheet.
208
+ number startOffset
209
+ # Offset of the end of the rule body from the beginning of the stylesheet.
210
+ number endOffset
211
+ # Indicates whether the rule was actually used by some element in the page.
212
+ boolean used
213
+
214
+ # Text range within a resource. All numbers are zero-based.
215
+ type SourceRange extends object
216
+ properties
217
+ # Start line of range.
218
+ integer startLine
219
+ # Start column of range (inclusive).
220
+ integer startColumn
221
+ # End line of range
222
+ integer endLine
223
+ # End column of range (exclusive).
224
+ integer endColumn
225
+
226
+ type ShorthandEntry extends object
227
+ properties
228
+ # Shorthand name.
229
+ string name
230
+ # Shorthand value.
231
+ string value
232
+ # Whether the property has "!important" annotation (implies `false` if absent).
233
+ optional boolean important
234
+
235
+ type CSSComputedStyleProperty extends object
236
+ properties
237
+ # Computed style property name.
238
+ string name
239
+ # Computed style property value.
240
+ string value
241
+
242
+ # CSS style representation.
243
+ type CSSStyle extends object
244
+ properties
245
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
246
+ # stylesheet rules) this rule came from.
247
+ optional StyleSheetId styleSheetId
248
+ # CSS properties in the style.
249
+ array of CSSProperty cssProperties
250
+ # Computed values for all shorthands found in the style.
251
+ array of ShorthandEntry shorthandEntries
252
+ # Style declaration text (if available).
253
+ optional string cssText
254
+ # Style declaration range in the enclosing stylesheet (if available).
255
+ optional SourceRange range
256
+
257
+ # CSS property declaration data.
258
+ type CSSProperty extends object
259
+ properties
260
+ # The property name.
261
+ string name
262
+ # The property value.
263
+ string value
264
+ # Whether the property has "!important" annotation (implies `false` if absent).
265
+ optional boolean important
266
+ # Whether the property is implicit (implies `false` if absent).
267
+ optional boolean implicit
268
+ # The full property text as specified in the style.
269
+ optional string text
270
+ # Whether the property is understood by the browser (implies `true` if absent).
271
+ optional boolean parsedOk
272
+ # Whether the property is disabled by the user (present for source-based properties only).
273
+ optional boolean disabled
274
+ # The entire property range in the enclosing style declaration (if available).
275
+ optional SourceRange range
276
+ # Parsed longhand components of this property if it is a shorthand.
277
+ # This field will be empty if the given property is not a shorthand.
278
+ experimental optional array of CSSProperty longhandProperties
279
+
280
+ # CSS media rule descriptor.
281
+ type CSSMedia extends object
282
+ properties
283
+ # Media query text.
284
+ string text
285
+ # Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
286
+ # specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
287
+ # stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
288
+ # stylesheet's STYLE tag.
289
+ enum source
290
+ mediaRule
291
+ importRule
292
+ linkedSheet
293
+ inlineSheet
294
+ # URL of the document containing the media query description.
295
+ optional string sourceURL
296
+ # The associated rule (@media or @import) header range in the enclosing stylesheet (if
297
+ # available).
298
+ optional SourceRange range
299
+ # Identifier of the stylesheet containing this object (if exists).
300
+ optional StyleSheetId styleSheetId
301
+ # Array of media queries.
302
+ optional array of MediaQuery mediaList
303
+
304
+ # Media query descriptor.
305
+ type MediaQuery extends object
306
+ properties
307
+ # Array of media query expressions.
308
+ array of MediaQueryExpression expressions
309
+ # Whether the media query condition is satisfied.
310
+ boolean active
311
+
312
+ # Media query expression descriptor.
313
+ type MediaQueryExpression extends object
314
+ properties
315
+ # Media query expression value.
316
+ number value
317
+ # Media query expression units.
318
+ string unit
319
+ # Media query expression feature.
320
+ string feature
321
+ # The associated range of the value text in the enclosing stylesheet (if available).
322
+ optional SourceRange valueRange
323
+ # Computed length of media query expression (if applicable).
324
+ optional number computedLength
325
+
326
+ # CSS container query rule descriptor.
327
+ experimental type CSSContainerQuery extends object
328
+ properties
329
+ # Container query text.
330
+ string text
331
+ # The associated rule header range in the enclosing stylesheet (if
332
+ # available).
333
+ optional SourceRange range
334
+ # Identifier of the stylesheet containing this object (if exists).
335
+ optional StyleSheetId styleSheetId
336
+ # Optional name for the container.
337
+ optional string name
338
+ # Optional physical axes queried for the container.
339
+ optional DOM.PhysicalAxes physicalAxes
340
+ # Optional logical axes queried for the container.
341
+ optional DOM.LogicalAxes logicalAxes
342
+ # true if the query contains scroll-state() queries.
343
+ optional boolean queriesScrollState
344
+ # true if the query contains anchored() queries.
345
+ optional boolean queriesAnchored
346
+
347
+ # CSS Supports at-rule descriptor.
348
+ experimental type CSSSupports extends object
349
+ properties
350
+ # Supports rule text.
351
+ string text
352
+ # Whether the supports condition is satisfied.
353
+ boolean active
354
+ # The associated rule header range in the enclosing stylesheet (if
355
+ # available).
356
+ optional SourceRange range
357
+ # Identifier of the stylesheet containing this object (if exists).
358
+ optional StyleSheetId styleSheetId
359
+
360
+ # CSS Scope at-rule descriptor.
361
+ experimental type CSSScope extends object
362
+ properties
363
+ # Scope rule text.
364
+ string text
365
+ # The associated rule header range in the enclosing stylesheet (if
366
+ # available).
367
+ optional SourceRange range
368
+ # Identifier of the stylesheet containing this object (if exists).
369
+ optional StyleSheetId styleSheetId
370
+
371
+ # CSS Layer at-rule descriptor.
372
+ experimental type CSSLayer extends object
373
+ properties
374
+ # Layer name.
375
+ string text
376
+ # The associated rule header range in the enclosing stylesheet (if
377
+ # available).
378
+ optional SourceRange range
379
+ # Identifier of the stylesheet containing this object (if exists).
380
+ optional StyleSheetId styleSheetId
381
+
382
+ # CSS Starting Style at-rule descriptor.
383
+ experimental type CSSStartingStyle extends object
384
+ properties
385
+ # The associated rule header range in the enclosing stylesheet (if
386
+ # available).
387
+ optional SourceRange range
388
+ # Identifier of the stylesheet containing this object (if exists).
389
+ optional StyleSheetId styleSheetId
390
+
391
+ # CSS Layer data.
392
+ experimental type CSSLayerData extends object
393
+ properties
394
+ # Layer name.
395
+ string name
396
+ # Direct sub-layers
397
+ optional array of CSSLayerData subLayers
398
+ # Layer order. The order determines the order of the layer in the cascade order.
399
+ # A higher number has higher priority in the cascade order.
400
+ number order
401
+
402
+ # Information about amount of glyphs that were rendered with given font.
403
+ type PlatformFontUsage extends object
404
+ properties
405
+ # Font's family name reported by platform.
406
+ string familyName
407
+ # Font's PostScript name reported by platform.
408
+ string postScriptName
409
+ # Indicates if the font was downloaded or resolved locally.
410
+ boolean isCustomFont
411
+ # Amount of glyphs that were rendered with this font.
412
+ number glyphCount
413
+
414
+ # Information about font variation axes for variable fonts
415
+ type FontVariationAxis extends object
416
+ properties
417
+ # The font-variation-setting tag (a.k.a. "axis tag").
418
+ string tag
419
+ # Human-readable variation name in the default language (normally, "en").
420
+ string name
421
+ # The minimum value (inclusive) the font supports for this tag.
422
+ number minValue
423
+ # The maximum value (inclusive) the font supports for this tag.
424
+ number maxValue
425
+ # The default value.
426
+ number defaultValue
427
+
428
+ # Properties of a web font: https://www.w3.org/TR/2008/REC-CSS2-20080411/fonts.html#font-descriptions
429
+ # and additional information such as platformFontFamily and fontVariationAxes.
430
+ type FontFace extends object
431
+ properties
432
+ # The font-family.
433
+ string fontFamily
434
+ # The font-style.
435
+ string fontStyle
436
+ # The font-variant.
437
+ string fontVariant
438
+ # The font-weight.
439
+ string fontWeight
440
+ # The font-stretch.
441
+ string fontStretch
442
+ # The font-display.
443
+ string fontDisplay
444
+ # The unicode-range.
445
+ string unicodeRange
446
+ # The src.
447
+ string src
448
+ # The resolved platform font family
449
+ string platformFontFamily
450
+ # Available variation settings (a.k.a. "axes").
451
+ optional array of FontVariationAxis fontVariationAxes
452
+
453
+ # CSS try rule representation.
454
+ type CSSTryRule extends object
455
+ properties
456
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
457
+ # stylesheet rules) this rule came from.
458
+ optional StyleSheetId styleSheetId
459
+ # Parent stylesheet's origin.
460
+ StyleSheetOrigin origin
461
+ # Associated style declaration.
462
+ CSSStyle style
463
+
464
+ # CSS @position-try rule representation.
465
+ type CSSPositionTryRule extends object
466
+ properties
467
+ # The prelude dashed-ident name
468
+ Value name
469
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
470
+ # stylesheet rules) this rule came from.
471
+ optional StyleSheetId styleSheetId
472
+ # Parent stylesheet's origin.
473
+ StyleSheetOrigin origin
474
+ # Associated style declaration.
475
+ CSSStyle style
476
+ boolean active
477
+
478
+ # CSS keyframes rule representation.
479
+ type CSSKeyframesRule extends object
480
+ properties
481
+ # Animation name.
482
+ Value animationName
483
+ # List of keyframes.
484
+ array of CSSKeyframeRule keyframes
485
+
486
+ # Representation of a custom property registration through CSS.registerProperty
487
+ type CSSPropertyRegistration extends object
488
+ properties
489
+ string propertyName
490
+ optional Value initialValue
491
+ boolean inherits
492
+ string syntax
493
+
494
+
495
+ # CSS font-palette-values rule representation.
496
+ type CSSFontPaletteValuesRule extends object
497
+ properties
498
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
499
+ # stylesheet rules) this rule came from.
500
+ optional StyleSheetId styleSheetId
501
+ # Parent stylesheet's origin.
502
+ StyleSheetOrigin origin
503
+ # Associated font palette name.
504
+ Value fontPaletteName
505
+ # Associated style declaration.
506
+ CSSStyle style
507
+
508
+ # CSS property at-rule representation.
509
+ type CSSPropertyRule extends object
510
+ properties
511
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
512
+ # stylesheet rules) this rule came from.
513
+ optional StyleSheetId styleSheetId
514
+ # Parent stylesheet's origin.
515
+ StyleSheetOrigin origin
516
+ # Associated property name.
517
+ Value propertyName
518
+ # Associated style declaration.
519
+ CSSStyle style
520
+
521
+ # CSS function argument representation.
522
+ type CSSFunctionParameter extends object
523
+ properties
524
+ # The parameter name.
525
+ string name
526
+ # The parameter type.
527
+ string type
528
+
529
+ # CSS function conditional block representation.
530
+ type CSSFunctionConditionNode extends object
531
+ properties
532
+ # Media query for this conditional block. Only one type of condition should be set.
533
+ optional CSSMedia media
534
+ # Container query for this conditional block. Only one type of condition should be set.
535
+ optional CSSContainerQuery containerQueries
536
+ # @supports CSS at-rule condition. Only one type of condition should be set.
537
+ optional CSSSupports supports
538
+ # Block body.
539
+ array of CSSFunctionNode children
540
+ # The condition text.
541
+ string conditionText
542
+
543
+ # Section of the body of a CSS function rule.
544
+ type CSSFunctionNode extends object
545
+ properties
546
+ # A conditional block. If set, style should not be set.
547
+ optional CSSFunctionConditionNode condition
548
+ # Values set by this node. If set, condition should not be set.
549
+ optional CSSStyle style
550
+
551
+ # CSS function at-rule representation.
552
+ type CSSFunctionRule extends object
553
+ properties
554
+ # Name of the function.
555
+ Value name
556
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
557
+ # stylesheet rules) this rule came from.
558
+ optional StyleSheetId styleSheetId
559
+ # Parent stylesheet's origin.
560
+ StyleSheetOrigin origin
561
+ # List of parameters.
562
+ array of CSSFunctionParameter parameters
563
+ # Function body.
564
+ array of CSSFunctionNode children
565
+
566
+ # CSS keyframe rule representation.
567
+ type CSSKeyframeRule extends object
568
+ properties
569
+ # The css style sheet identifier (absent for user agent stylesheet and user-specified
570
+ # stylesheet rules) this rule came from.
571
+ optional StyleSheetId styleSheetId
572
+ # Parent stylesheet's origin.
573
+ StyleSheetOrigin origin
574
+ # Associated key text.
575
+ Value keyText
576
+ # Associated style declaration.
577
+ CSSStyle style
578
+
579
+ # A descriptor of operation to mutate style declaration text.
580
+ type StyleDeclarationEdit extends object
581
+ properties
582
+ # The css style sheet identifier.
583
+ StyleSheetId styleSheetId
584
+ # The range of the style text in the enclosing stylesheet.
585
+ SourceRange range
586
+ # New style text.
587
+ string text
588
+
589
+ # Inserts a new rule with the given `ruleText` in a stylesheet with given `styleSheetId`, at the
590
+ # position specified by `location`.
591
+ command addRule
592
+ parameters
593
+ # The css style sheet identifier where a new rule should be inserted.
594
+ StyleSheetId styleSheetId
595
+ # The text of a new rule.
596
+ string ruleText
597
+ # Text position of a new rule in the target style sheet.
598
+ SourceRange location
599
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
600
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
601
+ # incorrect results if the declaration contains a var() for example.
602
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
603
+ returns
604
+ # The newly created rule.
605
+ CSSRule rule
606
+
607
+ # Returns all class names from specified stylesheet.
608
+ command collectClassNames
609
+ parameters
610
+ StyleSheetId styleSheetId
611
+ returns
612
+ # Class name list.
613
+ array of string classNames
614
+
615
+ # Creates a new special "via-inspector" stylesheet in the frame with given `frameId`.
616
+ command createStyleSheet
617
+ parameters
618
+ # Identifier of the frame where "via-inspector" stylesheet should be created.
619
+ Page.FrameId frameId
620
+ # If true, creates a new stylesheet for every call. If false,
621
+ # returns a stylesheet previously created by a call with force=false
622
+ # for the frame's document if it exists or creates a new stylesheet
623
+ # (default: false).
624
+ optional boolean force
625
+ returns
626
+ # Identifier of the created "via-inspector" stylesheet.
627
+ StyleSheetId styleSheetId
628
+
629
+ # Disables the CSS agent for the given page.
630
+ command disable
631
+
632
+ # Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been
633
+ # enabled until the result of this command is received.
634
+ command enable
635
+
636
+ # Ensures that the given node will have specified pseudo-classes whenever its style is computed by
637
+ # the browser.
638
+ command forcePseudoState
639
+ parameters
640
+ # The element id for which to force the pseudo state.
641
+ DOM.NodeId nodeId
642
+ # Element pseudo classes to force when computing the element's style.
643
+ array of string forcedPseudoClasses
644
+
645
+ # Ensures that the given node is in its starting-style state.
646
+ command forceStartingStyle
647
+ parameters
648
+ # The element id for which to force the starting-style state.
649
+ DOM.NodeId nodeId
650
+ # Boolean indicating if this is on or off.
651
+ boolean forced
652
+
653
+ command getBackgroundColors
654
+ parameters
655
+ # Id of the node to get background colors for.
656
+ DOM.NodeId nodeId
657
+ returns
658
+ # The range of background colors behind this element, if it contains any visible text. If no
659
+ # visible text is present, this will be undefined. In the case of a flat background color,
660
+ # this will consist of simply that color. In the case of a gradient, this will consist of each
661
+ # of the color stops. For anything more complicated, this will be an empty array. Images will
662
+ # be ignored (as if the image had failed to load).
663
+ optional array of string backgroundColors
664
+ # The computed font size for this node, as a CSS computed value string (e.g. '12px').
665
+ optional string computedFontSize
666
+ # The computed font weight for this node, as a CSS computed value string (e.g. 'normal' or
667
+ # '100').
668
+ optional string computedFontWeight
669
+
670
+ # Returns the computed style for a DOM node identified by `nodeId`.
671
+ command getComputedStyleForNode
672
+ parameters
673
+ DOM.NodeId nodeId
674
+ returns
675
+ # Computed style for the specified DOM node.
676
+ array of CSSComputedStyleProperty computedStyle
677
+
678
+ # Resolve the specified values in the context of the provided element.
679
+ # For example, a value of '1em' is evaluated according to the computed
680
+ # 'font-size' of the element and a value 'calc(1px + 2px)' will be
681
+ # resolved to '3px'.
682
+ # If the `propertyName` was specified the `values` are resolved as if
683
+ # they were property's declaration. If a value cannot be parsed according
684
+ # to the provided property syntax, the value is parsed using combined
685
+ # syntax as if null `propertyName` was provided. If the value cannot be
686
+ # resolved even then, return the provided value without any changes.
687
+ experimental command resolveValues
688
+ parameters
689
+ # Cascade-dependent keywords (revert/revert-layer) do not work.
690
+ array of string values
691
+ # Id of the node in whose context the expression is evaluated
692
+ DOM.NodeId nodeId
693
+ # Only longhands and custom property names are accepted.
694
+ optional string propertyName
695
+ # Pseudo element type, only works for pseudo elements that generate
696
+ # elements in the tree, such as ::before and ::after.
697
+ optional DOM.PseudoType pseudoType
698
+ # Pseudo element custom ident.
699
+ optional string pseudoIdentifier
700
+ returns
701
+ array of string results
702
+
703
+ experimental command getLonghandProperties
704
+ parameters
705
+ string shorthandName
706
+ string value
707
+ returns
708
+ array of CSSProperty longhandProperties
709
+
710
+ # Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
711
+ # attributes) for a DOM node identified by `nodeId`.
712
+ command getInlineStylesForNode
713
+ parameters
714
+ DOM.NodeId nodeId
715
+ returns
716
+ # Inline style for the specified DOM node.
717
+ optional CSSStyle inlineStyle
718
+ # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
719
+ optional CSSStyle attributesStyle
720
+
721
+ # Returns the styles coming from animations & transitions
722
+ # including the animation & transition styles coming from inheritance chain.
723
+ experimental command getAnimatedStylesForNode
724
+ parameters
725
+ DOM.NodeId nodeId
726
+ returns
727
+ # Styles coming from animations.
728
+ optional array of CSSAnimationStyle animationStyles
729
+ # Style coming from transitions.
730
+ optional CSSStyle transitionsStyle
731
+ # Inherited style entries for animationsStyle and transitionsStyle from
732
+ # the inheritance chain of the element.
733
+ optional array of InheritedAnimatedStyleEntry inherited
734
+
735
+ # Returns requested styles for a DOM node identified by `nodeId`.
736
+ command getMatchedStylesForNode
737
+ parameters
738
+ DOM.NodeId nodeId
739
+ returns
740
+ # Inline style for the specified DOM node.
741
+ optional CSSStyle inlineStyle
742
+ # Attribute-defined element style (e.g. resulting from "width=20 height=100%").
743
+ optional CSSStyle attributesStyle
744
+ # CSS rules matching this node, from all applicable stylesheets.
745
+ optional array of RuleMatch matchedCSSRules
746
+ # Pseudo style matches for this node.
747
+ optional array of PseudoElementMatches pseudoElements
748
+ # A chain of inherited styles (from the immediate node parent up to the DOM tree root).
749
+ optional array of InheritedStyleEntry inherited
750
+ # A chain of inherited pseudo element styles (from the immediate node parent up to the DOM tree root).
751
+ optional array of InheritedPseudoElementMatches inheritedPseudoElements
752
+ # A list of CSS keyframed animations matching this node.
753
+ optional array of CSSKeyframesRule cssKeyframesRules
754
+ # A list of CSS @position-try rules matching this node, based on the position-try-fallbacks property.
755
+ optional array of CSSPositionTryRule cssPositionTryRules
756
+ # Index of the active fallback in the applied position-try-fallback property,
757
+ # will not be set if there is no active position-try fallback.
758
+ optional integer activePositionFallbackIndex
759
+ # A list of CSS at-property rules matching this node.
760
+ optional array of CSSPropertyRule cssPropertyRules
761
+ # A list of CSS property registrations matching this node.
762
+ optional array of CSSPropertyRegistration cssPropertyRegistrations
763
+ # A font-palette-values rule matching this node.
764
+ optional CSSFontPaletteValuesRule cssFontPaletteValuesRule
765
+ # Id of the first parent element that does not have display: contents.
766
+ experimental optional DOM.NodeId parentLayoutNodeId
767
+ # A list of CSS at-function rules referenced by styles of this node.
768
+ experimental optional array of CSSFunctionRule cssFunctionRules
769
+
770
+ # Returns the values of the default UA-defined environment variables used in env()
771
+ experimental command getEnvironmentVariables
772
+ returns
773
+ object environmentVariables
774
+
775
+ # Returns all media queries parsed by the rendering engine.
776
+ command getMediaQueries
777
+ returns
778
+ array of CSSMedia medias
779
+
780
+ # Requests information about platform fonts which we used to render child TextNodes in the given
781
+ # node.
782
+ command getPlatformFontsForNode
783
+ parameters
784
+ DOM.NodeId nodeId
785
+ returns
786
+ # Usage statistics for every employed platform font.
787
+ array of PlatformFontUsage fonts
788
+
789
+ # Returns the current textual content for a stylesheet.
790
+ command getStyleSheetText
791
+ parameters
792
+ StyleSheetId styleSheetId
793
+ returns
794
+ # The stylesheet text.
795
+ string text
796
+
797
+ # Returns all layers parsed by the rendering engine for the tree scope of a node.
798
+ # Given a DOM element identified by nodeId, getLayersForNode returns the root
799
+ # layer for the nearest ancestor document or shadow root. The layer root contains
800
+ # the full layer tree for the tree scope and their ordering.
801
+ experimental command getLayersForNode
802
+ parameters
803
+ DOM.NodeId nodeId
804
+ returns
805
+ CSSLayerData rootLayer
806
+
807
+ # Given a CSS selector text and a style sheet ID, getLocationForSelector
808
+ # returns an array of locations of the CSS selector in the style sheet.
809
+ experimental command getLocationForSelector
810
+ parameters
811
+ StyleSheetId styleSheetId
812
+ string selectorText
813
+ returns
814
+ array of SourceRange ranges
815
+
816
+ # Starts tracking the given node for the computed style updates
817
+ # and whenever the computed style is updated for node, it queues
818
+ # a `computedStyleUpdated` event with throttling.
819
+ # There can only be 1 node tracked for computed style updates
820
+ # so passing a new node id removes tracking from the previous node.
821
+ # Pass `undefined` to disable tracking.
822
+ experimental command trackComputedStyleUpdatesForNode
823
+ parameters
824
+ optional DOM.NodeId nodeId
825
+
826
+ # Starts tracking the given computed styles for updates. The specified array of properties
827
+ # replaces the one previously specified. Pass empty array to disable tracking.
828
+ # Use takeComputedStyleUpdates to retrieve the list of nodes that had properties modified.
829
+ # The changes to computed style properties are only tracked for nodes pushed to the front-end
830
+ # by the DOM agent. If no changes to the tracked properties occur after the node has been pushed
831
+ # to the front-end, no updates will be issued for the node.
832
+ experimental command trackComputedStyleUpdates
833
+ parameters
834
+ array of CSSComputedStyleProperty propertiesToTrack
835
+
836
+ # Polls the next batch of computed style updates.
837
+ experimental command takeComputedStyleUpdates
838
+ returns
839
+ # The list of node Ids that have their tracked computed styles updated.
840
+ array of DOM.NodeId nodeIds
841
+
842
+ # Find a rule with the given active property for the given node and set the new value for this
843
+ # property
844
+ command setEffectivePropertyValueForNode
845
+ parameters
846
+ # The element id for which to set property.
847
+ DOM.NodeId nodeId
848
+ string propertyName
849
+ string value
850
+
851
+ # Modifies the property rule property name.
852
+ command setPropertyRulePropertyName
853
+ parameters
854
+ StyleSheetId styleSheetId
855
+ SourceRange range
856
+ string propertyName
857
+ returns
858
+ # The resulting key text after modification.
859
+ Value propertyName
860
+
861
+ # Modifies the keyframe rule key text.
862
+ command setKeyframeKey
863
+ parameters
864
+ StyleSheetId styleSheetId
865
+ SourceRange range
866
+ string keyText
867
+ returns
868
+ # The resulting key text after modification.
869
+ Value keyText
870
+
871
+ # Modifies the rule selector.
872
+ command setMediaText
873
+ parameters
874
+ StyleSheetId styleSheetId
875
+ SourceRange range
876
+ string text
877
+ returns
878
+ # The resulting CSS media rule after modification.
879
+ CSSMedia media
880
+
881
+ # Modifies the expression of a container query.
882
+ experimental command setContainerQueryText
883
+ parameters
884
+ StyleSheetId styleSheetId
885
+ SourceRange range
886
+ string text
887
+ returns
888
+ # The resulting CSS container query rule after modification.
889
+ CSSContainerQuery containerQuery
890
+
891
+ # Modifies the expression of a supports at-rule.
892
+ experimental command setSupportsText
893
+ parameters
894
+ StyleSheetId styleSheetId
895
+ SourceRange range
896
+ string text
897
+ returns
898
+ # The resulting CSS Supports rule after modification.
899
+ CSSSupports supports
900
+
901
+ # Modifies the expression of a scope at-rule.
902
+ experimental command setScopeText
903
+ parameters
904
+ StyleSheetId styleSheetId
905
+ SourceRange range
906
+ string text
907
+ returns
908
+ # The resulting CSS Scope rule after modification.
909
+ CSSScope scope
910
+
911
+ # Modifies the rule selector.
912
+ command setRuleSelector
913
+ parameters
914
+ StyleSheetId styleSheetId
915
+ SourceRange range
916
+ string selector
917
+ returns
918
+ # The resulting selector list after modification.
919
+ SelectorList selectorList
920
+
921
+ # Sets the new stylesheet text.
922
+ command setStyleSheetText
923
+ parameters
924
+ StyleSheetId styleSheetId
925
+ string text
926
+ returns
927
+ # URL of source map associated with script (if any).
928
+ optional string sourceMapURL
929
+
930
+ # Applies specified style edits one after another in the given order.
931
+ command setStyleTexts
932
+ parameters
933
+ array of StyleDeclarationEdit edits
934
+ # NodeId for the DOM node in whose context custom property declarations for registered properties should be
935
+ # validated. If omitted, declarations in the new rule text can only be validated statically, which may produce
936
+ # incorrect results if the declaration contains a var() for example.
937
+ experimental optional DOM.NodeId nodeForPropertySyntaxValidation
938
+ returns
939
+ # The resulting styles after modification.
940
+ array of CSSStyle styles
941
+
942
+ # Enables the selector recording.
943
+ command startRuleUsageTracking
944
+
945
+ # Stop tracking rule usage and return the list of rules that were used since last call to
946
+ # `takeCoverageDelta` (or since start of coverage instrumentation).
947
+ command stopRuleUsageTracking
948
+ returns
949
+ array of RuleUsage ruleUsage
950
+
951
+ # Obtain list of rules that became used since last call to this method (or since start of coverage
952
+ # instrumentation).
953
+ command takeCoverageDelta
954
+ returns
955
+ array of RuleUsage coverage
956
+ # Monotonically increasing time, in seconds.
957
+ number timestamp
958
+
959
+ # Enables/disables rendering of local CSS fonts (enabled by default).
960
+ experimental command setLocalFontsEnabled
961
+ parameters
962
+ # Whether rendering of local fonts is enabled.
963
+ boolean enabled
964
+
965
+ # Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded
966
+ # web font.
967
+ event fontsUpdated
968
+ parameters
969
+ # The web font that has loaded.
970
+ optional FontFace font
971
+
972
+ # Fires whenever a MediaQuery result changes (for example, after a browser window has been
973
+ # resized.) The current implementation considers only viewport-dependent media features.
974
+ event mediaQueryResultChanged
975
+
976
+ # Fired whenever an active document stylesheet is added.
977
+ event styleSheetAdded
978
+ parameters
979
+ # Added stylesheet metainfo.
980
+ CSSStyleSheetHeader header
981
+
982
+ # Fired whenever a stylesheet is changed as a result of the client operation.
983
+ event styleSheetChanged
984
+ parameters
985
+ StyleSheetId styleSheetId
986
+
987
+ # Fired whenever an active document stylesheet is removed.
988
+ event styleSheetRemoved
989
+ parameters
990
+ # Identifier of the removed stylesheet.
991
+ StyleSheetId styleSheetId
992
+
993
+ experimental event computedStyleUpdated
994
+ parameters
995
+ # The node id that has updated computed styles.
996
+ DOM.NodeId nodeId