devtools-protocol 0.0.1410712 → 0.0.1413303

package/json/browser_protocol.json

@@ -20260,6 +20260,42 @@
                     "name": "frameResized",
                     "experimental": true
                 },
+                {
+                    "name": "frameStartedNavigating",
+                    "description": "Fired when a navigation starts. This event is fired for both\nrenderer-initiated and browser-initiated navigations. For renderer-initiated\nnavigations, the event is fired after `frameRequestedNavigation`.\nNavigation may still be cancelled after the event is issued. Multiple events\ncan be fired for a single navigation, for example, when a same-document\nnavigation becomes a cross-document navigation (such as in the case of a\nframeset).",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "frameId",
+                            "description": "ID of the frame that is being navigated.",
+                            "$ref": "FrameId"
+                        },
+                        {
+                            "name": "url",
+                            "description": "The URL the navigation started with. The final URL can be different.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "loaderId",
+                            "description": "Loader identifier. Even though it is present in case of same-document\nnavigation, the previously committed loaderId would not change unless\nthe navigation changes from a same-document to a cross-document\nnavigation.",
+                            "$ref": "Network.LoaderId"
+                        },
+                        {
+                            "name": "navigationType",
+                            "type": "string",
+                            "enum": [
+                                "reload",
+                                "reloadBypassingCache",
+                                "restore",
+                                "restoreWithPost",
+                                "historySameDocument",
+                                "historyDifferentDocument",
+                                "sameDocument",
+                                "differentDocument"
+                            ]
+                        }
+                    ]
+                },
                 {
                     "name": "frameRequestedNavigation",
                     "description": "Fired when a renderer-initiated navigation is requested.\nNavigation may still be cancelled after the event is issued.",

package/json/js_protocol.json

@@ -386,6 +386,22 @@
                             "type": "string"
                         }
                     ]
+                },
+                {
+                    "id": "ResolvedBreakpoint",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "breakpointId",
+                            "description": "Breakpoint unique identifier.",
+                            "$ref": "BreakpointId"
+                        },
+                        {
+                            "name": "location",
+                            "description": "Actual breakpoint location.",
+                            "$ref": "Location"
+                        }
+                    ]
                 }
             ],
             "commands": [
@@ -1180,7 +1196,8 @@
             "events": [
                 {
                     "name": "breakpointResolved",
-                    "description": "Fired when breakpoint is resolved to an actual script and location.",
+                    "description": "Fired when breakpoint is resolved to an actual script and location.\nDeprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.",
+                    "deprecated": true,
                     "parameters": [
                         {
                             "name": "breakpointId",
@@ -1500,6 +1517,16 @@
                             "experimental": true,
                             "optional": true,
                             "type": "string"
+                        },
+                        {
+                            "name": "resolvedBreakpoints",
+                            "description": "The list of set breakpoints in this script if calls to `setBreakpointByUrl`\nmatches this script's URL or hash. Clients that use this list can ignore the\n`breakpointResolved` event. They are equivalent.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "array",
+                            "items": {
+                                "$ref": "ResolvedBreakpoint"
+                            }
                         }
                     ]
                 }
@@ -3240,12 +3267,22 @@
                     "returns": [
                         {
                             "name": "usedSize",
-                            "description": "Used heap size in bytes.",
+                            "description": "Used JavaScript heap size in bytes.",
                             "type": "number"
                         },
                         {
                             "name": "totalSize",
-                            "description": "Allocated heap size in bytes.",
+                            "description": "Allocated JavaScript heap size in bytes.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "embedderHeapUsedSize",
+                            "description": "Used size in bytes in the embedder's garbage-collected heap.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "backingStorageSize",
+                            "description": "Size in bytes of backing storage for array buffers and external strings.",
                             "type": "number"
                         }
                     ]

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -9396,6 +9396,34 @@ domain Page
 
   experimental event frameResized
 
+  # Fired when a navigation starts. This event is fired for both
+  # renderer-initiated and browser-initiated navigations. For renderer-initiated
+  # navigations, the event is fired after `frameRequestedNavigation`.
+  # Navigation may still be cancelled after the event is issued. Multiple events
+  # can be fired for a single navigation, for example, when a same-document
+  # navigation becomes a cross-document navigation (such as in the case of a
+  # frameset).
+  experimental event frameStartedNavigating
+    parameters
+      # ID of the frame that is being navigated.
+      FrameId frameId
+      # The URL the navigation started with. The final URL can be different.
+      string url
+      # Loader identifier. Even though it is present in case of same-document
+      # navigation, the previously committed loaderId would not change unless
+      # the navigation changes from a same-document to a cross-document
+      # navigation.
+      Network.LoaderId loaderId
+      enum navigationType
+        reload
+        reloadBypassingCache
+        restore
+        restoreWithPost
+        historySameDocument
+        historyDifferentDocument
+        sameDocument
+        differentDocument
+
   # Fired when a renderer-initiated navigation is requested.
   # Navigation may still be cancelled after the event is issued.
   experimental event frameRequestedNavigation

package/pdl/js_protocol.pdl

@@ -564,7 +564,8 @@ domain Debugger
       experimental optional array of LocationRange skipList
 
   # Fired when breakpoint is resolved to an actual script and location.
-  event breakpointResolved
+  # Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
+  deprecated event breakpointResolved
     parameters
       # Breakpoint unique identifier.
       BreakpointId breakpointId
@@ -622,6 +623,13 @@ domain Debugger
       # URL of the external symbol source.
       optional string externalURL
 
+  type ResolvedBreakpoint extends object
+    properties
+      # Breakpoint unique identifier.
+      BreakpointId breakpointId
+      # Actual breakpoint location.
+      Location location
+
   # Fired when virtual machine fails to parse the script.
   event scriptFailedToParse
     parameters
@@ -706,6 +714,10 @@ domain Debugger
       experimental optional array of Debugger.DebugSymbols debugSymbols
       # The name the embedder supplied for this script.
       experimental optional string embedderName
+      # The list of set breakpoints in this script if calls to `setBreakpointByUrl`
+      # matches this script's URL or hash. Clients that use this list can ignore the
+      # `breakpointResolved` event. They are equivalent.
+      experimental optional array of ResolvedBreakpoint resolvedBreakpoints
 
 experimental domain HeapProfiler
   depends on Runtime
@@ -1560,10 +1572,14 @@ domain Runtime
   # It is the total usage of the corresponding isolate not scoped to a particular Runtime.
   experimental command getHeapUsage
     returns
-      # Used heap size in bytes.
+      # Used JavaScript heap size in bytes.
       number usedSize
-      # Allocated heap size in bytes.
+      # Allocated JavaScript heap size in bytes.
       number totalSize
+      # Used size in bytes in the embedder's garbage-collected heap.
+      number embedderHeapUsedSize
+      # Size in bytes of backing storage for array buffers and external strings.
+      number backingStorageSize
 
   # Returns properties of a given object. Object group of the result is inherited from the target
   # object.

package/types/protocol-mapping.d.ts

@@ -15,6 +15,7 @@ export namespace ProtocolMapping {
         'Console.messageAdded': [Protocol.Console.MessageAddedEvent];
         /**
          * Fired when breakpoint is resolved to an actual script and location.
+         * Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
          */
         'Debugger.breakpointResolved': [Protocol.Debugger.BreakpointResolvedEvent];
         /**
@@ -453,6 +454,16 @@ export namespace ProtocolMapping {
          */
         'Page.documentOpened': [Protocol.Page.DocumentOpenedEvent];
         'Page.frameResized': [];
+        /**
+         * Fired when a navigation starts. This event is fired for both
+         * renderer-initiated and browser-initiated navigations. For renderer-initiated
+         * navigations, the event is fired after `frameRequestedNavigation`.
+         * Navigation may still be cancelled after the event is issued. Multiple events
+         * can be fired for a single navigation, for example, when a same-document
+         * navigation becomes a cross-document navigation (such as in the case of a
+         * frameset).
+         */
+        'Page.frameStartedNavigating': [Protocol.Page.FrameStartedNavigatingEvent];
         /**
          * Fired when a renderer-initiated navigation is requested.
          * Navigation may still be cancelled after the event is issued.

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

@@ -342,6 +342,7 @@ export namespace ProtocolProxyApi {
 
         /**
          * Fired when breakpoint is resolved to an actual script and location.
+         * Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
          */
         on(event: 'breakpointResolved', listener: (params: Protocol.Debugger.BreakpointResolvedEvent) => void): void;
 
@@ -3264,6 +3265,17 @@ export namespace ProtocolProxyApi {
 
         on(event: 'frameResized', listener: () => void): void;
 
+        /**
+         * Fired when a navigation starts. This event is fired for both
+         * renderer-initiated and browser-initiated navigations. For renderer-initiated
+         * navigations, the event is fired after `frameRequestedNavigation`.
+         * Navigation may still be cancelled after the event is issued. Multiple events
+         * can be fired for a single navigation, for example, when a same-document
+         * navigation becomes a cross-document navigation (such as in the case of a
+         * frameset).
+         */
+        on(event: 'frameStartedNavigating', listener: (params: Protocol.Page.FrameStartedNavigatingEvent) => void): void;
+
         /**
          * Fired when a renderer-initiated navigation is requested.
          * Navigation may still be cancelled after the event is issued.

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

@@ -344,6 +344,7 @@ export namespace ProtocolTestsProxyApi {
 
         /**
          * Fired when breakpoint is resolved to an actual script and location.
+         * Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
          */
         onBreakpointResolved(listener: (event: { params: Protocol.Debugger.BreakpointResolvedEvent }) => void): void;
         offBreakpointResolved(listener: (event: { params: Protocol.Debugger.BreakpointResolvedEvent }) => void): void;
@@ -3494,6 +3495,19 @@ export namespace ProtocolTestsProxyApi {
         offFrameResized(listener: (event: ) => void): void;
         onceFrameResized(eventMatcher?: (event: ) => boolean): Promise<>;
 
+        /**
+         * Fired when a navigation starts. This event is fired for both
+         * renderer-initiated and browser-initiated navigations. For renderer-initiated
+         * navigations, the event is fired after `frameRequestedNavigation`.
+         * Navigation may still be cancelled after the event is issued. Multiple events
+         * can be fired for a single navigation, for example, when a same-document
+         * navigation becomes a cross-document navigation (such as in the case of a
+         * frameset).
+         */
+        onFrameStartedNavigating(listener: (event: { params: Protocol.Page.FrameStartedNavigatingEvent }) => void): void;
+        offFrameStartedNavigating(listener: (event: { params: Protocol.Page.FrameStartedNavigatingEvent }) => void): void;
+        onceFrameStartedNavigating(eventMatcher?: (event: { params: Protocol.Page.FrameStartedNavigatingEvent }) => boolean): Promise<{ params: Protocol.Page.FrameStartedNavigatingEvent }>;
+
         /**
          * Fired when a renderer-initiated navigation is requested.
          * Navigation may still be cancelled after the event is issued.

package/types/protocol.d.ts

@@ -289,6 +289,17 @@ export namespace Protocol {
             externalURL?: string;
         }
 
+        export interface ResolvedBreakpoint {
+            /**
+             * Breakpoint unique identifier.
+             */
+            breakpointId: BreakpointId;
+            /**
+             * Actual breakpoint location.
+             */
+            location: Location;
+        }
+
         export const enum ContinueToLocationRequestTargetCallFrames {
             Any = 'any',
             Current = 'current',
@@ -823,6 +834,7 @@ export namespace Protocol {
 
         /**
          * Fired when breakpoint is resolved to an actual script and location.
+         * Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
          */
         export interface BreakpointResolvedEvent {
             /**
@@ -1048,6 +1060,12 @@ export namespace Protocol {
              * The name the embedder supplied for this script.
              */
             embedderName?: string;
+            /**
+             * The list of set breakpoints in this script if calls to `setBreakpointByUrl`
+             * matches this script's URL or hash. Clients that use this list can ignore the
+             * `breakpointResolved` event. They are equivalent.
+             */
+            resolvedBreakpoints?: ResolvedBreakpoint[];
         }
     }
 
@@ -2318,13 +2336,21 @@ export namespace Protocol {
 
         export interface GetHeapUsageResponse {
             /**
-             * Used heap size in bytes.
+             * Used JavaScript heap size in bytes.
              */
             usedSize: number;
             /**
-             * Allocated heap size in bytes.
+             * Allocated JavaScript heap size in bytes.
              */
             totalSize: number;
+            /**
+             * Used size in bytes in the embedder's garbage-collected heap.
+             */
+            embedderHeapUsedSize: number;
+            /**
+             * Size in bytes of backing storage for array buffers and external strings.
+             */
+            backingStorageSize: number;
         }
 
         export interface GetPropertiesRequest {
@@ -15105,6 +15131,48 @@ export namespace Protocol {
             frame: Frame;
         }
 
+        export const enum FrameStartedNavigatingEventNavigationType {
+            Reload = 'reload',
+            ReloadBypassingCache = 'reloadBypassingCache',
+            Restore = 'restore',
+            RestoreWithPost = 'restoreWithPost',
+            HistorySameDocument = 'historySameDocument',
+            HistoryDifferentDocument = 'historyDifferentDocument',
+            SameDocument = 'sameDocument',
+            DifferentDocument = 'differentDocument',
+        }
+
+        /**
+         * Fired when a navigation starts. This event is fired for both
+         * renderer-initiated and browser-initiated navigations. For renderer-initiated
+         * navigations, the event is fired after `frameRequestedNavigation`.
+         * Navigation may still be cancelled after the event is issued. Multiple events
+         * can be fired for a single navigation, for example, when a same-document
+         * navigation becomes a cross-document navigation (such as in the case of a
+         * frameset).
+         */
+        export interface FrameStartedNavigatingEvent {
+            /**
+             * ID of the frame that is being navigated.
+             */
+            frameId: FrameId;
+            /**
+             * The URL the navigation started with. The final URL can be different.
+             */
+            url: string;
+            /**
+             * Loader identifier. Even though it is present in case of same-document
+             * navigation, the previously committed loaderId would not change unless
+             * the navigation changes from a same-document to a cross-document
+             * navigation.
+             */
+            loaderId: Network.LoaderId;
+            /**
+             *  (FrameStartedNavigatingEventNavigationType enum)
+             */
+            navigationType: ('reload' | 'reloadBypassingCache' | 'restore' | 'restoreWithPost' | 'historySameDocument' | 'historyDifferentDocument' | 'sameDocument' | 'differentDocument');
+        }
+
         /**
          * Fired when a renderer-initiated navigation is requested.
          * Navigation may still be cancelled after the event is issued.