devtools-protocol 0.0.1583009 → 0.0.1587613

package/json/browser_protocol.json

@@ -1183,6 +1183,29 @@
                         }
                     ]
                 },
+                {
+                    "id": "PerformanceIssueType",
+                    "type": "string",
+                    "enum": [
+                        "DocumentCookie"
+                    ]
+                },
+                {
+                    "id": "PerformanceIssueDetails",
+                    "description": "Details for a performance issue.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "performanceIssueType",
+                            "$ref": "PerformanceIssueType"
+                        },
+                        {
+                            "name": "sourceCodeLocation",
+                            "optional": true,
+                            "$ref": "SourceCodeLocation"
+                        }
+                    ]
+                },
                 {
                     "id": "MixedContentResolutionStatus",
                     "type": "string",
@@ -2270,7 +2293,8 @@
                         "UnencodedDigestIssue",
                         "ConnectionAllowlistIssue",
                         "UserReidentificationIssue",
-                        "PermissionElementIssue"
+                        "PermissionElementIssue",
+                        "PerformanceIssue"
                     ]
                 },
                 {
@@ -2418,6 +2442,11 @@
                             "name": "permissionElementIssueDetails",
                             "optional": true,
                             "$ref": "PermissionElementIssueDetails"
+                        },
+                        {
+                            "name": "performanceIssueDetails",
+                            "optional": true,
+                            "$ref": "PerformanceIssueDetails"
                         }
                     ]
                 },
@@ -11463,7 +11492,7 @@
                 },
                 {
                     "name": "getScreenInfos",
-                    "description": "Returns device's screen configuration.",
+                    "description": "Returns device's screen configuration. In headful mode, the physical screens configuration is returned,\nwhereas in headless mode, a virtual headless screen configuration is provided instead.",
                     "experimental": true,
                     "returns": [
                         {
@@ -17891,7 +17920,7 @@
                     "parameters": [
                         {
                             "name": "maxTotalBufferSize",
-                            "description": "Buffer size in bytes to use when preserving network payloads (XHRs, etc).",
+                            "description": "Buffer size in bytes to use when preserving network payloads (XHRs, etc).\nThis is the maximum number of bytes that will be collected by this\nDevTools session.",
                             "experimental": true,
                             "optional": true,
                             "type": "integer"

package/package.json

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

package/pdl/domains/Audits.pdl

@@ -105,6 +105,16 @@ experimental domain Audits
       # The recommended solution to the issue.
       optional CookieIssueInsight insight
 
+  type PerformanceIssueType extends string
+    enum
+      DocumentCookie
+
+  # Details for a performance issue.
+  type PerformanceIssueDetails extends object
+    properties
+      PerformanceIssueType performanceIssueType
+      optional SourceCodeLocation sourceCodeLocation
+
   type MixedContentResolutionStatus extends string
     enum
       MixedContentBlocked
@@ -720,6 +730,7 @@ experimental domain Audits
       ConnectionAllowlistIssue
       UserReidentificationIssue
       PermissionElementIssue
+      PerformanceIssue
 
   # This struct holds a list of optional fields with additional information
   # specific to the kind of issue. When adding a new issue code, please also
@@ -754,6 +765,7 @@ experimental domain Audits
       optional ConnectionAllowlistIssueDetails connectionAllowlistIssueDetails
       optional UserReidentificationIssueDetails userReidentificationIssueDetails
       optional PermissionElementIssueDetails permissionElementIssueDetails
+      optional PerformanceIssueDetails performanceIssueDetails
 
   # A unique id for a DevTools inspector issue. Allows other entities (e.g.
   # exceptions, CDP message, console messages, etc.) to reference an issue.

package/pdl/domains/Emulation.pdl

@@ -571,7 +571,8 @@ domain Emulation
       # of size 100lvh.
       integer difference
 
-  # Returns device's screen configuration.
+  # Returns device's screen configuration. In headful mode, the physical screens configuration is returned,
+  # whereas in headless mode, a virtual headless screen configuration is provided instead.
   experimental command getScreenInfos
     returns
       array of ScreenInfo screenInfos

package/pdl/domains/Network.pdl

@@ -1113,6 +1113,8 @@ domain Network
   command enable
     parameters
       # Buffer size in bytes to use when preserving network payloads (XHRs, etc).
+      # This is the maximum number of bytes that will be collected by this
+      # DevTools session.
       experimental optional integer maxTotalBufferSize
       # Per-resource buffer size in bytes to use when preserving network payloads (XHRs, etc).
       experimental optional integer maxResourceBufferSize

package/types/protocol-mapping.d.ts

@@ -3562,7 +3562,8 @@ export namespace ProtocolMapping {
             returnType: void;
         };
         /**
-         * Returns device's screen configuration.
+         * Returns device's screen configuration. In headful mode, the physical screens configuration is returned,
+         * whereas in headless mode, a virtual headless screen configuration is provided instead.
          * @experimental
          */
         'Emulation.getScreenInfos': {

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

@@ -2366,7 +2366,8 @@ export namespace ProtocolProxyApi {
         setSmallViewportHeightDifferenceOverride(params: Protocol.Emulation.SetSmallViewportHeightDifferenceOverrideRequest): Promise<void>;
 
         /**
-         * Returns device's screen configuration.
+         * Returns device's screen configuration. In headful mode, the physical screens configuration is returned,
+         * whereas in headless mode, a virtual headless screen configuration is provided instead.
          * @experimental
          */
         getScreenInfos(): Promise<Protocol.Emulation.GetScreenInfosResponse>;

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

@@ -2502,7 +2502,8 @@ export namespace ProtocolTestsProxyApi {
         setSmallViewportHeightDifferenceOverride(params: Protocol.Emulation.SetSmallViewportHeightDifferenceOverrideRequest): Promise<{id: number, result: void, sessionId: string}>;
 
         /**
-         * Returns device's screen configuration.
+         * Returns device's screen configuration. In headful mode, the physical screens configuration is returned,
+         * whereas in headless mode, a virtual headless screen configuration is provided instead.
          * @experimental
          */
         getScreenInfos(): Promise<{id: number, result: Protocol.Emulation.GetScreenInfosResponse, sessionId: string}>;

package/types/protocol.d.ts

@@ -3505,6 +3505,16 @@ export namespace Protocol {
             insight?: CookieIssueInsight;
         }
 
+        export type PerformanceIssueType = ('DocumentCookie');
+
+        /**
+         * Details for a performance issue.
+         */
+        export interface PerformanceIssueDetails {
+            performanceIssueType: PerformanceIssueType;
+            sourceCodeLocation?: SourceCodeLocation;
+        }
+
         export type MixedContentResolutionStatus = ('MixedContentBlocked' | 'MixedContentAutomaticallyUpgraded' | 'MixedContentWarning');
 
         export type MixedContentResourceType = ('AttributionSrc' | 'Audio' | 'Beacon' | 'CSPReport' | 'Download' | 'EventSource' | 'Favicon' | 'Font' | 'Form' | 'Frame' | 'Image' | 'Import' | 'JSON' | 'Manifest' | 'Ping' | 'PluginData' | 'PluginResource' | 'Prefetch' | 'Resource' | 'Script' | 'ServiceWorker' | 'SharedWorker' | 'SpeculationRules' | 'Stylesheet' | 'Track' | 'Video' | 'Worker' | 'XMLHttpRequest' | 'XSLT');
@@ -3931,7 +3941,7 @@ export namespace Protocol {
          * optional fields in InspectorIssueDetails to convey more specific
          * information about the kind of issue.
          */
-        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue');
+        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue' | 'PerformanceIssue');
 
         /**
          * This struct holds a list of optional fields with additional information
@@ -3970,6 +3980,7 @@ export namespace Protocol {
             connectionAllowlistIssueDetails?: ConnectionAllowlistIssueDetails;
             userReidentificationIssueDetails?: UserReidentificationIssueDetails;
             permissionElementIssueDetails?: PermissionElementIssueDetails;
+            performanceIssueDetails?: PerformanceIssueDetails;
         }
 
         /**
@@ -14017,6 +14028,8 @@ export namespace Protocol {
         export interface EnableRequest {
             /**
              * Buffer size in bytes to use when preserving network payloads (XHRs, etc).
+             * This is the maximum number of bytes that will be collected by this
+             * DevTools session.
              * @experimental
              */
             maxTotalBufferSize?: integer;