devtools-protocol 0.0.1682007 → 0.0.1684464

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.
@@ -688,6 +688,23 @@
688
688
  }
689
689
  }
690
690
  ]
691
+ },
692
+ {
693
+ "id": "AdScript",
694
+ "description": "An ad script.\nNote: when the script is a transitive ad script, we only fill in the\nimmediate ancestor script in the provenance's adScriptAncestry field (as its\nfirst entry), rather than filling in the full ancestry. This saves work for\nthe backend, and the frontend can reconstruct the full ancestry if\nnecessary.",
695
+ "type": "object",
696
+ "properties": [
697
+ {
698
+ "name": "scriptId",
699
+ "description": "The script ID.",
700
+ "$ref": "Runtime.ScriptId"
701
+ },
702
+ {
703
+ "name": "provenance",
704
+ "description": "The ad provenance.",
705
+ "$ref": "Network.AdProvenance"
706
+ }
707
+ ]
691
708
  }
692
709
  ],
693
710
  "commands": [
@@ -700,6 +717,19 @@
700
717
  "$ref": "AdMetrics"
701
718
  }
702
719
  ]
720
+ },
721
+ {
722
+ "name": "getAdScripts",
723
+ "description": "Retrieves ad scripts for the current page. To minimize payload size, this\nonly returns the newly tracked ad scripts since the last call to\ngetAdScripts (i.e., the delta).",
724
+ "returns": [
725
+ {
726
+ "name": "newScripts",
727
+ "type": "array",
728
+ "items": {
729
+ "$ref": "AdScript"
730
+ }
731
+ }
732
+ ]
703
733
  }
704
734
  ]
705
735
  },
@@ -17632,7 +17662,7 @@
17632
17662
  },
17633
17663
  {
17634
17664
  "name": "adScriptAncestry",
17635
- "description": "The script ancestry that created the ad, if any.",
17665
+ "description": "The script ancestry that created the ad, if any.\nNote: depending on the context, this may represent the full ancestry up\nto the root script, or it may contain only one script representing the\nimmediate ancestor.",
17636
17666
  "optional": true,
17637
17667
  "$ref": "AdAncestry"
17638
17668
  }
@@ -24424,9 +24454,21 @@
24424
24454
  },
24425
24455
  {
24426
24456
  "name": "everyNthFrame",
24427
- "description": "Send every n-th frame.",
24457
+ "description": "Send every n-th frame. Must be a positive integer.",
24458
+ "optional": true,
24459
+ "type": "integer"
24460
+ },
24461
+ {
24462
+ "name": "maxFramesInFlight",
24463
+ "description": "Maximum number of frames sent until screencastFrameAck is required.\nDefaults to 3. Must be a positive integer.",
24428
24464
  "optional": true,
24429
24465
  "type": "integer"
24466
+ },
24467
+ {
24468
+ "name": "sendLastFrame",
24469
+ "description": "By default, after screencastFrameAck arrives, the next produced frame is sent.\nPassing this flag enables storing the last produced frame in memory, which is\nimmediately sent upon screencastFrameAck. This way, overall performance is\ntraded for a better latency.",
24470
+ "optional": true,
24471
+ "type": "boolean"
24430
24472
  }
24431
24473
  ]
24432
24474
  },
@@ -26402,6 +26444,98 @@
26402
26444
  "redundant"
26403
26445
  ]
26404
26446
  },
26447
+ {
26448
+ "id": "ServiceWorkerRouterCondition",
26449
+ "description": "Mostly corresponds to `RouterCondition` in ServiceWorker spec\n(https://www.w3.org/TR/service-workers/#dictdef-routercondition) while this\ncurrently lacks support for the nested conditions (\"or\" and \"not\").\nTODO(crbug.com/540469610): Support recursive conditions.",
26450
+ "type": "object",
26451
+ "properties": [
26452
+ {
26453
+ "name": "urlPattern",
26454
+ "description": "Plain text, or JSON serialization of URLPatternInit or URLPattern",
26455
+ "optional": true,
26456
+ "type": "string"
26457
+ },
26458
+ {
26459
+ "name": "requestMethod",
26460
+ "optional": true,
26461
+ "type": "string"
26462
+ },
26463
+ {
26464
+ "name": "requestMode",
26465
+ "optional": true,
26466
+ "type": "string"
26467
+ },
26468
+ {
26469
+ "name": "requestDestination",
26470
+ "optional": true,
26471
+ "type": "string"
26472
+ },
26473
+ {
26474
+ "name": "runningStatus",
26475
+ "optional": true,
26476
+ "$ref": "ServiceWorkerVersionRunningStatus"
26477
+ }
26478
+ ]
26479
+ },
26480
+ {
26481
+ "id": "ServiceWorkerRouterSourceType",
26482
+ "type": "string",
26483
+ "enum": [
26484
+ "cache",
26485
+ "fetchEvent",
26486
+ "network",
26487
+ "raceNetworkAndFetchHandler",
26488
+ "raceNetworkAndCache",
26489
+ "sourceDict"
26490
+ ]
26491
+ },
26492
+ {
26493
+ "id": "ServiceWorkerRouterSourceDict",
26494
+ "description": "https://www.w3.org/TR/service-workers/#dictdef-routersourcedict",
26495
+ "type": "object",
26496
+ "properties": [
26497
+ {
26498
+ "name": "cacheName",
26499
+ "type": "string"
26500
+ }
26501
+ ]
26502
+ },
26503
+ {
26504
+ "id": "ServiceWorkerRouterSource",
26505
+ "description": "Corresponds to `RouterSource` in the spec while the representation is different as follows.\n(https://www.w3.org/TR/service-workers/#typedefdef-routersource)\n- `RouterSourceEnum`: `type` equals `cache`, `sourceDict` is null.\n- `RouterSourceDict`: `type` equals `sourceDict`, `sourceDict` has valid value.",
26506
+ "type": "object",
26507
+ "properties": [
26508
+ {
26509
+ "name": "type",
26510
+ "$ref": "ServiceWorkerRouterSourceType"
26511
+ },
26512
+ {
26513
+ "name": "sourceDict",
26514
+ "description": "Non-empty iff `type` equals \"sourceDict\".",
26515
+ "optional": true,
26516
+ "$ref": "ServiceWorkerRouterSourceDict"
26517
+ }
26518
+ ]
26519
+ },
26520
+ {
26521
+ "id": "ServiceWorkerRouterRule",
26522
+ "type": "object",
26523
+ "properties": [
26524
+ {
26525
+ "name": "condition",
26526
+ "$ref": "ServiceWorkerRouterCondition"
26527
+ },
26528
+ {
26529
+ "name": "source",
26530
+ "$ref": "ServiceWorkerRouterSource"
26531
+ },
26532
+ {
26533
+ "name": "id",
26534
+ "description": "Rule ID assigned by the browser. Unique within each ServiceWorkerVersion.",
26535
+ "type": "integer"
26536
+ }
26537
+ ]
26538
+ },
26405
26539
  {
26406
26540
  "id": "ServiceWorkerVersion",
26407
26541
  "description": "ServiceWorker version.",
@@ -26454,8 +26588,17 @@
26454
26588
  },
26455
26589
  {
26456
26590
  "name": "routerRules",
26591
+ "description": "Migration to `typedRouterRules` is in progress. The browser sends either\n`routerRules` or `typedRouterRules`.\nTODO(crbug.com/540469610): Remove `routerRules` after the migration.",
26457
26592
  "optional": true,
26458
26593
  "type": "string"
26594
+ },
26595
+ {
26596
+ "name": "typedRouterRules",
26597
+ "optional": true,
26598
+ "type": "array",
26599
+ "items": {
26600
+ "$ref": "ServiceWorkerRouterRule"
26601
+ }
26459
26602
  }
26460
26603
  ]
26461
26604
  },
@@ -27307,7 +27450,6 @@
27307
27450
  "websql",
27308
27451
  "service_workers",
27309
27452
  "cache_storage",
27310
- "shared_storage",
27311
27453
  "storage_buckets",
27312
27454
  "all",
27313
27455
  "other"
@@ -27346,257 +27488,6 @@
27346
27488
  }
27347
27489
  ]
27348
27490
  },
27349
- {
27350
- "id": "SharedStorageAccessScope",
27351
- "description": "Enum of shared storage access scopes.",
27352
- "type": "string",
27353
- "enum": [
27354
- "window",
27355
- "sharedStorageWorklet",
27356
- "header"
27357
- ]
27358
- },
27359
- {
27360
- "id": "SharedStorageAccessMethod",
27361
- "description": "Enum of shared storage access methods.",
27362
- "type": "string",
27363
- "enum": [
27364
- "addModule",
27365
- "createWorklet",
27366
- "selectURL",
27367
- "run",
27368
- "batchUpdate",
27369
- "set",
27370
- "append",
27371
- "delete",
27372
- "clear",
27373
- "get",
27374
- "keys",
27375
- "values",
27376
- "entries",
27377
- "length",
27378
- "remainingBudget"
27379
- ]
27380
- },
27381
- {
27382
- "id": "SharedStorageEntry",
27383
- "description": "Struct for a single key-value pair in an origin's shared storage.",
27384
- "type": "object",
27385
- "properties": [
27386
- {
27387
- "name": "key",
27388
- "type": "string"
27389
- },
27390
- {
27391
- "name": "value",
27392
- "type": "string"
27393
- }
27394
- ]
27395
- },
27396
- {
27397
- "id": "SharedStorageMetadata",
27398
- "description": "Details for an origin's shared storage.",
27399
- "type": "object",
27400
- "properties": [
27401
- {
27402
- "name": "creationTime",
27403
- "description": "Time when the origin's shared storage was last created.",
27404
- "$ref": "Network.TimeSinceEpoch"
27405
- },
27406
- {
27407
- "name": "length",
27408
- "description": "Number of key-value pairs stored in origin's shared storage.",
27409
- "type": "integer"
27410
- },
27411
- {
27412
- "name": "remainingBudget",
27413
- "description": "Current amount of bits of entropy remaining in the navigation budget.",
27414
- "type": "number"
27415
- },
27416
- {
27417
- "name": "bytesUsed",
27418
- "description": "Total number of bytes stored as key-value pairs in origin's shared\nstorage.",
27419
- "type": "integer"
27420
- }
27421
- ]
27422
- },
27423
- {
27424
- "id": "SharedStoragePrivateAggregationConfig",
27425
- "description": "Represents a dictionary object passed in as privateAggregationConfig to\nrun or selectURL.",
27426
- "type": "object",
27427
- "properties": [
27428
- {
27429
- "name": "aggregationCoordinatorOrigin",
27430
- "description": "The chosen aggregation service deployment.",
27431
- "optional": true,
27432
- "type": "string"
27433
- },
27434
- {
27435
- "name": "contextId",
27436
- "description": "The context ID provided.",
27437
- "optional": true,
27438
- "type": "string"
27439
- },
27440
- {
27441
- "name": "filteringIdMaxBytes",
27442
- "description": "Configures the maximum size allowed for filtering IDs.",
27443
- "type": "integer"
27444
- },
27445
- {
27446
- "name": "maxContributions",
27447
- "description": "The limit on the number of contributions in the final report.",
27448
- "optional": true,
27449
- "type": "integer"
27450
- }
27451
- ]
27452
- },
27453
- {
27454
- "id": "SharedStorageReportingMetadata",
27455
- "description": "Pair of reporting metadata details for a candidate URL for `selectURL()`.",
27456
- "type": "object",
27457
- "properties": [
27458
- {
27459
- "name": "eventType",
27460
- "type": "string"
27461
- },
27462
- {
27463
- "name": "reportingUrl",
27464
- "type": "string"
27465
- }
27466
- ]
27467
- },
27468
- {
27469
- "id": "SharedStorageUrlWithMetadata",
27470
- "description": "Bundles a candidate URL with its reporting metadata.",
27471
- "type": "object",
27472
- "properties": [
27473
- {
27474
- "name": "url",
27475
- "description": "Spec of candidate URL.",
27476
- "type": "string"
27477
- },
27478
- {
27479
- "name": "reportingMetadata",
27480
- "description": "Any associated reporting metadata.",
27481
- "type": "array",
27482
- "items": {
27483
- "$ref": "SharedStorageReportingMetadata"
27484
- }
27485
- }
27486
- ]
27487
- },
27488
- {
27489
- "id": "SharedStorageAccessParams",
27490
- "description": "Bundles the parameters for shared storage access events whose\npresence/absence can vary according to SharedStorageAccessType.",
27491
- "type": "object",
27492
- "properties": [
27493
- {
27494
- "name": "scriptSourceUrl",
27495
- "description": "Spec of the module script URL.\nPresent only for SharedStorageAccessMethods: addModule and\ncreateWorklet.",
27496
- "optional": true,
27497
- "type": "string"
27498
- },
27499
- {
27500
- "name": "dataOrigin",
27501
- "description": "String denoting \"context-origin\", \"script-origin\", or a custom\norigin to be used as the worklet's data origin.\nPresent only for SharedStorageAccessMethod: createWorklet.",
27502
- "optional": true,
27503
- "type": "string"
27504
- },
27505
- {
27506
- "name": "operationName",
27507
- "description": "Name of the registered operation to be run.\nPresent only for SharedStorageAccessMethods: run and selectURL.",
27508
- "optional": true,
27509
- "type": "string"
27510
- },
27511
- {
27512
- "name": "operationId",
27513
- "description": "ID of the operation call.\nPresent only for SharedStorageAccessMethods: run and selectURL.",
27514
- "optional": true,
27515
- "type": "string"
27516
- },
27517
- {
27518
- "name": "keepAlive",
27519
- "description": "Whether or not to keep the worket alive for future run or selectURL\ncalls.\nPresent only for SharedStorageAccessMethods: run and selectURL.",
27520
- "optional": true,
27521
- "type": "boolean"
27522
- },
27523
- {
27524
- "name": "privateAggregationConfig",
27525
- "description": "Configures the private aggregation options.\nPresent only for SharedStorageAccessMethods: run and selectURL.",
27526
- "optional": true,
27527
- "$ref": "SharedStoragePrivateAggregationConfig"
27528
- },
27529
- {
27530
- "name": "serializedData",
27531
- "description": "The operation's serialized data in bytes (converted to a string).\nPresent only for SharedStorageAccessMethods: run and selectURL.\nTODO(crbug.com/401011862): Consider updating this parameter to binary.",
27532
- "optional": true,
27533
- "type": "string"
27534
- },
27535
- {
27536
- "name": "urlsWithMetadata",
27537
- "description": "Array of candidate URLs' specs, along with any associated metadata.\nPresent only for SharedStorageAccessMethod: selectURL.",
27538
- "optional": true,
27539
- "type": "array",
27540
- "items": {
27541
- "$ref": "SharedStorageUrlWithMetadata"
27542
- }
27543
- },
27544
- {
27545
- "name": "urnUuid",
27546
- "description": "Spec of the URN:UUID generated for a selectURL call.\nPresent only for SharedStorageAccessMethod: selectURL.",
27547
- "optional": true,
27548
- "type": "string"
27549
- },
27550
- {
27551
- "name": "key",
27552
- "description": "Key for a specific entry in an origin's shared storage.\nPresent only for SharedStorageAccessMethods: set, append, delete, and\nget.",
27553
- "optional": true,
27554
- "type": "string"
27555
- },
27556
- {
27557
- "name": "value",
27558
- "description": "Value for a specific entry in an origin's shared storage.\nPresent only for SharedStorageAccessMethods: set and append.",
27559
- "optional": true,
27560
- "type": "string"
27561
- },
27562
- {
27563
- "name": "ignoreIfPresent",
27564
- "description": "Whether or not to set an entry for a key if that key is already present.\nPresent only for SharedStorageAccessMethod: set.",
27565
- "optional": true,
27566
- "type": "boolean"
27567
- },
27568
- {
27569
- "name": "workletOrdinal",
27570
- "description": "A number denoting the (0-based) order of the worklet's\ncreation relative to all other shared storage worklets created by\ndocuments using the current storage partition.\nPresent only for SharedStorageAccessMethods: addModule, createWorklet.",
27571
- "optional": true,
27572
- "type": "integer"
27573
- },
27574
- {
27575
- "name": "workletTargetId",
27576
- "description": "Hex representation of the DevTools token used as the TargetID for the\nassociated shared storage worklet.\nPresent only for SharedStorageAccessMethods: addModule, createWorklet,\nrun, selectURL, and any other SharedStorageAccessMethod when the\nSharedStorageAccessScope is sharedStorageWorklet.",
27577
- "optional": true,
27578
- "$ref": "Target.TargetID"
27579
- },
27580
- {
27581
- "name": "withLock",
27582
- "description": "Name of the lock to be acquired, if present.\nOptionally present only for SharedStorageAccessMethods: batchUpdate,\nset, append, delete, and clear.",
27583
- "optional": true,
27584
- "type": "string"
27585
- },
27586
- {
27587
- "name": "batchUpdateId",
27588
- "description": "If the method has been called as part of a batchUpdate, then this\nnumber identifies the batch to which it belongs.\nOptionally present only for SharedStorageAccessMethods:\nbatchUpdate (required), set, append, delete, and clear.",
27589
- "optional": true,
27590
- "type": "string"
27591
- },
27592
- {
27593
- "name": "batchSize",
27594
- "description": "Number of modifier methods sent in batch.\nPresent only for SharedStorageAccessMethod: batchUpdate.",
27595
- "optional": true,
27596
- "type": "integer"
27597
- }
27598
- ]
27599
- },
27600
27491
  {
27601
27492
  "id": "StorageBucketsDurability",
27602
27493
  "type": "string",
@@ -27981,116 +27872,6 @@
27981
27872
  }
27982
27873
  ]
27983
27874
  },
27984
- {
27985
- "name": "getSharedStorageMetadata",
27986
- "description": "Gets metadata for an origin's shared storage.",
27987
- "experimental": true,
27988
- "parameters": [
27989
- {
27990
- "name": "ownerOrigin",
27991
- "type": "string"
27992
- }
27993
- ],
27994
- "returns": [
27995
- {
27996
- "name": "metadata",
27997
- "$ref": "SharedStorageMetadata"
27998
- }
27999
- ]
28000
- },
28001
- {
28002
- "name": "getSharedStorageEntries",
28003
- "description": "Gets the entries in an given origin's shared storage.",
28004
- "experimental": true,
28005
- "parameters": [
28006
- {
28007
- "name": "ownerOrigin",
28008
- "type": "string"
28009
- }
28010
- ],
28011
- "returns": [
28012
- {
28013
- "name": "entries",
28014
- "type": "array",
28015
- "items": {
28016
- "$ref": "SharedStorageEntry"
28017
- }
28018
- }
28019
- ]
28020
- },
28021
- {
28022
- "name": "setSharedStorageEntry",
28023
- "description": "Sets entry with `key` and `value` for a given origin's shared storage.",
28024
- "experimental": true,
28025
- "parameters": [
28026
- {
28027
- "name": "ownerOrigin",
28028
- "type": "string"
28029
- },
28030
- {
28031
- "name": "key",
28032
- "type": "string"
28033
- },
28034
- {
28035
- "name": "value",
28036
- "type": "string"
28037
- },
28038
- {
28039
- "name": "ignoreIfPresent",
28040
- "description": "If `ignoreIfPresent` is included and true, then only sets the entry if\n`key` doesn't already exist.",
28041
- "optional": true,
28042
- "type": "boolean"
28043
- }
28044
- ]
28045
- },
28046
- {
28047
- "name": "deleteSharedStorageEntry",
28048
- "description": "Deletes entry for `key` (if it exists) for a given origin's shared storage.",
28049
- "experimental": true,
28050
- "parameters": [
28051
- {
28052
- "name": "ownerOrigin",
28053
- "type": "string"
28054
- },
28055
- {
28056
- "name": "key",
28057
- "type": "string"
28058
- }
28059
- ]
28060
- },
28061
- {
28062
- "name": "clearSharedStorageEntries",
28063
- "description": "Clears all entries for a given origin's shared storage.",
28064
- "experimental": true,
28065
- "parameters": [
28066
- {
28067
- "name": "ownerOrigin",
28068
- "type": "string"
28069
- }
28070
- ]
28071
- },
28072
- {
28073
- "name": "resetSharedStorageBudget",
28074
- "description": "Resets the budget for `ownerOrigin` by clearing all budget withdrawals.",
28075
- "experimental": true,
28076
- "parameters": [
28077
- {
28078
- "name": "ownerOrigin",
28079
- "type": "string"
28080
- }
28081
- ]
28082
- },
28083
- {
28084
- "name": "setSharedStorageTracking",
28085
- "description": "Enables/disables issuing of sharedStorageAccessed events.",
28086
- "experimental": true,
28087
- "parameters": [
28088
- {
28089
- "name": "enable",
28090
- "type": "boolean"
28091
- }
28092
- ]
28093
- },
28094
27875
  {
28095
27876
  "name": "setStorageBucketTracking",
28096
27877
  "description": "Set tracking for a storage key's buckets.",
@@ -28246,88 +28027,6 @@
28246
28027
  }
28247
28028
  ]
28248
28029
  },
28249
- {
28250
- "name": "sharedStorageAccessed",
28251
- "description": "Shared storage was accessed by the associated page.\nThe following parameters are included in all events.",
28252
- "parameters": [
28253
- {
28254
- "name": "accessTime",
28255
- "description": "Time of the access.",
28256
- "$ref": "Network.TimeSinceEpoch"
28257
- },
28258
- {
28259
- "name": "scope",
28260
- "description": "Enum value indicating the access scope.",
28261
- "$ref": "SharedStorageAccessScope"
28262
- },
28263
- {
28264
- "name": "method",
28265
- "description": "Enum value indicating the Shared Storage API method invoked.",
28266
- "$ref": "SharedStorageAccessMethod"
28267
- },
28268
- {
28269
- "name": "mainFrameId",
28270
- "description": "DevTools Frame Token for the primary frame tree's root.",
28271
- "$ref": "Page.FrameId"
28272
- },
28273
- {
28274
- "name": "ownerOrigin",
28275
- "description": "Serialization of the origin owning the Shared Storage data.",
28276
- "type": "string"
28277
- },
28278
- {
28279
- "name": "ownerSite",
28280
- "description": "Serialization of the site owning the Shared Storage data.",
28281
- "type": "string"
28282
- },
28283
- {
28284
- "name": "params",
28285
- "description": "The sub-parameters wrapped by `params` are all optional and their\npresence/absence depends on `type`.",
28286
- "$ref": "SharedStorageAccessParams"
28287
- }
28288
- ]
28289
- },
28290
- {
28291
- "name": "sharedStorageWorkletOperationExecutionFinished",
28292
- "description": "A shared storage run or selectURL operation finished its execution.\nThe following parameters are included in all events.",
28293
- "parameters": [
28294
- {
28295
- "name": "finishedTime",
28296
- "description": "Time that the operation finished.",
28297
- "$ref": "Network.TimeSinceEpoch"
28298
- },
28299
- {
28300
- "name": "executionTime",
28301
- "description": "Time, in microseconds, from start of shared storage JS API call until\nend of operation execution in the worklet.",
28302
- "type": "integer"
28303
- },
28304
- {
28305
- "name": "method",
28306
- "description": "Enum value indicating the Shared Storage API method invoked.",
28307
- "$ref": "SharedStorageAccessMethod"
28308
- },
28309
- {
28310
- "name": "operationId",
28311
- "description": "ID of the operation call.",
28312
- "type": "string"
28313
- },
28314
- {
28315
- "name": "workletTargetId",
28316
- "description": "Hex representation of the DevTools token used as the TargetID for the\nassociated shared storage worklet.",
28317
- "$ref": "Target.TargetID"
28318
- },
28319
- {
28320
- "name": "mainFrameId",
28321
- "description": "DevTools Frame Token for the primary frame tree's root.",
28322
- "$ref": "Page.FrameId"
28323
- },
28324
- {
28325
- "name": "ownerOrigin",
28326
- "description": "Serialization of the origin owning the Shared Storage data.",
28327
- "type": "string"
28328
- }
28329
- ]
28330
- },
28331
28030
  {
28332
28031
  "name": "storageBucketCreatedOrUpdated",
28333
28032
  "parameters": [
@@ -30771,6 +30470,12 @@
30771
30470
  "optional": true,
30772
30471
  "type": "boolean"
30773
30472
  },
30473
+ {
30474
+ "name": "consequential",
30475
+ "description": "A hint indicating that executing the tool will result in consequential actions, ex: booking a flight, transferring money.",
30476
+ "optional": true,
30477
+ "type": "boolean"
30478
+ },
30774
30479
  {
30775
30480
  "name": "autosubmit",
30776
30481
  "description": "If the declarative tool was declared with the autosubmit attribute.",