Skip to content

Commit

Permalink
Roll protocol to r1253004
Browse files Browse the repository at this point in the history
  • Loading branch information
@devtools-bot
devtools-bot committed Jan 27, 2024
1 parent b402173 commit fcda9c0
Show file tree
Hide file tree
Showing 4 changed files with 199 additions and 41 deletions.
166 changes: 151 additions & 15 deletions changelog.md
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,157 @@


## Roll protocol to r1253004 — _2024-01-27T04:25:19.000Z_
###### Diff: [`b402173...4d0afd5`](https://github.com/ChromeDevTools/devtools-protocol/compare/`b402173...4d0afd5`)

```diff
@@ browser_protocol.pdl:10649 @@ experimental domain Tethering
# Connection id to be used.
string connectionId

-domain Tracing
+experimental domain Tracing
depends on IO

# Configuration for memory dump. Used only when "memory-infra" category is enabled.
- experimental type MemoryDumpConfig extends object
+ type MemoryDumpConfig extends object

type TraceConfig extends object
properties
# Controls how the trace buffer stores data.
- experimental optional enum recordMode
+ 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
+ optional number traceBufferSizeInKb
# Turns on JavaScript stack sampling.
- experimental optional boolean enableSampling
+ optional boolean enableSampling
# Turns on system tracing.
- experimental optional boolean enableSystrace
+ optional boolean enableSystrace
# Turns on argument filter.
- experimental optional boolean enableArgumentFilter
+ 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
+ optional array of string syntheticDelays
# Configuration for memory dump triggers. Used only when "memory-infra" category is enabled.
- experimental optional MemoryDumpConfig memoryDumpConfig
+ 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
+ type StreamFormat extends string
enum
json
proto

# Compression type to use for traces returned via streams.
- experimental type StreamCompression extends string
+ type StreamCompression extends string
enum
none
gzip
@@ -10697,7 +10697,7 @@ domain Tracing
# Details exposed when memory request explicitly declared.
# Keep consistent with memory_dump_request_args.h and
# memory_instrumentation.mojom
- experimental type MemoryDumpLevelOfDetail extends string
+ type MemoryDumpLevelOfDetail extends string
enum
background
light
@@ -10708,7 +10708,7 @@ domain Tracing
# supported on Chrome OS and uses the Perfetto system tracing service.
# `auto` chooses `system` when the perfettoConfig provided to Tracing.start
# specifies at least one non-Chrome data source; otherwise uses `chrome`.
- experimental type TracingBackend extends string
+ type TracingBackend extends string
enum
auto
chrome
@@ -10718,19 +10718,19 @@ domain Tracing
command end

# Gets supported tracing categories.
- experimental command getCategories
+ command getCategories
returns
# A list of supported tracing categories.
array of string categories

# Record a clock sync marker in the trace.
- experimental command recordClockSyncMarker
+ command recordClockSyncMarker
parameters
# The ID of this clock sync marker
string syncId

# Request a global memory dump.
- experimental command requestMemoryDump
+ command requestMemoryDump
parameters
# Enables more deterministic results by forcing garbage collection
optional boolean deterministic
@@ -10746,11 +10746,11 @@ domain Tracing
command start
parameters
# Category/tag filter
- experimental deprecated optional string categories
+ deprecated optional string categories
# Tracing options
- experimental deprecated optional string options
+ deprecated optional string options
# If set, the agent will issue bufferUsage events at this interval, specified in milliseconds
- experimental optional number bufferUsageReportingInterval
+ optional number bufferUsageReportingInterval
# Whether to report trace events as series of dataCollected events or to save trace to a
# stream (defaults to `ReportEvents`).
optional enum transferMode
@@ -10761,16 +10761,16 @@ domain Tracing
optional StreamFormat streamFormat
# Compression format to use. This only applies when using `ReturnAsStream`
# transfer mode (defaults to `none`)
- experimental optional StreamCompression streamCompression
+ 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
+ optional binary perfettoConfig
# Backend type (defaults to `auto`)
- experimental optional TracingBackend tracingBackend
+ optional TracingBackend tracingBackend

- experimental event bufferUsage
+ event bufferUsage
parameters
# A number in range [0..1] that indicates the used size of event buffer as a fraction of its
# total size.
@@ -10783,7 +10783,7 @@ domain Tracing

# Contains a bucket of collected trace events. When tracing is stopped collected events will be
# sent as a sequence of dataCollected events followed by tracingComplete event.
- experimental event dataCollected
+ event dataCollected
parameters
array of object value
```

## Roll protocol to r1252439 — _2024-01-26T04:26:56.000Z_
###### Diff: [`45b7b51...f8f84dc`](https://github.com/ChromeDevTools/devtools-protocol/compare/`45b7b51...f8f84dc`)
###### Diff: [`45b7b51...b402173`](https://github.com/ChromeDevTools/devtools-protocol/compare/`45b7b51...b402173`)

```diff
@@ browser_protocol.pdl:9546 @@ experimental domain Storage
Expand Down Expand Up @@ -10849,18 +10999,4 @@ index bd277eb..09c420e 100644
# Whether BeginFrames for this target will be controlled via DevTools (headless chrome only,
# not supported on MacOS yet, false by default).
experimental optional boolean enableBeginFrameControl
```

## Roll protocol to r931360 — _2021-10-14T03:15:26.000Z_
###### Diff: [`8bbdba3...5095a49`](https://github.com/ChromeDevTools/devtools-protocol/compare/`8bbdba3...5095a49`)

```diff
@@ browser_protocol.pdl:6720 @@ domain Page
hid
idle-detection
interest-cohort
- keyboard-map
magnetometer
microphone
midi
```
24 changes: 23 additions & 1 deletion json/browser_protocol.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22722,14 +22722,14 @@
},
{
"domain": "Tracing",
"experimental": true,
"dependencies": [
"IO"
],
"types": [
{
"id": "MemoryDumpConfig",
"description": "Configuration for memory dump. Used only when \"memory-infra\" category is enabled.",
"experimental": true,
"type": "object"
},
{
Expand All @@ -22739,6 +22739,7 @@
{
"name": "recordMode",
"description": "Controls how the trace buffer stores data.",
"experimental": true,
"optional": true,
"type": "string",
"enum": [
Expand All @@ -22751,24 +22752,28 @@
{
"name": "traceBufferSizeInKb",
"description": "Size of the trace buffer in kilobytes. If not specified or zero is passed, a default value\nof 200 MB would be used.",
"experimental": true,
"optional": true,
"type": "number"
},
{
"name": "enableSampling",
"description": "Turns on JavaScript stack sampling.",
"experimental": true,
"optional": true,
"type": "boolean"
},
{
"name": "enableSystrace",
"description": "Turns on system tracing.",
"experimental": true,
"optional": true,
"type": "boolean"
},
{
"name": "enableArgumentFilter",
"description": "Turns on argument filter.",
"experimental": true,
"optional": true,
"type": "boolean"
},
Expand All @@ -22793,6 +22798,7 @@
{
"name": "syntheticDelays",
"description": "Configuration to synthesize the delays in tracing.",
"experimental": true,
"optional": true,
"type": "array",
"items": {
Expand All @@ -22802,6 +22808,7 @@
{
"name": "memoryDumpConfig",
"description": "Configuration for memory dump triggers. Used only when \"memory-infra\" category is enabled.",
"experimental": true,
"optional": true,
"$ref": "MemoryDumpConfig"
}
Expand All @@ -22810,6 +22817,7 @@
{
"id": "StreamFormat",
"description": "Data format of a trace. Can be either the legacy JSON format or the\nprotocol buffer format. Note that the JSON format will be deprecated soon.",
"experimental": true,
"type": "string",
"enum": [
"json",
Expand All @@ -22819,6 +22827,7 @@
{
"id": "StreamCompression",
"description": "Compression type to use for traces returned via streams.",
"experimental": true,
"type": "string",
"enum": [
"none",
Expand All @@ -22828,6 +22837,7 @@
{
"id": "MemoryDumpLevelOfDetail",
"description": "Details exposed when memory request explicitly declared.\nKeep consistent with memory_dump_request_args.h and\nmemory_instrumentation.mojom",
"experimental": true,
"type": "string",
"enum": [
"background",
Expand All @@ -22838,6 +22848,7 @@
{
"id": "TracingBackend",
"description": "Backend type to use for tracing. `chrome` uses the Chrome-integrated\ntracing service and is supported on all platforms. `system` is only\nsupported on Chrome OS and uses the Perfetto system tracing service.\n`auto` chooses `system` when the perfettoConfig provided to Tracing.start\nspecifies at least one non-Chrome data source; otherwise uses `chrome`.",
"experimental": true,
"type": "string",
"enum": [
"auto",
Expand All @@ -22854,6 +22865,7 @@
{
"name": "getCategories",
"description": "Gets supported tracing categories.",
"experimental": true,
"returns": [
{
"name": "categories",
Expand All @@ -22868,6 +22880,7 @@
{
"name": "recordClockSyncMarker",
"description": "Record a clock sync marker in the trace.",
"experimental": true,
"parameters": [
{
"name": "syncId",
Expand All @@ -22879,6 +22892,7 @@
{
"name": "requestMemoryDump",
"description": "Request a global memory dump.",
"experimental": true,
"parameters": [
{
"name": "deterministic",
Expand Down Expand Up @@ -22913,20 +22927,23 @@
{
"name": "categories",
"description": "Category/tag filter",
"experimental": true,
"deprecated": true,
"optional": true,
"type": "string"
},
{
"name": "options",
"description": "Tracing options",
"experimental": true,
"deprecated": true,
"optional": true,
"type": "string"
},
{
"name": "bufferUsageReportingInterval",
"description": "If set, the agent will issue bufferUsage events at this interval, specified in milliseconds",
"experimental": true,
"optional": true,
"type": "number"
},
Expand All @@ -22949,6 +22966,7 @@
{
"name": "streamCompression",
"description": "Compression format to use. This only applies when using `ReturnAsStream`\ntransfer mode (defaults to `none`)",
"experimental": true,
"optional": true,
"$ref": "StreamCompression"
},
Expand All @@ -22960,12 +22978,14 @@
{
"name": "perfettoConfig",
"description": "Base64-encoded serialized perfetto.protos.TraceConfig protobuf message\nWhen specified, the parameters `categories`, `options`, `traceConfig`\nare ignored. (Encoded as a base64 string when passed over JSON)",
"experimental": true,
"optional": true,
"type": "string"
},
{
"name": "tracingBackend",
"description": "Backend type (defaults to `auto`)",
"experimental": true,
"optional": true,
"$ref": "TracingBackend"
}
Expand All @@ -22975,6 +22995,7 @@
"events": [
{
"name": "bufferUsage",
"experimental": true,
"parameters": [
{
"name": "percentFull",
Expand All @@ -22999,6 +23020,7 @@
{
"name": "dataCollected",
"description": "Contains a bucket of collected trace events. When tracing is stopped collected events will be\nsent as a sequence of dataCollected events followed by tracingComplete event.",
"experimental": true,
"parameters": [
{
"name": "value",
Expand Down
2 changes: 1 addition & 1 deletion package.json
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "devtools-protocol",
"version": "0.0.1252439",
"version": "0.0.1253004",
"description": "The Chrome DevTools Protocol JSON",
"repository": "https://github.com/ChromeDevTools/devtools-protocol",
"author": "The Chromium Authors",
Expand Down
Loading

0 comments on commit fcda9c0

Please sign in to comment.