devtools-protocol 0.0.1707781 → 0.0.1710668

package/json/browser_protocol.json

@@ -5990,6 +5990,23 @@
                         }
                     ]
                 },
+                {
+                    "name": "forcePositionTryOption",
+                    "description": "Forces a position-try option for the given node.",
+                    "parameters": [
+                        {
+                            "name": "nodeId",
+                            "description": "The element id for which to force the position-try option.",
+                            "$ref": "DOM.NodeId"
+                        },
+                        {
+                            "name": "index",
+                            "description": "The 1-based index of the position-try fallback option, 0 for base position (no fallback),\nor omitted to clear the forced state.",
+                            "optional": true,
+                            "type": "integer"
+                        }
+                    ]
+                },
                 {
                     "name": "getBackgroundColors",
                     "parameters": [

package/json/js_protocol.json

@@ -282,11 +282,15 @@
                             "$ref": "Location"
                         },
                         {
-                            "name": "empty",
-                            "description": "True if the scope does not declare any variables.\nOnly present if true.\nEmpty scopes are retained in the scope chain because\nthey can be targeted via `evaluateOnCallFrame` (using `scopeNumber`) or\nmatched against scopes in source maps.",
+                            "name": "emptyReason",
+                            "description": "Present if the scope has no variable values to show. Absent means that\nthe scope declares at least one variable with an available value.\nEmpty scopes are retained in the scope chain because\nthey can be targeted via `evaluateOnCallFrame` (using `scopeNumber`) or\nmatched against scopes in source maps.",
                             "experimental": true,
                             "optional": true,
-                            "type": "boolean"
+                            "type": "string",
+                            "enum": [
+                                "no-variables",
+                                "all-unavailable"
+                            ]
                         }
                     ]
                 },

package/package.json

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

package/pdl/domains/CSS.pdl

@@ -712,6 +712,15 @@ experimental domain CSS
       # Boolean indicating if this is on or off.
       boolean forced
 
+  # Forces a position-try option for the given node.
+  command forcePositionTryOption
+    parameters
+      # The element id for which to force the position-try option.
+      DOM.NodeId nodeId
+      # The 1-based index of the position-try fallback option, 0 for base position (no fallback),
+      # or omitted to clear the forced state.
+      optional integer index
+
   command getBackgroundColors
     parameters
       # Id of the node to get background colors for.

package/pdl/js_protocol.pdl

@@ -143,12 +143,17 @@ domain Debugger
       optional Location startLocation
       # Location in the source code where scope ends
       optional Location endLocation
-      # True if the scope does not declare any variables.
-      # Only present if true.
+      # Present if the scope has no variable values to show. Absent means that
+      # the scope declares at least one variable with an available value.
       # Empty scopes are retained in the scope chain because
       # they can be targeted via `evaluateOnCallFrame` (using `scopeNumber`) or
       # matched against scopes in source maps.
-      experimental optional boolean empty
+      experimental optional enum emptyReason
+        # The scope does not declare any variables.
+        no-variables
+        # The scope declares variables, but none of their values are available
+        # (e.g. because they were optimized out or are in their TDZ).
+        all-unavailable
 
   # Search match for resource.
   type SearchMatch extends object

package/types/protocol-mapping.d.ts

@@ -2270,6 +2270,13 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.CSS.ForceStartingStyleRequest];
             returnType: void;
         };
+        /**
+         * Forces a position-try option for the given node.
+         */
+        'CSS.forcePositionTryOption': {
+            paramsType: [Protocol.CSS.ForcePositionTryOptionRequest];
+            returnType: void;
+        };
         'CSS.getBackgroundColors': {
             paramsType: [Protocol.CSS.GetBackgroundColorsRequest];
             returnType: Protocol.CSS.GetBackgroundColorsResponse;

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

@@ -1239,6 +1239,11 @@ export namespace ProtocolProxyApi {
          */
         forceStartingStyle(params: Protocol.CSS.ForceStartingStyleRequest): Promise<void>;
 
+        /**
+         * Forces a position-try option for the given node.
+         */
+        forcePositionTryOption(params: Protocol.CSS.ForcePositionTryOptionRequest): Promise<void>;
+
         getBackgroundColors(params: Protocol.CSS.GetBackgroundColorsRequest): Promise<Protocol.CSS.GetBackgroundColorsResponse>;
 
         /**

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

@@ -1313,6 +1313,11 @@ export namespace ProtocolTestsProxyApi {
          */
         forceStartingStyle(params: Protocol.CSS.ForceStartingStyleRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Forces a position-try option for the given node.
+         */
+        forcePositionTryOption(params: Protocol.CSS.ForcePositionTryOptionRequest): Promise<{id: number, result: void, sessionId: string}>;
+
         getBackgroundColors(params: Protocol.CSS.GetBackgroundColorsRequest): Promise<{id: number, result: Protocol.CSS.GetBackgroundColorsResponse, sessionId: string}>;
 
         /**

package/types/protocol.d.ts

@@ -199,6 +199,11 @@ export namespace Protocol {
             WasmExpressionStack = 'wasm-expression-stack',
         }
 
+        export const enum ScopeEmptyReason {
+            NoVariables = 'no-variables',
+            AllUnavailable = 'all-unavailable',
+        }
+
         /**
          * Scope description.
          */
@@ -223,14 +228,14 @@ export namespace Protocol {
              */
             endLocation?: Location;
             /**
-             * True if the scope does not declare any variables.
-             * Only present if true.
+             * Present if the scope has no variable values to show. Absent means that
+             * the scope declares at least one variable with an available value.
              * Empty scopes are retained in the scope chain because
              * they can be targeted via `evaluateOnCallFrame` (using `scopeNumber`) or
              * matched against scopes in source maps.
              * @experimental
              */
-            empty?: boolean;
+            emptyReason?: ('no-variables' | 'all-unavailable');
         }
 
         /**
@@ -6341,6 +6346,18 @@ export namespace Protocol {
             forced: boolean;
         }
 
+        export interface ForcePositionTryOptionRequest {
+            /**
+             * The element id for which to force the position-try option.
+             */
+            nodeId: DOM.NodeId;
+            /**
+             * The 1-based index of the position-try fallback option, 0 for base position (no fallback),
+             * or omitted to clear the forced state.
+             */
+            index?: integer;
+        }
+
         export interface GetBackgroundColorsRequest {
             /**
              * Id of the node to get background colors for.