devtools-protocol 0.0.1637485 → 0.0.1638949

package/json/browser_protocol.json

@@ -598,6 +598,67 @@
                 }
             ]
         },
+        {
+            "domain": "Ads",
+            "description": "A domain for ad-related metrics and data.",
+            "experimental": true,
+            "dependencies": [
+                "Network",
+                "Page",
+                "Runtime"
+            ],
+            "types": [
+                {
+                    "id": "AdMetrics",
+                    "description": "Ad metrics for a page.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "viewportAdDensityByArea",
+                            "description": "The viewport ad density by area, represented as a percentage (an integer\nbetween 0 and 100).",
+                            "type": "integer"
+                        },
+                        {
+                            "name": "averageViewportAdDensityByArea",
+                            "description": "The time-weighted average of the viewport ad density by area, measured\nacross the duration of the page.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "viewportAdCount",
+                            "description": "The number of ads currently visible within the viewport.",
+                            "type": "integer"
+                        },
+                        {
+                            "name": "averageViewportAdCount",
+                            "description": "The time-weighted average of the viewport ad count, measured across the\nduration of the page.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "totalAdCpuTime",
+                            "description": "The total ad CPU usage, in milliseconds.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "totalAdNetworkBytes",
+                            "description": "The total ad network bytes.",
+                            "type": "number"
+                        }
+                    ]
+                }
+            ],
+            "commands": [
+                {
+                    "name": "getAdMetrics",
+                    "description": "Retrieves ad metrics for the current page.",
+                    "returns": [
+                        {
+                            "name": "metrics",
+                            "$ref": "AdMetrics"
+                        }
+                    ]
+                }
+            ]
+        },
         {
             "domain": "Animation",
             "experimental": true,
@@ -2008,7 +2069,18 @@
                         "RpOriginIsOpaque",
                         "WellKnownMissingAccountsEndpoint",
                         "UserLoggedOut",
-                        "WellKnownAccountsEndpointCrossOrigin"
+                        "WellKnownAccountsEndpointCrossOrigin",
+                        "AccountsHttpNotFound",
+                        "AccountsNoResponse",
+                        "AccountsInvalidResponse",
+                        "AccountsInvalidContentType",
+                        "AccountsEmptyList",
+                        "EmailVerificationWellKnownHttpNotFound",
+                        "EmailVerificationWellKnownNoResponse",
+                        "EmailVerificationWellKnownInvalidResponse",
+                        "EmailVerificationWellKnownInvalidContentType",
+                        "JwksHttpNotFound",
+                        "JwksInvalidResponse"
                     ]
                 },
                 {
@@ -25625,7 +25697,8 @@
                         "PrefetchProxyNotAvailable",
                         "PrefetchResponseUsed",
                         "PrefetchSuccessfulButNotUsed",
-                        "PrefetchNotUsedProbeFailed"
+                        "PrefetchNotUsedProbeFailed",
+                        "PrefetchCancelledOnUserNavigation"
                     ]
                 },
                 {
@@ -29307,7 +29380,7 @@
                         },
                         {
                             "name": "panelId",
-                            "description": "The id of the panel we want DevTools to open initially. Currently\nsupported panels are elements, console, network, sources, resources\nand performance.",
+                            "description": "The id of the panel we want DevTools to open initially. Currently\nsupported panels are elements, console, network, sources, resources,\ntimeline, chrome-recorder, heap-profiler, lighthouse, and security.",
                             "optional": true,
                             "type": "string"
                         }

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -9,6 +9,7 @@ version
   minor 3
 
 include domains/Accessibility.pdl
+include domains/Ads.pdl
 include domains/Animation.pdl
 include domains/Audits.pdl
 include domains/Autofill.pdl

package/pdl/domains/Ads.pdl

@@ -0,0 +1,33 @@
+# Copyright 2026 The Chromium Authors
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+# A domain for ad-related metrics and data.
+experimental domain Ads
+  depends on Network
+  depends on Page
+  depends on Runtime
+
+  # Ad metrics for a page.
+  type AdMetrics extends object
+    properties
+      # The viewport ad density by area, represented as a percentage (an integer
+      # between 0 and 100).
+      integer viewportAdDensityByArea
+      # The time-weighted average of the viewport ad density by area, measured
+      # across the duration of the page.
+      number averageViewportAdDensityByArea
+      # The number of ads currently visible within the viewport.
+      integer viewportAdCount
+      # The time-weighted average of the viewport ad count, measured across the
+      # duration of the page.
+      number averageViewportAdCount
+      # The total ad CPU usage, in milliseconds.
+      number totalAdCpuTime
+      # The total ad network bytes.
+      number totalAdNetworkBytes
+
+  # Retrieves ad metrics for the current page.
+  command getAdMetrics
+    returns
+      AdMetrics metrics

package/pdl/domains/Audits.pdl

@@ -592,6 +592,17 @@ experimental domain Audits
       WellKnownMissingAccountsEndpoint
       UserLoggedOut
       WellKnownAccountsEndpointCrossOrigin
+      AccountsHttpNotFound
+      AccountsNoResponse
+      AccountsInvalidResponse
+      AccountsInvalidContentType
+      AccountsEmptyList
+      EmailVerificationWellKnownHttpNotFound
+      EmailVerificationWellKnownNoResponse
+      EmailVerificationWellKnownInvalidResponse
+      EmailVerificationWellKnownInvalidContentType
+      JwksHttpNotFound
+      JwksInvalidResponse
 
   # This issue tracks client hints related issues. It's used to deprecate old
   # features, encourage the use of new ones, and provide general guidance.

package/pdl/domains/Preload.pdl

@@ -258,6 +258,7 @@ experimental domain Preload
       # The prefetch finished successfully but was never used.
       PrefetchSuccessfulButNotUsed
       PrefetchNotUsedProbeFailed
+      PrefetchCancelledOnUserNavigation
 
   # Fired when a prefetch attempt is updated.
   event prefetchStatusUpdated

package/pdl/domains/Target.pdl

@@ -349,8 +349,8 @@ domain Target
       # This can be the page or tab target ID.
       TargetID targetId
       # The id of the panel we want DevTools to open initially. Currently
-      # supported panels are elements, console, network, sources, resources
-      # and performance.
+      # supported panels are elements, console, network, sources, resources,
+      # timeline, chrome-recorder, heap-profiler, lighthouse, and security.
       optional string panelId
     returns
       # The targetId of DevTools page target.

package/types/protocol-mapping.d.ts

@@ -1779,6 +1779,13 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Accessibility.QueryAXTreeRequest?];
             returnType: Protocol.Accessibility.QueryAXTreeResponse;
         };
+        /**
+         * Retrieves ad metrics for the current page.
+         */
+        'Ads.getAdMetrics': {
+            paramsType: [];
+            returnType: Protocol.Ads.GetAdMetricsResponse;
+        };
         /**
          * Disables animation domain notifications.
          */

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

@@ -28,6 +28,8 @@ export namespace ProtocolProxyApi {
 
         Accessibility: AccessibilityApi;
 
+        Ads: AdsApi;
+
         Animation: AnimationApi;
 
         Audits: AuditsApi;
@@ -756,6 +758,14 @@ export namespace ProtocolProxyApi {
 
     }
 
+    export interface AdsApi {
+        /**
+         * Retrieves ad metrics for the current page.
+         */
+        getAdMetrics(): Promise<Protocol.Ads.GetAdMetricsResponse>;
+
+    }
+
     export interface AnimationApi {
         /**
          * Disables animation domain notifications.

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

@@ -28,6 +28,8 @@ export namespace ProtocolTestsProxyApi {
 
         Accessibility: AccessibilityApi;
 
+        Ads: AdsApi;
+
         Animation: AnimationApi;
 
         Audits: AuditsApi;
@@ -804,6 +806,14 @@ export namespace ProtocolTestsProxyApi {
 
     }
 
+    export interface AdsApi {
+        /**
+         * Retrieves ad metrics for the current page.
+         */
+        getAdMetrics(): Promise<{id: number, result: Protocol.Ads.GetAdMetricsResponse, sessionId: string}>;
+
+    }
+
     export interface AnimationApi {
         /**
          * Disables animation domain notifications.

package/types/protocol.d.ts

@@ -3118,6 +3118,50 @@ export namespace Protocol {
         }
     }
 
+    /**
+     * A domain for ad-related metrics and data.
+     * @experimental
+     */
+    export namespace Ads {
+
+        /**
+         * Ad metrics for a page.
+         */
+        export interface AdMetrics {
+            /**
+             * The viewport ad density by area, represented as a percentage (an integer
+             * between 0 and 100).
+             */
+            viewportAdDensityByArea: integer;
+            /**
+             * The time-weighted average of the viewport ad density by area, measured
+             * across the duration of the page.
+             */
+            averageViewportAdDensityByArea: number;
+            /**
+             * The number of ads currently visible within the viewport.
+             */
+            viewportAdCount: integer;
+            /**
+             * The time-weighted average of the viewport ad count, measured across the
+             * duration of the page.
+             */
+            averageViewportAdCount: number;
+            /**
+             * The total ad CPU usage, in milliseconds.
+             */
+            totalAdCpuTime: number;
+            /**
+             * The total ad network bytes.
+             */
+            totalAdNetworkBytes: number;
+        }
+
+        export interface GetAdMetricsResponse {
+            metrics: AdMetrics;
+        }
+    }
+
     /**
      * @experimental
      */
@@ -3793,7 +3837,7 @@ export namespace Protocol {
          * Should be updated alongside EmailVerificationRequestResult in
          * third_party/blink/public/mojom/devtools/inspector_issue.mojom.
          */
-        export type EmailVerificationRequestIssueReason = ('InvalidEmail' | 'DnsFetchFailed' | 'DnsInvalidRecord' | 'WellKnownHttpNotFound' | 'WellKnownNoResponse' | 'WellKnownInvalidResponse' | 'WellKnownListEmpty' | 'WellKnownInvalidContentType' | 'WellKnownMissingIssuanceEndpoint' | 'WellKnownIssuanceEndpointCrossOrigin' | 'WellKnownUnsupportedSigningAlgorithm' | 'TokenHttpNotFound' | 'TokenNoResponse' | 'TokenInvalidResponse' | 'TokenInvalidContentType' | 'TokenMalformedSdJwt' | 'TokenInvalidSdJwt' | 'KeyBindingSigningFailed' | 'RpOriginIsOpaque' | 'WellKnownMissingAccountsEndpoint' | 'UserLoggedOut' | 'WellKnownAccountsEndpointCrossOrigin');
+        export type EmailVerificationRequestIssueReason = ('InvalidEmail' | 'DnsFetchFailed' | 'DnsInvalidRecord' | 'WellKnownHttpNotFound' | 'WellKnownNoResponse' | 'WellKnownInvalidResponse' | 'WellKnownListEmpty' | 'WellKnownInvalidContentType' | 'WellKnownMissingIssuanceEndpoint' | 'WellKnownIssuanceEndpointCrossOrigin' | 'WellKnownUnsupportedSigningAlgorithm' | 'TokenHttpNotFound' | 'TokenNoResponse' | 'TokenInvalidResponse' | 'TokenInvalidContentType' | 'TokenMalformedSdJwt' | 'TokenInvalidSdJwt' | 'KeyBindingSigningFailed' | 'RpOriginIsOpaque' | 'WellKnownMissingAccountsEndpoint' | 'UserLoggedOut' | 'WellKnownAccountsEndpointCrossOrigin' | 'AccountsHttpNotFound' | 'AccountsNoResponse' | 'AccountsInvalidResponse' | 'AccountsInvalidContentType' | 'AccountsEmptyList' | 'EmailVerificationWellKnownHttpNotFound' | 'EmailVerificationWellKnownNoResponse' | 'EmailVerificationWellKnownInvalidResponse' | 'EmailVerificationWellKnownInvalidContentType' | 'JwksHttpNotFound' | 'JwksInvalidResponse');
 
         /**
          * This issue tracks client hints related issues. It's used to deprecate old
@@ -18968,7 +19012,7 @@ export namespace Protocol {
          * TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
          * filter out the ones that aren't necessary to the developers.
          */
-        export type PrefetchStatus = ('PrefetchAllowed' | 'PrefetchFailedIneligibleRedirect' | 'PrefetchFailedInvalidRedirect' | 'PrefetchFailedMIMENotSupported' | 'PrefetchFailedNetError' | 'PrefetchFailedNon2XX' | 'PrefetchEvictedAfterBrowsingDataRemoved' | 'PrefetchEvictedAfterCandidateRemoved' | 'PrefetchEvictedForNewerPrefetch' | 'PrefetchHeldback' | 'PrefetchIneligibleRetryAfter' | 'PrefetchIsPrivacyDecoy' | 'PrefetchIsStale' | 'PrefetchNotEligibleBrowserContextOffTheRecord' | 'PrefetchNotEligibleDataSaverEnabled' | 'PrefetchNotEligibleExistingProxy' | 'PrefetchNotEligibleHostIsNonUnique' | 'PrefetchNotEligibleNonDefaultStoragePartition' | 'PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy' | 'PrefetchNotEligibleSchemeIsNotHttps' | 'PrefetchNotEligibleUserHasCookies' | 'PrefetchNotEligibleUserHasServiceWorker' | 'PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler' | 'PrefetchNotEligibleRedirectFromServiceWorker' | 'PrefetchNotEligibleRedirectToServiceWorker' | 'PrefetchNotEligibleBatterySaverEnabled' | 'PrefetchNotEligiblePreloadingDisabled' | 'PrefetchNotFinishedInTime' | 'PrefetchNotStarted' | 'PrefetchNotUsedCookiesChanged' | 'PrefetchProxyNotAvailable' | 'PrefetchResponseUsed' | 'PrefetchSuccessfulButNotUsed' | 'PrefetchNotUsedProbeFailed');
+        export type PrefetchStatus = ('PrefetchAllowed' | 'PrefetchFailedIneligibleRedirect' | 'PrefetchFailedInvalidRedirect' | 'PrefetchFailedMIMENotSupported' | 'PrefetchFailedNetError' | 'PrefetchFailedNon2XX' | 'PrefetchEvictedAfterBrowsingDataRemoved' | 'PrefetchEvictedAfterCandidateRemoved' | 'PrefetchEvictedForNewerPrefetch' | 'PrefetchHeldback' | 'PrefetchIneligibleRetryAfter' | 'PrefetchIsPrivacyDecoy' | 'PrefetchIsStale' | 'PrefetchNotEligibleBrowserContextOffTheRecord' | 'PrefetchNotEligibleDataSaverEnabled' | 'PrefetchNotEligibleExistingProxy' | 'PrefetchNotEligibleHostIsNonUnique' | 'PrefetchNotEligibleNonDefaultStoragePartition' | 'PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy' | 'PrefetchNotEligibleSchemeIsNotHttps' | 'PrefetchNotEligibleUserHasCookies' | 'PrefetchNotEligibleUserHasServiceWorker' | 'PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler' | 'PrefetchNotEligibleRedirectFromServiceWorker' | 'PrefetchNotEligibleRedirectToServiceWorker' | 'PrefetchNotEligibleBatterySaverEnabled' | 'PrefetchNotEligiblePreloadingDisabled' | 'PrefetchNotFinishedInTime' | 'PrefetchNotStarted' | 'PrefetchNotUsedCookiesChanged' | 'PrefetchProxyNotAvailable' | 'PrefetchResponseUsed' | 'PrefetchSuccessfulButNotUsed' | 'PrefetchNotUsedProbeFailed' | 'PrefetchCancelledOnUserNavigation');
 
         /**
          * Information of headers to be displayed when the header mismatch occurred.
@@ -21166,8 +21210,8 @@ export namespace Protocol {
             targetId: TargetID;
             /**
              * The id of the panel we want DevTools to open initially. Currently
-             * supported panels are elements, console, network, sources, resources
-             * and performance.
+             * supported panels are elements, console, network, sources, resources,
+             * timeline, chrome-recorder, heap-profiler, lighthouse, and security.
              */
             panelId?: string;
         }