Roll protocol to r1443917

Author: devtools-bot

changelog.md

@@ -1,7 +1,38 @@
 
 
+## Roll protocol to r1443917 — _2025-04-08T04:30:16.000Z_
+######  Diff: [`cbcb4a1...b097869`](https://github.com/ChromeDevTools/devtools-protocol/compare/cbcb4a1...b097869)
+
+```diff
+@@ browser_protocol.pdl:8453 @@ domain Page
+       cross-origin-isolated
+       deferred-fetch
+       deferred-fetch-minimal
++      device-attributes
+       digital-credentials-get
+       direct-sockets
+       direct-sockets-private
+@@ -11642,11 +11643,14 @@ domain Target
+       # Deprecated.
+       deprecated optional TargetID targetId
+ 
+-  # Controls whether to automatically attach to new targets which are considered to be related to
+-  # this one. When turned on, attaches to all existing related targets as well. When turned off,
++  # Controls whether to automatically attach to new targets which are considered
++  # to be directly related to this one (for example, iframes or workers).
++  # When turned on, attaches to all existing related targets as well. When turned off,
+   # automatically detaches from all currently attached targets.
+   # This also clears all targets added by `autoAttachRelated` from the list of targets to watch
+   # for creation of related targets.
++  # You might want to call this recursively for auto-attached targets to attach
++  # to all available targets.
+   command setAutoAttach
+     parameters
+       # Whether to auto-attach to related targets.
+```
+
 ## Roll protocol to r1443047 — _2025-04-05T04:29:44.000Z_
-######  Diff: [`280d28f...d06be5f`](https://github.com/ChromeDevTools/devtools-protocol/compare/280d28f...d06be5f)
+######  Diff: [`280d28f...cbcb4a1`](https://github.com/ChromeDevTools/devtools-protocol/compare/280d28f...cbcb4a1)
 
 ```diff
 @@ browser_protocol.pdl:13339 @@ experimental domain BluetoothEmulation
@@ -13589,26 +13620,4 @@ index 8e43695..7fd51df 100644
 
    # Whether the request complied with Certificate Transparency policy.
    type CertificateTransparencyCompliance extends string
-```
-
-## Roll protocol to r1025007 — _2022-07-16T04:32:11.000Z_
-######  Diff: [`a7636c9...7263e11`](https://github.com/ChromeDevTools/devtools-protocol/compare/a7636c9...7263e11)
-
-```diff
-@@ browser_protocol.pdl:754 @@ experimental domain Audits
-       DeprecationExample
-       DocumentDomainSettingWithoutOriginAgentClusterHeader
-       EventPath
-+      ExpectCTHeader
-       GeolocationInsecureOrigin
-       GeolocationInsecureOriginDeprecatedNotRemoved
-       GetUserMediaInsecureOrigin
-@@ -4875,6 +4876,7 @@ domain Network
-       TextTrack
-       XHR
-       Fetch
-+      Prefetch
-       EventSource
-       WebSocket
-       Manifest
 ```

json/browser_protocol.json

@@ -17900,6 +17900,7 @@
                         "cross-origin-isolated",
                         "deferred-fetch",
                         "deferred-fetch-minimal",
+                        "device-attributes",
                         "digital-credentials-get",
                         "direct-sockets",
                         "direct-sockets-private",
@@ -24742,7 +24743,7 @@
                 },
                 {
                     "name": "setAutoAttach",
-                    "description": "Controls whether to automatically attach to new targets which are considered to be related to\nthis one. When turned on, attaches to all existing related targets as well. When turned off,\nautomatically detaches from all currently attached targets.\nThis also clears all targets added by `autoAttachRelated` from the list of targets to watch\nfor creation of related targets.",
+                    "description": "Controls whether to automatically attach to new targets which are considered\nto be directly related to this one (for example, iframes or workers).\nWhen turned on, attaches to all existing related targets as well. When turned off,\nautomatically detaches from all currently attached targets.\nThis also clears all targets added by `autoAttachRelated` from the list of targets to watch\nfor creation of related targets.\nYou might want to call this recursively for auto-attached targets to attach\nto all available targets.",
                     "parameters": [
                         {
                             "name": "autoAttach",

package.json

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

pdl/browser_protocol.pdl

@@ -8453,6 +8453,7 @@ domain Page
       cross-origin-isolated
       deferred-fetch
       deferred-fetch-minimal
+      device-attributes
       digital-credentials-get
       direct-sockets
       direct-sockets-private
@@ -11642,11 +11643,14 @@ domain Target
       # Deprecated.
       deprecated optional TargetID targetId
 
-  # Controls whether to automatically attach to new targets which are considered to be related to
-  # this one. When turned on, attaches to all existing related targets as well. When turned off,
+  # Controls whether to automatically attach to new targets which are considered
+  # to be directly related to this one (for example, iframes or workers).
+  # When turned on, attaches to all existing related targets as well. When turned off,
   # automatically detaches from all currently attached targets.
   # This also clears all targets added by `autoAttachRelated` from the list of targets to watch
   # for creation of related targets.
+  # You might want to call this recursively for auto-attached targets to attach
+  # to all available targets.
   command setAutoAttach
     parameters
       # Whether to auto-attach to related targets.

types/protocol-mapping.d.ts

@@ -4819,11 +4819,14 @@ export namespace ProtocolMapping {
             returnType: void;
         };
         /**
-         * Controls whether to automatically attach to new targets which are considered to be related to
-         * this one. When turned on, attaches to all existing related targets as well. When turned off,
+         * Controls whether to automatically attach to new targets which are considered
+         * to be directly related to this one (for example, iframes or workers).
+         * When turned on, attaches to all existing related targets as well. When turned off,
          * automatically detaches from all currently attached targets.
          * This also clears all targets added by `autoAttachRelated` from the list of targets to watch
          * for creation of related targets.
+         * You might want to call this recursively for auto-attached targets to attach
+         * to all available targets.
          */
         'Target.setAutoAttach': {
             paramsType: [Protocol.Target.SetAutoAttachRequest];

types/protocol-proxy-api.d.ts

@@ -3902,11 +3902,14 @@ export namespace ProtocolProxyApi {
         sendMessageToTarget(params: Protocol.Target.SendMessageToTargetRequest): Promise<void>;
 
         /**
-         * Controls whether to automatically attach to new targets which are considered to be related to
-         * this one. When turned on, attaches to all existing related targets as well. When turned off,
+         * Controls whether to automatically attach to new targets which are considered
+         * to be directly related to this one (for example, iframes or workers).
+         * When turned on, attaches to all existing related targets as well. When turned off,
          * automatically detaches from all currently attached targets.
          * This also clears all targets added by `autoAttachRelated` from the list of targets to watch
          * for creation of related targets.
+         * You might want to call this recursively for auto-attached targets to attach
+         * to all available targets.
          */
         setAutoAttach(params: Protocol.Target.SetAutoAttachRequest): Promise<void>;
 

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

@@ -4218,11 +4218,14 @@ export namespace ProtocolTestsProxyApi {
         sendMessageToTarget(params: Protocol.Target.SendMessageToTargetRequest): Promise<{id: number, result: void, sessionId: string}>;
 
         /**
-         * Controls whether to automatically attach to new targets which are considered to be related to
-         * this one. When turned on, attaches to all existing related targets as well. When turned off,
+         * Controls whether to automatically attach to new targets which are considered
+         * to be directly related to this one (for example, iframes or workers).
+         * When turned on, attaches to all existing related targets as well. When turned off,
          * automatically detaches from all currently attached targets.
          * This also clears all targets added by `autoAttachRelated` from the list of targets to watch
          * for creation of related targets.
+         * You might want to call this recursively for auto-attached targets to attach
+         * to all available targets.
          */
         setAutoAttach(params: Protocol.Target.SetAutoAttachRequest): Promise<{id: number, result: void, sessionId: string}>;
 

types/protocol.d.ts

@@ -13844,7 +13844,7 @@ export namespace Protocol {
          * All Permissions Policy features. This enum should match the one defined
          * in services/network/public/cpp/permissions_policy/permissions_policy_features.json5.
          */
-        export type PermissionsPolicyFeature = ('accelerometer' | 'all-screens-capture' | 'ambient-light-sensor' | 'attribution-reporting' | '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' | 'digital-credentials-get' | 'direct-sockets' | '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' | 'local-fonts' | 'magnetometer' | 'media-playback-while-not-visible' | 'microphone' | 'midi' | 'otp-credentials' | 'payment' | 'picture-in-picture' | 'popins' | 'private-aggregation' | 'private-state-token-issuance' | 'private-state-token-redemption' | 'publickey-credentials-create' | 'publickey-credentials-get' | 'rewriter' | 'run-ad-auction' | 'screen-wake-lock' | 'serial' | 'shared-autofill' | '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' | 'attribution-reporting' | '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-get' | 'direct-sockets' | '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' | 'local-fonts' | 'magnetometer' | 'media-playback-while-not-visible' | 'microphone' | 'midi' | 'otp-credentials' | 'payment' | 'picture-in-picture' | 'popins' | 'private-aggregation' | 'private-state-token-issuance' | 'private-state-token-redemption' | 'publickey-credentials-create' | 'publickey-credentials-get' | 'rewriter' | 'run-ad-auction' | 'screen-wake-lock' | 'serial' | 'shared-autofill' | '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.