devtools-protocol 0.0.856702 → 0.0.856957

package/changelog.md

@@ -1,5 +1,11 @@
 
 
+## Roll protocol to r856702
+###### _2021-02-23 08:16:10 -0800_ | Diff: [498a1e5...fe49497](https://github.com/ChromeDevTools/devtools-protocol/compare/498a1e5...fe49497)
+#### `Audits`: modified command
+* [`Audits.checkContrast`](https://chromedevtools.github.io/devtools-protocol/tot/Audits/#method-checkContrast)
+
+
 ## Roll protocol to r854822
 ###### _2021-02-17 09:16:17 -0800_ | Diff: [13b10d1...498a1e5](https://github.com/ChromeDevTools/devtools-protocol/compare/13b10d1...498a1e5)
 #### `Page`: new command

package/json/js_protocol.json

@@ -477,43 +477,6 @@
                         }
                     ]
                 },
-                {
-                    "name": "executeWasmEvaluator",
-                    "description": "Execute a Wasm Evaluator module on a given call frame.",
-                    "experimental": true,
-                    "parameters": [
-                        {
-                            "name": "callFrameId",
-                            "description": "WebAssembly call frame identifier to evaluate on.",
-                            "$ref": "CallFrameId"
-                        },
-                        {
-                            "name": "evaluator",
-                            "description": "Code of the evaluator module. (Encoded as a base64 string when passed over JSON)",
-                            "type": "string"
-                        },
-                        {
-                            "name": "timeout",
-                            "description": "Terminate execution after timing out (number of milliseconds).",
-                            "experimental": true,
-                            "optional": true,
-                            "$ref": "Runtime.TimeDelta"
-                        }
-                    ],
-                    "returns": [
-                        {
-                            "name": "result",
-                            "description": "Object wrapper for the evaluation result.",
-                            "$ref": "Runtime.RemoteObject"
-                        },
-                        {
-                            "name": "exceptionDetails",
-                            "description": "Exception details.",
-                            "optional": true,
-                            "$ref": "Runtime.ExceptionDetails"
-                        }
-                    ]
-                },
                 {
                     "name": "getPossibleBreakpoints",
                     "description": "Returns possible locations for breakpoint. scriptId in start and end range locations should be\nthe same.",
@@ -1108,6 +1071,7 @@
                             "enum": [
                                 "ambiguous",
                                 "assert",
+                                "CSPViolation",
                                 "debugCommand",
                                 "DOM",
                                 "EventListener",
@@ -2236,13 +2200,12 @@
                                 "number",
                                 "boolean",
                                 "symbol",
-                                "bigint",
-                                "wasm"
+                                "bigint"
                             ]
                         },
                         {
                             "name": "subtype",
-                            "description": "Object subtype hint. Specified for `object` or `wasm` type values only.",
+                            "description": "Object subtype hint. Specified for `object` type values only.\nNOTE: If you change anything here, make sure to also update\n`subtype` in `ObjectPreview` and `PropertyPreview` below.",
                             "optional": true,
                             "type": "string",
                             "enum": [
@@ -2263,12 +2226,8 @@
                                 "typedarray",
                                 "arraybuffer",
                                 "dataview",
-                                "i32",
-                                "i64",
-                                "f32",
-                                "f64",
-                                "v128",
-                                "externref"
+                                "webassemblymemory",
+                                "wasmvalue"
                             ]
                         },
                         {
@@ -2372,7 +2331,14 @@
                                 "weakset",
                                 "iterator",
                                 "generator",
-                                "error"
+                                "error",
+                                "proxy",
+                                "promise",
+                                "typedarray",
+                                "arraybuffer",
+                                "dataview",
+                                "webassemblymemory",
+                                "wasmvalue"
                             ]
                         },
                         {
@@ -2460,7 +2426,14 @@
                                 "weakset",
                                 "iterator",
                                 "generator",
-                                "error"
+                                "error",
+                                "proxy",
+                                "promise",
+                                "typedarray",
+                                "arraybuffer",
+                                "dataview",
+                                "webassemblymemory",
+                                "wasmvalue"
                             ]
                         }
                     ]
@@ -2646,6 +2619,12 @@
                             "description": "Human readable name describing given context.",
                             "type": "string"
                         },
+                        {
+                            "name": "uniqueId",
+                            "description": "A system-unique execution context identifier. Unlike the id, this is unique accross\nmultiple processes, so can be reliably used to identify specific context while backend\nperforms a cross-process navigation.",
+                            "experimental": true,
+                            "type": "string"
+                        },
                         {
                             "name": "auxData",
                             "description": "Embedder-specific auxiliary data.",
@@ -3012,7 +2991,7 @@
                         },
                         {
                             "name": "contextId",
-                            "description": "Specifies in which execution context to perform evaluation. If the parameter is omitted the\nevaluation will be performed in the context of the inspected page.",
+                            "description": "Specifies in which execution context to perform evaluation. If the parameter is omitted the\nevaluation will be performed in the context of the inspected page.\nThis is mutually exclusive with `uniqueContextId`, which offers an\nalternative way to identify the execution context that is more reliable\nin a multi-process environment.",
                             "optional": true,
                             "$ref": "ExecutionContextId"
                         },
@@ -3075,6 +3054,13 @@
                             "experimental": true,
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "uniqueContextId",
+                            "description": "An alternative way to specify the execution context to evaluate in.\nCompared to contextId that may be reused accross processes, this is guaranteed to be\nsystem-unique, so it can be used to prevent accidental evaluation of the expression\nin context different than intended (e.g. as a result of navigation accross process\nboundaries).\nThis is mutually exclusive with `contextId`.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "string"
                         }
                     ],
                     "returns": [
@@ -3361,7 +3347,7 @@
                 },
                 {
                     "name": "addBinding",
-                    "description": "If executionContextId is empty, adds binding with the given name on the\nglobal objects of all inspected contexts, including those created later,\nbindings survive reloads.\nIf executionContextId is specified, adds binding only on global object of\ngiven execution context.\nBinding function takes exactly one argument, this argument should be string,\nin case of any other input, function throws an exception.\nEach binding function call produces Runtime.bindingCalled notification.",
+                    "description": "If executionContextId is empty, adds binding with the given name on the\nglobal objects of all inspected contexts, including those created later,\nbindings survive reloads.\nBinding function takes exactly one argument, this argument should be string,\nin case of any other input, function throws an exception.\nEach binding function call produces Runtime.bindingCalled notification.",
                     "experimental": true,
                     "parameters": [
                         {
@@ -3370,8 +3356,16 @@
                         },
                         {
                             "name": "executionContextId",
+                            "description": "If specified, the binding would only be exposed to the specified\nexecution context. If omitted and `executionContextName` is not set,\nthe binding is exposed to all execution contexts of the target.\nThis parameter is mutually exclusive with `executionContextName`.",
                             "optional": true,
                             "$ref": "ExecutionContextId"
+                        },
+                        {
+                            "name": "executionContextName",
+                            "description": "If specified, the binding is exposed to the executionContext with\nmatching name, even for contexts created after the binding is added.\nSee also `ExecutionContext.name` and `worldName` parameter to\n`Page.addScriptToEvaluateOnNewDocument`.\nThis parameter is mutually exclusive with `executionContextId`.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "string"
                         }
                     ]
                 },

package/package.json

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

package/pdl/js_protocol.pdl

@@ -211,21 +211,6 @@ domain Debugger
       # Exception details.
       optional Runtime.ExceptionDetails exceptionDetails
 
-  # Execute a Wasm Evaluator module on a given call frame.
-  experimental command executeWasmEvaluator
-    parameters
-      # WebAssembly call frame identifier to evaluate on.
-      CallFrameId callFrameId
-      # Code of the evaluator module.
-      binary evaluator
-      # Terminate execution after timing out (number of milliseconds).
-      experimental optional Runtime.TimeDelta timeout
-    returns
-      # Object wrapper for the evaluation result.
-      Runtime.RemoteObject result
-      # Exception details.
-      optional Runtime.ExceptionDetails exceptionDetails
-
   # Returns possible locations for breakpoint. scriptId in start and end range locations should be
   # the same.
   command getPossibleBreakpoints
@@ -508,6 +493,7 @@ domain Debugger
       enum reason
         ambiguous
         assert
+        CSPViolation
         debugCommand
         DOM
         EventListener
@@ -1022,8 +1008,9 @@ domain Runtime
         boolean
         symbol
         bigint
-        wasm
-      # Object subtype hint. Specified for `object` or `wasm` type values only.
+      # Object subtype hint. Specified for `object` type values only.
+      # NOTE: If you change anything here, make sure to also update
+      # `subtype` in `ObjectPreview` and `PropertyPreview` below.
       optional enum subtype
         array
         null
@@ -1042,12 +1029,8 @@ domain Runtime
         typedarray
         arraybuffer
         dataview
-        i32
-        i64
-        f32
-        f64
-        v128
-        externref
+        webassemblymemory
+        wasmvalue
       # Object class (constructor) name. Specified for `object` type values only.
       optional string className
       # Remote object value in case of primitive values or JSON values (if it was requested).
@@ -1100,6 +1083,13 @@ domain Runtime
         iterator
         generator
         error
+        proxy
+        promise
+        typedarray
+        arraybuffer
+        dataview
+        webassemblymemory
+        wasmvalue
       # String representation of the object.
       optional string description
       # True iff some of the properties or entries of the original object did not fit.
@@ -1142,6 +1132,13 @@ domain Runtime
         iterator
         generator
         error
+        proxy
+        promise
+        typedarray
+        arraybuffer
+        dataview
+        webassemblymemory
+        wasmvalue
 
   experimental type EntryPreview extends object
     properties
@@ -1224,6 +1221,10 @@ domain Runtime
       string origin
       # Human readable name describing given context.
       string name
+      # A system-unique execution context identifier. Unlike the id, this is unique accross
+      # multiple processes, so can be reliably used to identify specific context while backend
+      # performs a cross-process navigation.
+      experimental string uniqueId
       # Embedder-specific auxiliary data.
       optional object auxData
 
@@ -1387,6 +1388,9 @@ domain Runtime
       optional boolean silent
       # Specifies in which execution context to perform evaluation. If the parameter is omitted the
       # evaluation will be performed in the context of the inspected page.
+      # This is mutually exclusive with `uniqueContextId`, which offers an
+      # alternative way to identify the execution context that is more reliable
+      # in a multi-process environment.
       optional ExecutionContextId contextId
       # Whether the result is expected to be a JSON object that should be sent by value.
       optional boolean returnByValue
@@ -1413,6 +1417,13 @@ domain Runtime
       # when called with non-callable arguments. This flag bypasses CSP for this
       # evaluation and allows unsafe-eval. Defaults to true.
       experimental optional boolean allowUnsafeEvalBlockedByCSP
+      # An alternative way to specify the execution context to evaluate in.
+      # Compared to contextId that may be reused accross processes, this is guaranteed to be
+      # system-unique, so it can be used to prevent accidental evaluation of the expression
+      # in context different than intended (e.g. as a result of navigation accross process
+      # boundaries).
+      # This is mutually exclusive with `contextId`.
+      experimental optional string uniqueContextId
     returns
       # Evaluation result.
       RemoteObject result
@@ -1542,15 +1553,23 @@ domain Runtime
   # If executionContextId is empty, adds binding with the given name on the
   # global objects of all inspected contexts, including those created later,
   # bindings survive reloads.
-  # If executionContextId is specified, adds binding only on global object of
-  # given execution context.
   # Binding function takes exactly one argument, this argument should be string,
   # in case of any other input, function throws an exception.
   # Each binding function call produces Runtime.bindingCalled notification.
   experimental command addBinding
     parameters
       string name
+      # If specified, the binding would only be exposed to the specified
+      # execution context. If omitted and `executionContextName` is not set,
+      # the binding is exposed to all execution contexts of the target.
+      # This parameter is mutually exclusive with `executionContextName`.
       optional ExecutionContextId executionContextId
+      # If specified, the binding is exposed to the executionContext with
+      # matching name, even for contexts created after the binding is added.
+      # See also `ExecutionContext.name` and `worldName` parameter to
+      # `Page.addScriptToEvaluateOnNewDocument`.
+      # This parameter is mutually exclusive with `executionContextId`.
+      experimental optional string executionContextName
 
   # This method does not remove binding function from global object but
   # unsubscribes current runtime agent from Runtime.bindingCalled notifications.

package/types/protocol-mapping.d.ts

@@ -685,13 +685,6 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Debugger.EvaluateOnCallFrameRequest];
             returnType: Protocol.Debugger.EvaluateOnCallFrameResponse;
         };
-        /**
-         * Execute a Wasm Evaluator module on a given call frame.
-         */
-        'Debugger.executeWasmEvaluator': {
-            paramsType: [Protocol.Debugger.ExecuteWasmEvaluatorRequest];
-            returnType: Protocol.Debugger.ExecuteWasmEvaluatorResponse;
-        };
         /**
          * Returns possible locations for breakpoint. scriptId in start and end range locations should be
          * the same.
@@ -1196,8 +1189,6 @@ export namespace ProtocolMapping {
          * If executionContextId is empty, adds binding with the given name on the
          * global objects of all inspected contexts, including those created later,
          * bindings survive reloads.
-         * If executionContextId is specified, adds binding only on global object of
-         * given execution context.
          * Binding function takes exactly one argument, this argument should be string,
          * in case of any other input, function throws an exception.
          * Each binding function call produces Runtime.bindingCalled notification.

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

@@ -151,11 +151,6 @@ export namespace ProtocolProxyApi {
          */
         evaluateOnCallFrame(params: Protocol.Debugger.EvaluateOnCallFrameRequest): Promise<Protocol.Debugger.EvaluateOnCallFrameResponse>;
 
-        /**
-         * Execute a Wasm Evaluator module on a given call frame.
-         */
-        executeWasmEvaluator(params: Protocol.Debugger.ExecuteWasmEvaluatorRequest): Promise<Protocol.Debugger.ExecuteWasmEvaluatorResponse>;
-
         /**
          * Returns possible locations for breakpoint. scriptId in start and end range locations should be
          * the same.
@@ -576,8 +571,6 @@ export namespace ProtocolProxyApi {
          * If executionContextId is empty, adds binding with the given name on the
          * global objects of all inspected contexts, including those created later,
          * bindings survive reloads.
-         * If executionContextId is specified, adds binding only on global object of
-         * given execution context.
          * Binding function takes exactly one argument, this argument should be string,
          * in case of any other input, function throws an exception.
          * Each binding function call produces Runtime.bindingCalled notification.

package/types/protocol.d.ts

@@ -354,32 +354,6 @@ export namespace Protocol {
             exceptionDetails?: Runtime.ExceptionDetails;
         }
 
-        export interface ExecuteWasmEvaluatorRequest {
-            /**
-             * WebAssembly call frame identifier to evaluate on.
-             */
-            callFrameId: CallFrameId;
-            /**
-             * Code of the evaluator module. (Encoded as a base64 string when passed over JSON)
-             */
-            evaluator: string;
-            /**
-             * Terminate execution after timing out (number of milliseconds).
-             */
-            timeout?: Runtime.TimeDelta;
-        }
-
-        export interface ExecuteWasmEvaluatorResponse {
-            /**
-             * Object wrapper for the evaluation result.
-             */
-            result: Runtime.RemoteObject;
-            /**
-             * Exception details.
-             */
-            exceptionDetails?: Runtime.ExceptionDetails;
-        }
-
         export interface GetPossibleBreakpointsRequest {
             /**
              * Start of range to search possible breakpoint locations in.
@@ -766,6 +740,7 @@ export namespace Protocol {
         export const enum PausedEventReason {
             Ambiguous = 'ambiguous',
             Assert = 'assert',
+            CSPViolation = 'CSPViolation',
             DebugCommand = 'debugCommand',
             DOM = 'DOM',
             EventListener = 'EventListener',
@@ -788,7 +763,7 @@ export namespace Protocol {
             /**
              * Pause reason. (PausedEventReason enum)
              */
-            reason: ('ambiguous' | 'assert' | 'debugCommand' | 'DOM' | 'EventListener' | 'exception' | 'instrumentation' | 'OOM' | 'other' | 'promiseRejection' | 'XHR');
+            reason: ('ambiguous' | 'assert' | 'CSPViolation' | 'debugCommand' | 'DOM' | 'EventListener' | 'exception' | 'instrumentation' | 'OOM' | 'other' | 'promiseRejection' | 'XHR');
             /**
              * Object containing break-specific auxiliary properties.
              */
@@ -1501,7 +1476,6 @@ export namespace Protocol {
             Boolean = 'boolean',
             Symbol = 'symbol',
             Bigint = 'bigint',
-            Wasm = 'wasm',
         }
 
         export const enum RemoteObjectSubtype {
@@ -1522,12 +1496,8 @@ export namespace Protocol {
             Typedarray = 'typedarray',
             Arraybuffer = 'arraybuffer',
             Dataview = 'dataview',
-            I32 = 'i32',
-            I64 = 'i64',
-            F32 = 'f32',
-            F64 = 'f64',
-            V128 = 'v128',
-            Externref = 'externref',
+            Webassemblymemory = 'webassemblymemory',
+            Wasmvalue = 'wasmvalue',
         }
 
         /**
@@ -1537,11 +1507,13 @@ export namespace Protocol {
             /**
              * Object type. (RemoteObjectType enum)
              */
-            type: ('object' | 'function' | 'undefined' | 'string' | 'number' | 'boolean' | 'symbol' | 'bigint' | 'wasm');
+            type: ('object' | 'function' | 'undefined' | 'string' | 'number' | 'boolean' | 'symbol' | 'bigint');
             /**
-             * Object subtype hint. Specified for `object` or `wasm` type values only. (RemoteObjectSubtype enum)
+             * Object subtype hint. Specified for `object` type values only.
+             * NOTE: If you change anything here, make sure to also update
+             * `subtype` in `ObjectPreview` and `PropertyPreview` below. (RemoteObjectSubtype enum)
              */
-            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error' | 'proxy' | 'promise' | 'typedarray' | 'arraybuffer' | 'dataview' | 'i32' | 'i64' | 'f32' | 'f64' | 'v128' | 'externref');
+            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error' | 'proxy' | 'promise' | 'typedarray' | 'arraybuffer' | 'dataview' | 'webassemblymemory' | 'wasmvalue');
             /**
              * Object class (constructor) name. Specified for `object` type values only.
              */
@@ -1608,6 +1580,13 @@ export namespace Protocol {
             Iterator = 'iterator',
             Generator = 'generator',
             Error = 'error',
+            Proxy = 'proxy',
+            Promise = 'promise',
+            Typedarray = 'typedarray',
+            Arraybuffer = 'arraybuffer',
+            Dataview = 'dataview',
+            Webassemblymemory = 'webassemblymemory',
+            Wasmvalue = 'wasmvalue',
         }
 
         /**
@@ -1621,7 +1600,7 @@ export namespace Protocol {
             /**
              * Object subtype hint. Specified for `object` type values only. (ObjectPreviewSubtype enum)
              */
-            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error');
+            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error' | 'proxy' | 'promise' | 'typedarray' | 'arraybuffer' | 'dataview' | 'webassemblymemory' | 'wasmvalue');
             /**
              * String representation of the object.
              */
@@ -1665,6 +1644,13 @@ export namespace Protocol {
             Iterator = 'iterator',
             Generator = 'generator',
             Error = 'error',
+            Proxy = 'proxy',
+            Promise = 'promise',
+            Typedarray = 'typedarray',
+            Arraybuffer = 'arraybuffer',
+            Dataview = 'dataview',
+            Webassemblymemory = 'webassemblymemory',
+            Wasmvalue = 'wasmvalue',
         }
 
         export interface PropertyPreview {
@@ -1687,7 +1673,7 @@ export namespace Protocol {
             /**
              * Object subtype hint. Specified for `object` type values only. (PropertyPreviewSubtype enum)
              */
-            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error');
+            subtype?: ('array' | 'null' | 'node' | 'regexp' | 'date' | 'map' | 'set' | 'weakmap' | 'weakset' | 'iterator' | 'generator' | 'error' | 'proxy' | 'promise' | 'typedarray' | 'arraybuffer' | 'dataview' | 'webassemblymemory' | 'wasmvalue');
         }
 
         export interface EntryPreview {
@@ -1830,6 +1816,12 @@ export namespace Protocol {
              * Human readable name describing given context.
              */
             name: string;
+            /**
+             * A system-unique execution context identifier. Unlike the id, this is unique accross
+             * multiple processes, so can be reliably used to identify specific context while backend
+             * performs a cross-process navigation.
+             */
+            uniqueId: string;
             /**
              * Embedder-specific auxiliary data.
              */
@@ -2090,6 +2082,9 @@ export namespace Protocol {
             /**
              * Specifies in which execution context to perform evaluation. If the parameter is omitted the
              * evaluation will be performed in the context of the inspected page.
+             * This is mutually exclusive with `uniqueContextId`, which offers an
+             * alternative way to identify the execution context that is more reliable
+             * in a multi-process environment.
              */
             contextId?: ExecutionContextId;
             /**
@@ -2135,6 +2130,15 @@ export namespace Protocol {
              * evaluation and allows unsafe-eval. Defaults to true.
              */
             allowUnsafeEvalBlockedByCSP?: boolean;
+            /**
+             * An alternative way to specify the execution context to evaluate in.
+             * Compared to contextId that may be reused accross processes, this is guaranteed to be
+             * system-unique, so it can be used to prevent accidental evaluation of the expression
+             * in context different than intended (e.g. as a result of navigation accross process
+             * boundaries).
+             * This is mutually exclusive with `contextId`.
+             */
+            uniqueContextId?: string;
         }
 
         export interface EvaluateResponse {
@@ -2316,7 +2320,21 @@ export namespace Protocol {
 
         export interface AddBindingRequest {
             name: string;
+            /**
+             * If specified, the binding would only be exposed to the specified
+             * execution context. If omitted and `executionContextName` is not set,
+             * the binding is exposed to all execution contexts of the target.
+             * This parameter is mutually exclusive with `executionContextName`.
+             */
             executionContextId?: ExecutionContextId;
+            /**
+             * If specified, the binding is exposed to the executionContext with
+             * matching name, even for contexts created after the binding is added.
+             * See also `ExecutionContext.name` and `worldName` parameter to
+             * `Page.addScriptToEvaluateOnNewDocument`.
+             * This parameter is mutually exclusive with `executionContextId`.
+             */
+            executionContextName?: string;
         }
 
         export interface RemoveBindingRequest {