devtools-protocol 0.0.933220 → 0.0.937072

package/json/browser_protocol.json

@@ -1479,6 +1479,28 @@
                         }
                     ]
                 },
+                {
+                    "id": "DeprecationIssueDetails",
+                    "description": "This issue tracks information needed to print a deprecation message.\nThe formatting is inherited from the old console.log version, see more at:\nhttps://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/deprecation.cc\nTODO(crbug.com/1264960): Re-work format to add i18n support per:\nhttps://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/public/devtools_protocol/README.md",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "affectedFrame",
+                            "optional": true,
+                            "$ref": "AffectedFrame"
+                        },
+                        {
+                            "name": "sourceCodeLocation",
+                            "$ref": "SourceCodeLocation"
+                        },
+                        {
+                            "name": "message",
+                            "description": "The content of the deprecation issue (this won't be translated),\ne.g. \"window.inefficientLegacyStorageMethod will be removed in M97,\naround January 2022. Please use Web Storage or Indexed Database\ninstead. This standard was abandoned in January, 1970. See\nhttps://www.chromestatus.com/feature/5684870116278272 for more details.\"",
+                            "optional": true,
+                            "type": "string"
+                        }
+                    ]
+                },
                 {
                     "id": "InspectorIssueCode",
                     "description": "A unique identifier for the type of issue. Each type may use one of the\noptional fields in InspectorIssueDetails to convey more specific\ninformation about the kind of issue.",
@@ -1497,7 +1519,8 @@
                         "QuirksModeIssue",
                         "NavigatorUserAgentIssue",
                         "WasmCrossOriginModuleSharingIssue",
-                        "GenericIssue"
+                        "GenericIssue",
+                        "DeprecationIssue"
                     ]
                 },
                 {
@@ -1574,6 +1597,11 @@
                             "name": "genericIssueDetails",
                             "optional": true,
                             "$ref": "GenericIssueDetails"
+                        },
+                        {
+                            "name": "deprecationIssueDetails",
+                            "optional": true,
+                            "$ref": "DeprecationIssueDetails"
                         }
                     ]
                 },
@@ -6068,6 +6096,35 @@
                 }
             ]
         },
+        {
+            "domain": "EventBreakpoints",
+            "description": "EventBreakpoints permits setting breakpoints on particular operations and\nevents in targets that run JavaScript but do not have a DOM.\nJavaScript execution will stop on these operations as if there was a regular\nbreakpoint set.",
+            "experimental": true,
+            "commands": [
+                {
+                    "name": "setInstrumentationBreakpoint",
+                    "description": "Sets breakpoint on particular native event.",
+                    "parameters": [
+                        {
+                            "name": "eventName",
+                            "description": "Instrumentation name to stop on.",
+                            "type": "string"
+                        }
+                    ]
+                },
+                {
+                    "name": "removeInstrumentationBreakpoint",
+                    "description": "Removes breakpoint on particular native event.",
+                    "parameters": [
+                        {
+                            "name": "eventName",
+                            "description": "Instrumentation name to stop on.",
+                            "type": "string"
+                        }
+                    ]
+                }
+            ]
+        },
         {
             "domain": "DOMSnapshot",
             "description": "This domain facilitates obtaining document snapshots with DOM, layout, and style information.",

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -709,6 +709,22 @@ experimental domain Audits
       GenericIssueErrorType errorType
       optional Page.FrameId frameId
 
+  # This issue tracks information needed to print a deprecation message.
+  # The formatting is inherited from the old console.log version, see more at:
+  # https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/deprecation.cc
+  # TODO(crbug.com/1264960): Re-work format to add i18n support per:
+  # https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/public/devtools_protocol/README.md
+  type DeprecationIssueDetails extends object
+    properties
+      optional AffectedFrame affectedFrame
+      SourceCodeLocation sourceCodeLocation
+      # The content of the deprecation issue (this won't be translated),
+      # e.g. "window.inefficientLegacyStorageMethod will be removed in M97,
+      # around January 2022. Please use Web Storage or Indexed Database
+      # instead. This standard was abandoned in January, 1970. See
+      # https://www.chromestatus.com/feature/5684870116278272 for more details."
+      optional string message
+
   # A unique identifier for the type of issue. Each type may use one of the
   # optional fields in InspectorIssueDetails to convey more specific
   # information about the kind of issue.
@@ -728,6 +744,7 @@ experimental domain Audits
       NavigatorUserAgentIssue
       WasmCrossOriginModuleSharingIssue
       GenericIssue
+      DeprecationIssue
 
   # This struct holds a list of optional fields with additional information
   # specific to the kind of issue. When adding a new issue code, please also
@@ -748,6 +765,7 @@ experimental domain Audits
       optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
       optional WasmCrossOriginModuleSharingIssueDetails wasmCrossOriginModuleSharingIssue
       optional GenericIssueDetails genericIssueDetails
+      optional DeprecationIssueDetails deprecationIssueDetails
 
   # A unique id for a DevTools inspector issue. Allows other entities (e.g.
   # exceptions, CDP message, console messages, etc.) to reference an issue.
@@ -2824,6 +2842,23 @@ domain DOMDebugger
       # Resource URL substring. All XHRs having this substring in the URL will get stopped upon.
       string url
 
+# EventBreakpoints permits setting breakpoints on particular operations and
+# events in targets that run JavaScript but do not have a DOM.
+# JavaScript execution will stop on these operations as if there was a regular
+# breakpoint set.
+experimental domain EventBreakpoints
+  # Sets breakpoint on particular native event.
+  command setInstrumentationBreakpoint
+    parameters
+      # Instrumentation name to stop on.
+      string eventName
+
+  # Removes breakpoint on particular native event.
+  command removeInstrumentationBreakpoint
+    parameters
+      # Instrumentation name to stop on.
+      string eventName
+
 # This domain facilitates obtaining document snapshots with DOM, layout, and style information.
 experimental domain DOMSnapshot
   depends on CSS

package/types/protocol-mapping.d.ts

@@ -2205,6 +2205,20 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.DOMDebugger.SetXHRBreakpointRequest];
             returnType: void;
         };
+        /**
+         * Sets breakpoint on particular native event.
+         */
+        'EventBreakpoints.setInstrumentationBreakpoint': {
+            paramsType: [Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest];
+            returnType: void;
+        };
+        /**
+         * Removes breakpoint on particular native event.
+         */
+        'EventBreakpoints.removeInstrumentationBreakpoint': {
+            paramsType: [Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest];
+            returnType: void;
+        };
         /**
          * Disables DOM snapshot agent for the given page.
          */

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

@@ -42,6 +42,8 @@ export namespace ProtocolProxyApi {
 
         DOMDebugger: DOMDebuggerApi;
 
+        EventBreakpoints: EventBreakpointsApi;
+
         DOMSnapshot: DOMSnapshotApi;
 
         DOMStorage: DOMStorageApi;
@@ -1501,6 +1503,19 @@ export namespace ProtocolProxyApi {
 
     }
 
+    export interface EventBreakpointsApi {
+        /**
+         * Sets breakpoint on particular native event.
+         */
+        setInstrumentationBreakpoint(params: Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest): Promise<void>;
+
+        /**
+         * Removes breakpoint on particular native event.
+         */
+        removeInstrumentationBreakpoint(params: Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest): Promise<void>;
+
+    }
+
     export interface DOMSnapshotApi {
         /**
          * Disables DOM snapshot agent for the given page.

package/types/protocol.d.ts

@@ -3256,12 +3256,32 @@ export namespace Protocol {
             frameId?: Page.FrameId;
         }
 
+        /**
+         * This issue tracks information needed to print a deprecation message.
+         * The formatting is inherited from the old console.log version, see more at:
+         * https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/frame/deprecation.cc
+         * TODO(crbug.com/1264960): Re-work format to add i18n support per:
+         * https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/public/devtools_protocol/README.md
+         */
+        export interface DeprecationIssueDetails {
+            affectedFrame?: AffectedFrame;
+            sourceCodeLocation: SourceCodeLocation;
+            /**
+             * The content of the deprecation issue (this won't be translated),
+             * e.g. "window.inefficientLegacyStorageMethod will be removed in M97,
+             * around January 2022. Please use Web Storage or Indexed Database
+             * instead. This standard was abandoned in January, 1970. See
+             * https://www.chromestatus.com/feature/5684870116278272 for more details."
+             */
+            message?: string;
+        }
+
         /**
          * A unique identifier for the type of issue. Each type may use one of the
          * optional fields in InspectorIssueDetails to convey more specific
          * information about the kind of issue.
          */
-        export type InspectorIssueCode = ('SameSiteCookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'TrustedWebActivityIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'NavigatorUserAgentIssue' | 'WasmCrossOriginModuleSharingIssue' | 'GenericIssue');
+        export type InspectorIssueCode = ('SameSiteCookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'TrustedWebActivityIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'NavigatorUserAgentIssue' | 'WasmCrossOriginModuleSharingIssue' | 'GenericIssue' | 'DeprecationIssue');
 
         /**
          * This struct holds a list of optional fields with additional information
@@ -3283,6 +3303,7 @@ export namespace Protocol {
             navigatorUserAgentIssueDetails?: NavigatorUserAgentIssueDetails;
             wasmCrossOriginModuleSharingIssue?: WasmCrossOriginModuleSharingIssueDetails;
             genericIssueDetails?: GenericIssueDetails;
+            deprecationIssueDetails?: DeprecationIssueDetails;
         }
 
         /**
@@ -6260,6 +6281,29 @@ export namespace Protocol {
         }
     }
 
+    /**
+     * EventBreakpoints permits setting breakpoints on particular operations and
+     * events in targets that run JavaScript but do not have a DOM.
+     * JavaScript execution will stop on these operations as if there was a regular
+     * breakpoint set.
+     */
+    export namespace EventBreakpoints {
+
+        export interface SetInstrumentationBreakpointRequest {
+            /**
+             * Instrumentation name to stop on.
+             */
+            eventName: string;
+        }
+
+        export interface RemoveInstrumentationBreakpointRequest {
+            /**
+             * Instrumentation name to stop on.
+             */
+            eventName: string;
+        }
+    }
+
     /**
      * This domain facilitates obtaining document snapshots with DOM, layout, and style information.
      */