Roll protocol to r1574117

Author: devtools-bot

changelog.md

@@ -1,7 +1,41 @@
 
 
+## Roll protocol to r1574117 — _2026-01-24T04:34:09.000Z_
+######  Diff: [`878c563...9848d8a`](https://github.com/ChromeDevTools/devtools-protocol/compare/878c563...9848d8a)
+
+```diff
+@@ domains/CSS.pdl:708 @@ experimental domain CSS
+   # to the provided property syntax, the value is parsed using combined
+   # syntax as if null `propertyName` was provided. If the value cannot be
+   # resolved even then, return the provided value without any changes.
++  # Note: this function currently does not resolve CSS random() function,
++  # it returns unmodified random() function parts.`
+   experimental command resolveValues
+     parameters
+       # Cascade-dependent keywords (revert/revert-layer) do not work.
+diff --git a/pdl/domains/Target.pdl b/pdl/domains/Target.pdl
+index 8d8ead63..e8380799 100644
+--- a/pdl/domains/Target.pdl
++++ b/pdl/domains/Target.pdl
+@@ -167,6 +167,14 @@ domain Target
+       # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
+       # `background: false`. The life-time of the tab is limited to the life-time of the session.
+       experimental optional boolean hidden
++      # If specified, the option is used to determine if the new target should
++      # be focused or not. By default, the focus behavior depends on the
++      # value of the background field. For example, background=false and focus=false
++      # will result in the target tab being opened but the browser window remain
++      # unchanged (if it was in the background, it will remain in the background)
++      # and background=false with focus=undefined will result in the window being focused.
++      # Using background: true and focus: true is not supported and will result in an error.
++      experimental optional boolean focus
+     returns
+       # The id of the page opened.
+       TargetID targetId
+```
+
 ## Roll protocol to r1573491 — _2026-01-23T04:35:32.000Z_
-######  Diff: [`9e24285...f9c7e21`](https://github.com/ChromeDevTools/devtools-protocol/compare/9e24285...f9c7e21)
+######  Diff: [`9e24285...878c563`](https://github.com/ChromeDevTools/devtools-protocol/compare/9e24285...878c563)
 
 ```diff
 @@ domains/Network.pdl:1812 @@ domain Network
@@ -42301,19 +42335,4 @@ index 0dbdc01d..7a3c772c 100644
        SourceAndTriggerHeaders
        SourceIgnored
        TriggerIgnored
-```
-
-## Roll protocol to r1129085 — _2023-04-12T04:26:50.000Z_
-######  Diff: [`22ae458...d7c1808`](https://github.com/ChromeDevTools/devtools-protocol/compare/22ae458...d7c1808)
-
-```diff
-@@ browser_protocol.pdl:708 @@ experimental domain Audits
-       InvalidHeader
-       InvalidRegisterTriggerHeader
-       InvalidEligibleHeader
-+      # TODO(crbug.com/1431942): Remove this issue once DevTools stops
-+      # referencing it
-       TooManyConcurrentRequests
-       SourceAndTriggerHeaders
-       SourceIgnored
 ```

json/browser_protocol.json

@@ -5664,7 +5664,7 @@
                 },
                 {
                     "name": "resolveValues",
-                    "description": "Resolve the specified values in the context of the provided element.\nFor example, a value of '1em' is evaluated according to the computed\n'font-size' of the element and a value 'calc(1px + 2px)' will be\nresolved to '3px'.\nIf the `propertyName` was specified the `values` are resolved as if\nthey were property's declaration. If a value cannot be parsed according\nto the provided property syntax, the value is parsed using combined\nsyntax as if null `propertyName` was provided. If the value cannot be\nresolved even then, return the provided value without any changes.",
+                    "description": "Resolve the specified values in the context of the provided element.\nFor example, a value of '1em' is evaluated according to the computed\n'font-size' of the element and a value 'calc(1px + 2px)' will be\nresolved to '3px'.\nIf the `propertyName` was specified the `values` are resolved as if\nthey were property's declaration. If a value cannot be parsed according\nto the provided property syntax, the value is parsed using combined\nsyntax as if null `propertyName` was provided. If the value cannot be\nresolved even then, return the provided value without any changes.\nNote: this function currently does not resolve CSS random() function,\nit returns unmodified random() function parts.`",
                     "experimental": true,
                     "parameters": [
                         {
@@ -28622,6 +28622,13 @@
                             "experimental": true,
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "focus",
+                            "description": "If specified, the option is used to determine if the new target should\nbe focused or not. By default, the focus behavior depends on the\nvalue of the background field. For example, background=false and focus=false\nwill result in the target tab being opened but the browser window remain\nunchanged (if it was in the background, it will remain in the background)\nand background=false with focus=undefined will result in the window being focused.\nUsing background: true and focus: true is not supported and will result in an error.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "boolean"
                         }
                     ],
                     "returns": [

package-lock.json

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

package.json

@@ -708,6 +708,8 @@ experimental domain CSS
   # to the provided property syntax, the value is parsed using combined
   # syntax as if null `propertyName` was provided. If the value cannot be
   # resolved even then, return the provided value without any changes.
+  # Note: this function currently does not resolve CSS random() function,
+  # it returns unmodified random() function parts.`
   experimental command resolveValues
     parameters
       # Cascade-dependent keywords (revert/revert-layer) do not work.

pdl/domains/CSS.pdl

@@ -167,6 +167,14 @@ domain Target
       # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
       # `background: false`. The life-time of the tab is limited to the life-time of the session.
       experimental optional boolean hidden
+      # If specified, the option is used to determine if the new target should
+      # be focused or not. By default, the focus behavior depends on the
+      # value of the background field. For example, background=false and focus=false
+      # will result in the target tab being opened but the browser window remain
+      # unchanged (if it was in the background, it will remain in the background)
+      # and background=false with focus=undefined will result in the window being focused.
+      # Using background: true and focus: true is not supported and will result in an error.
+      experimental optional boolean focus
     returns
       # The id of the page opened.
       TargetID targetId

pdl/domains/Target.pdl

@@ -2168,6 +2168,8 @@ export namespace ProtocolMapping {
          * to the provided property syntax, the value is parsed using combined
          * syntax as if null `propertyName` was provided. If the value cannot be
          * resolved even then, return the provided value without any changes.
+         * Note: this function currently does not resolve CSS random() function,
+         * it returns unmodified random() function parts.`
          * @experimental
          */
         'CSS.resolveValues': {

types/protocol-mapping.d.ts

@@ -1226,6 +1226,8 @@ export namespace ProtocolProxyApi {
          * to the provided property syntax, the value is parsed using combined
          * syntax as if null `propertyName` was provided. If the value cannot be
          * resolved even then, return the provided value without any changes.
+         * Note: this function currently does not resolve CSS random() function,
+         * it returns unmodified random() function parts.`
          * @experimental
          */
         resolveValues(params: Protocol.CSS.ResolveValuesRequest): Promise<Protocol.CSS.ResolveValuesResponse>;

types/protocol-proxy-api.d.ts

@@ -1300,6 +1300,8 @@ export namespace ProtocolTestsProxyApi {
          * to the provided property syntax, the value is parsed using combined
          * syntax as if null `propertyName` was provided. If the value cannot be
          * resolved even then, return the provided value without any changes.
+         * Note: this function currently does not resolve CSS random() function,
+         * it returns unmodified random() function parts.`
          * @experimental
          */
         resolveValues(params: Protocol.CSS.ResolveValuesRequest): Promise<{id: number, result: Protocol.CSS.ResolveValuesResponse, sessionId: string}>;

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

@@ -20646,6 +20646,17 @@ export namespace Protocol {
              * @experimental
              */
             hidden?: boolean;
+            /**
+             * If specified, the option is used to determine if the new target should
+             * be focused or not. By default, the focus behavior depends on the
+             * value of the background field. For example, background=false and focus=false
+             * will result in the target tab being opened but the browser window remain
+             * unchanged (if it was in the background, it will remain in the background)
+             * and background=false with focus=undefined will result in the window being focused.
+             * Using background: true and focus: true is not supported and will result in an error.
+             * @experimental
+             */
+            focus?: boolean;
         }
 
         export interface CreateTargetResponse {