devtools-protocol 0.0.1558402 → 0.0.1560991

package/json/browser_protocol.json

@@ -15273,6 +15273,19 @@
                         "VeryHigh"
                     ]
                 },
+                {
+                    "id": "RenderBlockingBehavior",
+                    "description": "The render blocking behavior of a resource request.",
+                    "experimental": true,
+                    "type": "string",
+                    "enum": [
+                        "Blocking",
+                        "InBodyParserBlocking",
+                        "NonBlocking",
+                        "NonBlockingDynamic",
+                        "PotentiallyBlocking"
+                    ]
+                },
                 {
                     "id": "PostDataEntry",
                     "description": "Post data entry for HTTP request",
@@ -17510,13 +17523,32 @@
                         },
                         {
                             "name": "enableDurableMessages",
-                            "description": "Enable storing response bodies outside of renderer, so that these survive\na cross-process navigation. Requires maxTotalBufferSize to be set.\nCurrently defaults to false.",
+                            "description": "Enable storing response bodies outside of renderer, so that these survive\na cross-process navigation. Requires maxTotalBufferSize to be set.\nCurrently defaults to false. This field is being deprecated in favor of the dedicated\nconfigureDurableMessages command, due to the possibility of deadlocks when awaiting\nNetwork.enable before issuing Runtime.runIfWaitingForDebugger.",
                             "experimental": true,
                             "optional": true,
                             "type": "boolean"
                         }
                     ]
                 },
+                {
+                    "name": "configureDurableMessages",
+                    "description": "Configures storing response bodies outside of renderer, so that these survive\na cross-process navigation.\nIf maxTotalBufferSize is not set, durable messages are disabled.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "maxTotalBufferSize",
+                            "description": "Buffer size in bytes to use when preserving network payloads (XHRs, etc).",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "maxResourceBufferSize",
+                            "description": "Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).",
+                            "optional": true,
+                            "type": "integer"
+                        }
+                    ]
+                },
                 {
                     "name": "getAllCookies",
                     "description": "Returns all browser cookies. Depending on the backend support, will return detailed cookie\ninformation in the `cookies` field.\nDeprecated. Use Storage.getCookies instead.",
@@ -18329,6 +18361,13 @@
                             "description": "Whether the request is initiated by a user gesture. Defaults to false.",
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "renderBlockingBehavior",
+                            "description": "The render blocking behavior of the request.",
+                            "experimental": true,
+                            "optional": true,
+                            "$ref": "RenderBlockingBehavior"
                         }
                     ]
                 },
@@ -20672,7 +20711,9 @@
                         "language-detector",
                         "language-model",
                         "local-fonts",
+                        "local-network",
                         "local-network-access",
+                        "loopback-network",
                         "magnetometer",
                         "manual-text",
                         "media-playback-while-not-visible",
@@ -28686,6 +28727,18 @@
                         }
                     ]
                 },
+                {
+                    "name": "getTrackEventDescriptor",
+                    "description": "Return a descriptor for all available tracing categories.",
+                    "experimental": true,
+                    "returns": [
+                        {
+                            "name": "descriptor",
+                            "description": "Base64-encoded serialized perfetto.protos.TrackEventDescriptor protobuf message. (Encoded as a base64 string when passed over JSON)",
+                            "type": "string"
+                        }
+                    ]
+                },
                 {
                     "name": "recordClockSyncMarker",
                     "description": "Record a clock sync marker in the trace.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1558402",
+  "version": "0.0.1560991",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/domains/Network.pdl

@@ -166,6 +166,15 @@ domain Network
       High
       VeryHigh
 
+  # The render blocking behavior of a resource request.
+  experimental type RenderBlockingBehavior extends string
+    enum
+      Blocking
+      InBodyParserBlocking
+      NonBlocking
+      NonBlockingDynamic
+      PotentiallyBlocking
+
   # Post data entry for HTTP request
   type PostDataEntry extends object
     properties
@@ -1145,9 +1154,21 @@ domain Network
       experimental optional boolean reportDirectSocketTraffic
       # Enable storing response bodies outside of renderer, so that these survive
       # a cross-process navigation. Requires maxTotalBufferSize to be set.
-      # Currently defaults to false.
+      # Currently defaults to false. This field is being deprecated in favor of the dedicated
+      # configureDurableMessages command, due to the possibility of deadlocks when awaiting
+      # Network.enable before issuing Runtime.runIfWaitingForDebugger.
       experimental optional boolean enableDurableMessages
 
+  # Configures storing response bodies outside of renderer, so that these survive
+  # a cross-process navigation.
+  # If maxTotalBufferSize is not set, durable messages are disabled.
+  experimental command configureDurableMessages
+    parameters
+      # Buffer size in bytes to use when preserving network payloads (XHRs, etc).
+      optional integer maxTotalBufferSize
+      # Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
+      optional integer maxResourceBufferSize
+
   # Returns all browser cookies. Depending on the backend support, will return detailed cookie
   # information in the `cookies` field.
   # Deprecated. Use Storage.getCookies instead.
@@ -1486,6 +1507,8 @@ domain Network
       optional Page.FrameId frameId
       # Whether the request is initiated by a user gesture. Defaults to false.
       optional boolean hasUserGesture
+      # The render blocking behavior of the request.
+      experimental optional RenderBlockingBehavior renderBlockingBehavior
 
   # Fired when resource loading priority is changed
   experimental event resourceChangedPriority

package/pdl/domains/Page.pdl

@@ -164,7 +164,9 @@ domain Page
       language-detector
       language-model
       local-fonts
+      local-network
       local-network-access
+      loopback-network
       magnetometer
       manual-text
       media-playback-while-not-visible

package/pdl/domains/Tracing.pdl

@@ -78,6 +78,12 @@ domain Tracing
       # 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

package/types/protocol-mapping.d.ts

@@ -4178,6 +4178,16 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Network.EnableRequest?];
             returnType: void;
         };
+        /**
+         * Configures storing response bodies outside of renderer, so that these survive
+         * a cross-process navigation.
+         * If maxTotalBufferSize is not set, durable messages are disabled.
+         * @experimental
+         */
+        'Network.configureDurableMessages': {
+            paramsType: [Protocol.Network.ConfigureDurableMessagesRequest?];
+            returnType: void;
+        };
         /**
          * Returns all browser cookies. Depending on the backend support, will return detailed cookie
          * information in the `cookies` field.
@@ -5813,6 +5823,14 @@ export namespace ProtocolMapping {
             paramsType: [];
             returnType: Protocol.Tracing.GetCategoriesResponse;
         };
+        /**
+         * Return a descriptor for all available tracing categories.
+         * @experimental
+         */
+        'Tracing.getTrackEventDescriptor': {
+            paramsType: [];
+            returnType: Protocol.Tracing.GetTrackEventDescriptorResponse;
+        };
         /**
          * Record a clock sync marker in the trace.
          * @experimental

package/types/protocol-proxy-api.d.ts

@@ -3056,6 +3056,14 @@ export namespace ProtocolProxyApi {
          */
         enable(params: Protocol.Network.EnableRequest): Promise<void>;
 
+        /**
+         * Configures storing response bodies outside of renderer, so that these survive
+         * a cross-process navigation.
+         * If maxTotalBufferSize is not set, durable messages are disabled.
+         * @experimental
+         */
+        configureDurableMessages(params: Protocol.Network.ConfigureDurableMessagesRequest): Promise<void>;
+
         /**
          * Returns all browser cookies. Depending on the backend support, will return detailed cookie
          * information in the `cookies` field.
@@ -4933,6 +4941,12 @@ export namespace ProtocolProxyApi {
          */
         getCategories(): Promise<Protocol.Tracing.GetCategoriesResponse>;
 
+        /**
+         * Return a descriptor for all available tracing categories.
+         * @experimental
+         */
+        getTrackEventDescriptor(): Promise<Protocol.Tracing.GetTrackEventDescriptorResponse>;
+
         /**
          * Record a clock sync marker in the trace.
          * @experimental

package/types/protocol-tests-proxy-api.d.ts

@@ -3228,6 +3228,14 @@ export namespace ProtocolTestsProxyApi {
          */
         enable(params: Protocol.Network.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Configures storing response bodies outside of renderer, so that these survive
+         * a cross-process navigation.
+         * If maxTotalBufferSize is not set, durable messages are disabled.
+         * @experimental
+         */
+        configureDurableMessages(params: Protocol.Network.ConfigureDurableMessagesRequest): Promise<{id: number, result: void, sessionId: string}>;
+
         /**
          * Returns all browser cookies. Depending on the backend support, will return detailed cookie
          * information in the `cookies` field.
@@ -5327,6 +5335,12 @@ export namespace ProtocolTestsProxyApi {
          */
         getCategories(): Promise<{id: number, result: Protocol.Tracing.GetCategoriesResponse, sessionId: string}>;
 
+        /**
+         * Return a descriptor for all available tracing categories.
+         * @experimental
+         */
+        getTrackEventDescriptor(): Promise<{id: number, result: Protocol.Tracing.GetTrackEventDescriptorResponse, sessionId: string}>;
+
         /**
          * Record a clock sync marker in the trace.
          * @experimental

package/types/protocol.d.ts

@@ -12268,6 +12268,12 @@ export namespace Protocol {
          */
         export type ResourcePriority = ('VeryLow' | 'Low' | 'Medium' | 'High' | 'VeryHigh');
 
+        /**
+         * The render blocking behavior of a resource request.
+         * @experimental
+         */
+        export type RenderBlockingBehavior = ('Blocking' | 'InBodyParserBlocking' | 'NonBlocking' | 'NonBlockingDynamic' | 'PotentiallyBlocking');
+
         /**
          * Post data entry for HTTP request
          */
@@ -13763,12 +13769,25 @@ export namespace Protocol {
             /**
              * Enable storing response bodies outside of renderer, so that these survive
              * a cross-process navigation. Requires maxTotalBufferSize to be set.
-             * Currently defaults to false.
+             * Currently defaults to false. This field is being deprecated in favor of the dedicated
+             * configureDurableMessages command, due to the possibility of deadlocks when awaiting
+             * Network.enable before issuing Runtime.runIfWaitingForDebugger.
              * @experimental
              */
             enableDurableMessages?: boolean;
         }
 
+        export interface ConfigureDurableMessagesRequest {
+            /**
+             * Buffer size in bytes to use when preserving network payloads (XHRs, etc).
+             */
+            maxTotalBufferSize?: integer;
+            /**
+             * Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
+             */
+            maxResourceBufferSize?: integer;
+        }
+
         export interface GetAllCookiesResponse {
             /**
              * Array of cookie objects.
@@ -14345,6 +14364,11 @@ export namespace Protocol {
              * Whether the request is initiated by a user gesture. Defaults to false.
              */
             hasUserGesture?: boolean;
+            /**
+             * The render blocking behavior of the request.
+             * @experimental
+             */
+            renderBlockingBehavior?: RenderBlockingBehavior;
         }
 
         /**
@@ -15879,7 +15903,7 @@ export namespace Protocol {
          * in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
          * @experimental
          */
-        export type PermissionsPolicyFeature = ('accelerometer' | 'all-screens-capture' | 'ambient-light-sensor' | 'aria-notify' | 'attribution-reporting' | 'autofill' | 'autoplay' | 'bluetooth' | 'browsing-topics' | 'camera' | 'captured-surface-control' | 'ch-dpr' | 'ch-device-memory' | 'ch-downlink' | 'ch-ect' | 'ch-prefers-color-scheme' | 'ch-prefers-reduced-motion' | 'ch-prefers-reduced-transparency' | 'ch-rtt' | 'ch-save-data' | 'ch-ua' | 'ch-ua-arch' | 'ch-ua-bitness' | 'ch-ua-high-entropy-values' | 'ch-ua-platform' | 'ch-ua-model' | 'ch-ua-mobile' | 'ch-ua-form-factors' | 'ch-ua-full-version' | 'ch-ua-full-version-list' | 'ch-ua-platform-version' | 'ch-ua-wow64' | 'ch-viewport-height' | 'ch-viewport-width' | 'ch-width' | 'clipboard-read' | 'clipboard-write' | 'compute-pressure' | 'controlled-frame' | 'cross-origin-isolated' | 'deferred-fetch' | 'deferred-fetch-minimal' | 'device-attributes' | 'digital-credentials-create' | 'digital-credentials-get' | 'direct-sockets' | 'direct-sockets-multicast' | 'direct-sockets-private' | 'display-capture' | 'document-domain' | 'encrypted-media' | 'execution-while-out-of-viewport' | 'execution-while-not-rendered' | 'fenced-unpartitioned-storage-read' | 'focus-without-user-activation' | 'fullscreen' | 'frobulate' | 'gamepad' | 'geolocation' | 'gyroscope' | 'hid' | 'identity-credentials-get' | 'idle-detection' | 'interest-cohort' | 'join-ad-interest-group' | 'keyboard-map' | 'language-detector' | 'language-model' | 'local-fonts' | 'local-network-access' | 'magnetometer' | 'manual-text' | 'media-playback-while-not-visible' | 'microphone' | 'midi' | 'on-device-speech-recognition' | 'otp-credentials' | 'payment' | 'picture-in-picture' | 'private-aggregation' | 'private-state-token-issuance' | 'private-state-token-redemption' | 'publickey-credentials-create' | 'publickey-credentials-get' | 'record-ad-auction-events' | 'rewriter' | 'run-ad-auction' | 'screen-wake-lock' | 'serial' | 'shared-storage' | 'shared-storage-select-url' | 'smart-card' | 'speaker-selection' | 'storage-access' | 'sub-apps' | 'summarizer' | 'sync-xhr' | 'translator' | 'unload' | 'usb' | 'usb-unrestricted' | 'vertical-scroll' | 'web-app-installation' | 'web-printing' | 'web-share' | 'window-management' | 'writer' | 'xr-spatial-tracking');
+        export type PermissionsPolicyFeature = ('accelerometer' | 'all-screens-capture' | 'ambient-light-sensor' | 'aria-notify' | 'attribution-reporting' | 'autofill' | 'autoplay' | 'bluetooth' | 'browsing-topics' | 'camera' | 'captured-surface-control' | 'ch-dpr' | 'ch-device-memory' | 'ch-downlink' | 'ch-ect' | 'ch-prefers-color-scheme' | 'ch-prefers-reduced-motion' | 'ch-prefers-reduced-transparency' | 'ch-rtt' | 'ch-save-data' | 'ch-ua' | 'ch-ua-arch' | 'ch-ua-bitness' | 'ch-ua-high-entropy-values' | 'ch-ua-platform' | 'ch-ua-model' | 'ch-ua-mobile' | 'ch-ua-form-factors' | 'ch-ua-full-version' | 'ch-ua-full-version-list' | 'ch-ua-platform-version' | 'ch-ua-wow64' | 'ch-viewport-height' | 'ch-viewport-width' | 'ch-width' | 'clipboard-read' | 'clipboard-write' | 'compute-pressure' | 'controlled-frame' | 'cross-origin-isolated' | 'deferred-fetch' | 'deferred-fetch-minimal' | 'device-attributes' | 'digital-credentials-create' | 'digital-credentials-get' | 'direct-sockets' | 'direct-sockets-multicast' | 'direct-sockets-private' | 'display-capture' | 'document-domain' | 'encrypted-media' | 'execution-while-out-of-viewport' | 'execution-while-not-rendered' | 'fenced-unpartitioned-storage-read' | 'focus-without-user-activation' | 'fullscreen' | 'frobulate' | 'gamepad' | 'geolocation' | 'gyroscope' | 'hid' | 'identity-credentials-get' | 'idle-detection' | 'interest-cohort' | 'join-ad-interest-group' | 'keyboard-map' | 'language-detector' | 'language-model' | 'local-fonts' | 'local-network' | 'local-network-access' | 'loopback-network' | 'magnetometer' | 'manual-text' | 'media-playback-while-not-visible' | 'microphone' | 'midi' | 'on-device-speech-recognition' | 'otp-credentials' | 'payment' | 'picture-in-picture' | 'private-aggregation' | 'private-state-token-issuance' | 'private-state-token-redemption' | 'publickey-credentials-create' | 'publickey-credentials-get' | 'record-ad-auction-events' | 'rewriter' | 'run-ad-auction' | 'screen-wake-lock' | 'serial' | 'shared-storage' | 'shared-storage-select-url' | 'smart-card' | 'speaker-selection' | 'storage-access' | 'sub-apps' | 'summarizer' | 'sync-xhr' | 'translator' | 'unload' | 'usb' | 'usb-unrestricted' | 'vertical-scroll' | 'web-app-installation' | 'web-printing' | 'web-share' | 'window-management' | 'writer' | 'xr-spatial-tracking');
 
         /**
          * Reason for a permissions policy feature to be disabled.
@@ -20688,6 +20712,13 @@ export namespace Protocol {
             categories: string[];
         }
 
+        export interface GetTrackEventDescriptorResponse {
+            /**
+             * Base64-encoded serialized perfetto.protos.TrackEventDescriptor protobuf message. (Encoded as a base64 string when passed over JSON)
+             */
+            descriptor: string;
+        }
+
         export interface RecordClockSyncMarkerRequest {
             /**
              * The ID of this clock sync marker