devtools-protocol 0.0.1517051 → 0.0.1518305

package/json/browser_protocol.json

@@ -16537,6 +16537,57 @@
                         "zstd"
                     ]
                 },
+                {
+                    "id": "NetworkConditions",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "urlPattern",
+                            "description": "Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string\nsyntax (https://urlpattern.spec.whatwg.org/). If the pattern is empty, all requests are matched (including p2p\nconnections).",
+                            "type": "string"
+                        },
+                        {
+                            "name": "latency",
+                            "description": "Minimum latency from request sent to response headers received (ms).",
+                            "type": "number"
+                        },
+                        {
+                            "name": "downloadThroughput",
+                            "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "uploadThroughput",
+                            "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "connectionType",
+                            "description": "Connection type if known.",
+                            "optional": true,
+                            "$ref": "ConnectionType"
+                        },
+                        {
+                            "name": "packetLoss",
+                            "description": "WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.",
+                            "optional": true,
+                            "type": "number"
+                        },
+                        {
+                            "name": "packetQueueLength",
+                            "description": "WebRTC packet queue length (packet). 0 removes any queue length limitations.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "packetReordering",
+                            "description": "WebRTC packetReordering feature.",
+                            "optional": true,
+                            "type": "boolean"
+                        }
+                    ]
+                },
                 {
                     "id": "DirectSocketDnsQueryType",
                     "experimental": true,
@@ -17159,7 +17210,8 @@
                 },
                 {
                     "name": "emulateNetworkConditions",
-                    "description": "Activates emulation of network conditions.",
+                    "description": "Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule\nand overrideNetworkState commands, which can be used together to the same effect.",
+                    "deprecated": true,
                     "parameters": [
                         {
                             "name": "offline",
@@ -17210,6 +17262,69 @@
                         }
                     ]
                 },
+                {
+                    "name": "emulateNetworkConditionsByRule",
+                    "description": "Activates emulation of network conditions for individual requests using URL match patterns.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "offline",
+                            "description": "True to emulate internet disconnection.",
+                            "type": "boolean"
+                        },
+                        {
+                            "name": "matchedNetworkConditions",
+                            "description": "Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global\nconditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are\nalso applied for throttling of p2p connections.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "NetworkConditions"
+                            }
+                        }
+                    ],
+                    "returns": [
+                        {
+                            "name": "ruleIds",
+                            "description": "An id for each entry in matchedNetworkConditions. The id will be included in the requestWillBeSentExtraInfo for\nrequests affected by a rule.",
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ]
+                },
+                {
+                    "name": "overrideNetworkState",
+                    "description": "Override the state of navigator.onLine and navigator.connection.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "offline",
+                            "description": "True to emulate internet disconnection.",
+                            "type": "boolean"
+                        },
+                        {
+                            "name": "latency",
+                            "description": "Minimum latency from request sent to response headers received (ms).",
+                            "type": "number"
+                        },
+                        {
+                            "name": "downloadThroughput",
+                            "description": "Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "uploadThroughput",
+                            "description": "Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "connectionType",
+                            "description": "Connection type if known.",
+                            "optional": true,
+                            "$ref": "ConnectionType"
+                        }
+                    ]
+                },
                 {
                     "name": "enable",
                     "description": "Enables network tracking, network events will now be delivered to the client.",
@@ -18654,6 +18769,12 @@
                             "description": "Whether the site has partitioned cookies stored in a partition different than the current one.",
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "appliedNetworkConditionsId",
+                            "description": "The network conditions id if this request was affected by network conditions configured via\nemulateNetworkConditionsByRule.",
+                            "optional": true,
+                            "type": "string"
                         }
                     ]
                 },

package/package.json

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

package/pdl/domains/Network.pdl

@@ -1087,8 +1087,30 @@ domain Network
   # Disables network tracking, prevents network events from being sent to the client.
   command disable
 
-  # Activates emulation of network conditions.
-  command emulateNetworkConditions
+  experimental type NetworkConditions extends object
+    properties
+      # Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string
+      # syntax (https://urlpattern.spec.whatwg.org/). If the pattern is empty, all requests are matched (including p2p
+      # connections).
+      string urlPattern
+      # Minimum latency from request sent to response headers received (ms).
+      number latency
+      # Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
+      number downloadThroughput
+      # Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.
+      number uploadThroughput
+      # Connection type if known.
+      optional ConnectionType connectionType
+      # WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
+      optional number packetLoss
+      # WebRTC packet queue length (packet). 0 removes any queue length limitations.
+      optional integer packetQueueLength
+      # WebRTC packetReordering feature.
+      optional boolean packetReordering
+
+  # Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule
+  # and overrideNetworkState commands, which can be used together to the same effect.
+  deprecated command emulateNetworkConditions
     parameters
       # True to emulate internet disconnection.
       boolean offline
@@ -1107,6 +1129,34 @@ domain Network
       # WebRTC packetReordering feature.
       experimental optional boolean packetReordering
 
+  # Activates emulation of network conditions for individual requests using URL match patterns.
+  experimental command emulateNetworkConditionsByRule
+    parameters
+      # True to emulate internet disconnection.
+      boolean offline
+      # Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global
+      # conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are
+      # also applied for throttling of p2p connections.
+      array of NetworkConditions matchedNetworkConditions
+    returns
+      # An id for each entry in matchedNetworkConditions. The id will be included in the requestWillBeSentExtraInfo for
+      # requests affected by a rule.
+      array of string ruleIds
+
+  # Override the state of navigator.onLine and navigator.connection.
+  experimental command overrideNetworkState
+    parameters
+      # True to emulate internet disconnection.
+      boolean offline
+      # Minimum latency from request sent to response headers received (ms).
+      number latency
+      # Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
+      number downloadThroughput
+      # Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.
+      number uploadThroughput
+      # Connection type if known.
+      optional ConnectionType connectionType
+
   # Enables network tracking, network events will now be delivered to the client.
   command enable
     parameters
@@ -1776,6 +1826,9 @@ domain Network
       optional ClientSecurityState clientSecurityState
       # Whether the site has partitioned cookies stored in a partition different than the current one.
       optional boolean siteHasCookieInOtherPartition
+      # The network conditions id if this request was affected by network conditions configured via
+      # emulateNetworkConditionsByRule.
+      optional string appliedNetworkConditionsId
 
   # Fired when additional information about a responseReceived event is available from the network
   # stack. Not every responseReceived event will have an additional responseReceivedExtraInfo for

package/types/protocol-mapping.d.ts

@@ -4164,12 +4164,30 @@ export namespace ProtocolMapping {
             returnType: void;
         };
         /**
-         * Activates emulation of network conditions.
+         * Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule
+         * and overrideNetworkState commands, which can be used together to the same effect.
+         * @deprecated
          */
         'Network.emulateNetworkConditions': {
             paramsType: [Protocol.Network.EmulateNetworkConditionsRequest];
             returnType: void;
         };
+        /**
+         * Activates emulation of network conditions for individual requests using URL match patterns.
+         * @experimental
+         */
+        'Network.emulateNetworkConditionsByRule': {
+            paramsType: [Protocol.Network.EmulateNetworkConditionsByRuleRequest];
+            returnType: Protocol.Network.EmulateNetworkConditionsByRuleResponse;
+        };
+        /**
+         * Override the state of navigator.onLine and navigator.connection.
+         * @experimental
+         */
+        'Network.overrideNetworkState': {
+            paramsType: [Protocol.Network.OverrideNetworkStateRequest];
+            returnType: void;
+        };
         /**
          * Enables network tracking, network events will now be delivered to the client.
          */

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

@@ -3030,10 +3030,24 @@ export namespace ProtocolProxyApi {
         disable(): Promise<void>;
 
         /**
-         * Activates emulation of network conditions.
+         * Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule
+         * and overrideNetworkState commands, which can be used together to the same effect.
+         * @deprecated
          */
         emulateNetworkConditions(params: Protocol.Network.EmulateNetworkConditionsRequest): Promise<void>;
 
+        /**
+         * Activates emulation of network conditions for individual requests using URL match patterns.
+         * @experimental
+         */
+        emulateNetworkConditionsByRule(params: Protocol.Network.EmulateNetworkConditionsByRuleRequest): Promise<Protocol.Network.EmulateNetworkConditionsByRuleResponse>;
+
+        /**
+         * Override the state of navigator.onLine and navigator.connection.
+         * @experimental
+         */
+        overrideNetworkState(params: Protocol.Network.OverrideNetworkStateRequest): Promise<void>;
+
         /**
          * Enables network tracking, network events will now be delivered to the client.
          */

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

@@ -3198,10 +3198,24 @@ export namespace ProtocolTestsProxyApi {
         disable(): Promise<{id: number, result: void, sessionId: string}>;
 
         /**
-         * Activates emulation of network conditions.
+         * Activates emulation of network conditions. This command is deprecated in favor of the emulateNetworkConditionsByRule
+         * and overrideNetworkState commands, which can be used together to the same effect.
+         * @deprecated
          */
         emulateNetworkConditions(params: Protocol.Network.EmulateNetworkConditionsRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Activates emulation of network conditions for individual requests using URL match patterns.
+         * @experimental
+         */
+        emulateNetworkConditionsByRule(params: Protocol.Network.EmulateNetworkConditionsByRuleRequest): Promise<{id: number, result: Protocol.Network.EmulateNetworkConditionsByRuleResponse, sessionId: string}>;
+
+        /**
+         * Override the state of navigator.onLine and navigator.connection.
+         * @experimental
+         */
+        overrideNetworkState(params: Protocol.Network.OverrideNetworkStateRequest): Promise<{id: number, result: void, sessionId: string}>;
+
         /**
          * Enables network tracking, network events will now be delivered to the client.
          */

package/types/protocol.d.ts

@@ -13182,6 +13182,46 @@ export namespace Protocol {
          */
         export type ContentEncoding = ('deflate' | 'gzip' | 'br' | 'zstd');
 
+        /**
+         * @experimental
+         */
+        export interface NetworkConditions {
+            /**
+             * Only matching requests will be affected by these conditions. Patterns use the URLPattern constructor string
+             * syntax (https://urlpattern.spec.whatwg.org/). If the pattern is empty, all requests are matched (including p2p
+             * connections).
+             */
+            urlPattern: string;
+            /**
+             * Minimum latency from request sent to response headers received (ms).
+             */
+            latency: number;
+            /**
+             * Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
+             */
+            downloadThroughput: number;
+            /**
+             * Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.
+             */
+            uploadThroughput: number;
+            /**
+             * Connection type if known.
+             */
+            connectionType?: ConnectionType;
+            /**
+             * WebRTC packet loss (percent, 0-100). 0 disables packet loss emulation, 100 drops all the packets.
+             */
+            packetLoss?: number;
+            /**
+             * WebRTC packet queue length (packet). 0 removes any queue length limitations.
+             */
+            packetQueueLength?: integer;
+            /**
+             * WebRTC packetReordering feature.
+             */
+            packetReordering?: boolean;
+        }
+
         /**
          * @experimental
          */
@@ -13570,6 +13610,50 @@ export namespace Protocol {
             packetReordering?: boolean;
         }
 
+        export interface EmulateNetworkConditionsByRuleRequest {
+            /**
+             * True to emulate internet disconnection.
+             */
+            offline: boolean;
+            /**
+             * Configure conditions for matching requests. If multiple entries match a request, the first entry wins.  Global
+             * conditions can be configured by leaving the urlPattern for the conditions empty. These global conditions are
+             * also applied for throttling of p2p connections.
+             */
+            matchedNetworkConditions: NetworkConditions[];
+        }
+
+        export interface EmulateNetworkConditionsByRuleResponse {
+            /**
+             * An id for each entry in matchedNetworkConditions. The id will be included in the requestWillBeSentExtraInfo for
+             * requests affected by a rule.
+             */
+            ruleIds: string[];
+        }
+
+        export interface OverrideNetworkStateRequest {
+            /**
+             * True to emulate internet disconnection.
+             */
+            offline: boolean;
+            /**
+             * Minimum latency from request sent to response headers received (ms).
+             */
+            latency: number;
+            /**
+             * Maximal aggregated download throughput (bytes/sec). -1 disables download throttling.
+             */
+            downloadThroughput: number;
+            /**
+             * Maximal aggregated upload throughput (bytes/sec).  -1 disables upload throttling.
+             */
+            uploadThroughput: number;
+            /**
+             * Connection type if known.
+             */
+            connectionType?: ConnectionType;
+        }
+
         export interface EnableRequest {
             /**
              * Buffer size in bytes to use when preserving network payloads (XHRs, etc).
@@ -14594,6 +14678,11 @@ export namespace Protocol {
              * Whether the site has partitioned cookies stored in a partition different than the current one.
              */
             siteHasCookieInOtherPartition?: boolean;
+            /**
+             * The network conditions id if this request was affected by network conditions configured via
+             * emulateNetworkConditionsByRule.
+             */
+            appliedNetworkConditionsId?: string;
         }
 
         /**