Roll protocol to r1289136

ChromeDevTools · Apr 18, 2024 · 385db00 · 385db00
1 parent e52e967
commit 385db00
Show file tree

Hide file tree

Showing 8 changed files with 139 additions and 38 deletions.
diff --git a/changelog.md b/changelog.md
@@ -1,7 +1,44 @@
 
 
+## Roll protocol to r1289136 — _2024-04-18T04:26:02.000Z_
+######  Diff: [`e52e967...da7451d`](https://github.com/ChromeDevTools/devtools-protocol/compare/e52e967...da7451d)
+
+```diff
+@@ browser_protocol.pdl:1059 @@ experimental domain Audits
+     parameters
+       InspectorIssue issue
+
++# Defines commands and events for browser extensions. Available if the client
++# is connected using the --remote-debugging-pipe flag and
++# the --enable-unsafe-extension-debugging flag is set.
++experimental domain Extensions
++  # Installs an unpacked extension from the filesystem similar to
++  # --load-extension CLI flags. Returns extension ID once the extension
++  # has been installed.
++  command loadUnpacked
++    parameters
++      # Absolute file path.
++      string path
++    returns
++      # Extension id.
++      string id
++
+ # Defines commands and events for Autofill.
+ experimental domain Autofill
+   type CreditCard extends object
+@@ -8440,7 +8455,7 @@ domain Page
+   #   This API always waits for the manifest to be loaded.
+   #   If manifestId is provided, and it does not match the manifest of the
+   #     current document, this API errors out.
+-  #   If there isn’t a loaded page, this API errors out immediately.
++  #   If there is not a loaded page, this API errors out immediately.
+   command getAppManifest
+     parameters
+       optional string manifestId
+```
+
 ## Roll protocol to r1286932 — _2024-04-13T04:24:25.000Z_
-######  Diff: [`78bb0d0...eefa004`](https://github.com/ChromeDevTools/devtools-protocol/compare/78bb0d0...eefa004)
+######  Diff: [`78bb0d0...e52e967`](https://github.com/ChromeDevTools/devtools-protocol/compare/78bb0d0...e52e967)
 
 ```diff
 @@ browser_protocol.pdl:876 @@ experimental domain Audits
@@ -11719,35 +11756,4 @@ index 09c420e..bd277eb 100644
        # If set to true, tests of user presence will succeed immediately.
        # Otherwise, they will not be resolved. Defaults to true.
        optional boolean automaticPresenceSimulation
-```
-
-## Roll protocol to r953752 — _2021-12-23T05:15:20.000Z_
-######  Diff: [`b411e13...17a9c3e`](https://github.com/ChromeDevTools/devtools-protocol/compare/b411e13...17a9c3e)
-
-```diff
-@@ browser_protocol.pdl:8100 @@ domain Page
-       # Not restored reason
-       BackForwardCacheNotRestoredReason reason
-
-+  experimental type BackForwardCacheNotRestoredExplanationTree extends object
-+    properties
-+      # URL of each frame
-+      string url
-+      # Not restored reasons of each frame
-+      array of BackForwardCacheNotRestoredExplanation explanations
-+      # Array of children frame
-+      array of BackForwardCacheNotRestoredExplanationTree children
-+
-   # Fired for failed bfcache history navigations if BackForwardCache feature is enabled. Do
-   # not assume any ordering with the Page.frameNavigated event. This event is fired only for
-   # main-frame history navigation where the document changes (non-same-document navigations),
-@@ -8112,6 +8121,8 @@ domain Page
-       FrameId frameId
-       # Array of reasons why the page could not be cached. This must not be empty.
-       array of BackForwardCacheNotRestoredExplanation notRestoredExplanations
-+      # Tree structure of reasons why the page could not be cached for each frame.
-+      optional BackForwardCacheNotRestoredExplanationTree notRestoredExplanationsTree
-
-   event loadEventFired
-     parameters
 ```
diff --git a/json/browser_protocol.json b/json/browser_protocol.json
@@ -2107,6 +2107,31 @@
                 }
             ]
         },
+        {
+            "domain": "Extensions",
+            "description": "Defines commands and events for browser extensions. Available if the client\nis connected using the --remote-debugging-pipe flag and\nthe --enable-unsafe-extension-debugging flag is set.",
+            "experimental": true,
+            "commands": [
+                {
+                    "name": "loadUnpacked",
+                    "description": "Installs an unpacked extension from the filesystem similar to\n--load-extension CLI flags. Returns extension ID once the extension\nhas been installed.",
+                    "parameters": [
+                        {
+                            "name": "path",
+                            "description": "Absolute file path.",
+                            "type": "string"
+                        }
+                    ],
+                    "returns": [
+                        {
+                            "name": "id",
+                            "description": "Extension id.",
+                            "type": "string"
+                        }
+                    ]
+                }
+            ]
+        },
         {
             "domain": "Autofill",
             "description": "Defines commands and events for Autofill.",
@@ -18331,7 +18356,7 @@
                 },
                 {
                     "name": "getAppManifest",
-                    "description": "Gets the processed manifest for this current document.\n  This API always waits for the manifest to be loaded.\n  If manifestId is provided, and it does not match the manifest of the\n    current document, this API errors out.\n  If there isn\u2019t a loaded page, this API errors out immediately.",
+                    "description": "Gets the processed manifest for this current document.\n  This API always waits for the manifest to be loaded.\n  If manifestId is provided, and it does not match the manifest of the\n    current document, this API errors out.\n  If there is not a loaded page, this API errors out immediately.",
                     "parameters": [
                         {
                             "name": "manifestId",

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1286932",
+  "version": "0.0.1289136",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

diff --git a/pdl/browser_protocol.pdl b/pdl/browser_protocol.pdl
@@ -1059,6 +1059,21 @@ experimental domain Audits
     parameters
       InspectorIssue issue
 
+# Defines commands and events for browser extensions. Available if the client
+# is connected using the --remote-debugging-pipe flag and
+# the --enable-unsafe-extension-debugging flag is set.
+experimental domain Extensions
+  # Installs an unpacked extension from the filesystem similar to
+  # --load-extension CLI flags. Returns extension ID once the extension
+  # has been installed.
+  command loadUnpacked
+    parameters
+      # Absolute file path.
+      string path
+    returns
+      # Extension id.
+      string id
+
 # Defines commands and events for Autofill.
 experimental domain Autofill
   type CreditCard extends object
@@ -8440,7 +8455,7 @@ domain Page
   #   This API always waits for the manifest to be loaded.
   #   If manifestId is provided, and it does not match the manifest of the
   #     current document, this API errors out.
-  #   If there isn’t a loaded page, this API errors out immediately.
+  #   If there is not a loaded page, this API errors out immediately.
   command getAppManifest
     parameters
       optional string manifestId

diff --git a/types/protocol-mapping.d.ts b/types/protocol-mapping.d.ts
@@ -1502,6 +1502,15 @@ export namespace ProtocolMapping {
             paramsType: [];
             returnType: Protocol.Audits.CheckFormsIssuesResponse;
         };
+        /**
+         * Installs an unpacked extension from the filesystem similar to
+         * --load-extension CLI flags. Returns extension ID once the extension
+         * has been installed.
+         */
+        'Extensions.loadUnpacked': {
+            paramsType: [Protocol.Extensions.LoadUnpackedRequest];
+            returnType: Protocol.Extensions.LoadUnpackedResponse;
+        };
         /**
          * Trigger autofill on a form identified by the fieldId.
          * If the field and related form cannot be autofilled, returns an error.
@@ -3716,7 +3725,7 @@ export namespace ProtocolMapping {
          *   This API always waits for the manifest to be loaded.
          *   If manifestId is provided, and it does not match the manifest of the
          *     current document, this API errors out.
-         *   If there isn’t a loaded page, this API errors out immediately.
+         *   If there is not a loaded page, this API errors out immediately.
          */
         'Page.getAppManifest': {
             paramsType: [Protocol.Page.GetAppManifestRequest?];

diff --git a/types/protocol-proxy-api.d.ts b/types/protocol-proxy-api.d.ts
@@ -28,6 +28,8 @@ export namespace ProtocolProxyApi {
 
         Audits: AuditsApi;
 
+        Extensions: ExtensionsApi;
+
         Autofill: AutofillApi;
 
         BackgroundService: BackgroundServiceApi;
@@ -805,6 +807,16 @@ export namespace ProtocolProxyApi {
 
     }
 
+    export interface ExtensionsApi {
+        /**
+         * Installs an unpacked extension from the filesystem similar to
+         * --load-extension CLI flags. Returns extension ID once the extension
+         * has been installed.
+         */
+        loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<Protocol.Extensions.LoadUnpackedResponse>;
+
+    }
+
     export interface AutofillApi {
         /**
          * Trigger autofill on a form identified by the fieldId.
@@ -2845,7 +2857,7 @@ export namespace ProtocolProxyApi {
          *   This API always waits for the manifest to be loaded.
          *   If manifestId is provided, and it does not match the manifest of the
          *     current document, this API errors out.
-         *   If there isn’t a loaded page, this API errors out immediately.
+         *   If there is not a loaded page, this API errors out immediately.
          */
         getAppManifest(params: Protocol.Page.GetAppManifestRequest): Promise<Protocol.Page.GetAppManifestResponse>;
 

diff --git a/types/protocol-tests-proxy-api.d.ts b/types/protocol-tests-proxy-api.d.ts
@@ -28,6 +28,8 @@ export namespace ProtocolTestsProxyApi {
 
         Audits: AuditsApi;
 
+        Extensions: ExtensionsApi;
+
         Autofill: AutofillApi;
 
         BackgroundService: BackgroundServiceApi;
@@ -863,6 +865,16 @@ export namespace ProtocolTestsProxyApi {
 
     }
 
+    export interface ExtensionsApi {
+        /**
+         * Installs an unpacked extension from the filesystem similar to
+         * --load-extension CLI flags. Returns extension ID once the extension
+         * has been installed.
+         */
+        loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<{id: number, result: Protocol.Extensions.LoadUnpackedResponse, sessionId: string}>;
+
+    }
+
     export interface AutofillApi {
         /**
          * Trigger autofill on a form identified by the fieldId.
@@ -3053,7 +3065,7 @@ export namespace ProtocolTestsProxyApi {
          *   This API always waits for the manifest to be loaded.
          *   If manifestId is provided, and it does not match the manifest of the
          *     current document, this API errors out.
-         *   If there isn’t a loaded page, this API errors out immediately.
+         *   If there is not a loaded page, this API errors out immediately.
          */
         getAppManifest(params: Protocol.Page.GetAppManifestRequest): Promise<{id: number, result: Protocol.Page.GetAppManifestResponse, sessionId: string}>;
 

diff --git a/types/protocol.d.ts b/types/protocol.d.ts
@@ -3754,6 +3754,28 @@ export namespace Protocol {
         }
     }
 
+    /**
+     * Defines commands and events for browser extensions. Available if the client
+     * is connected using the --remote-debugging-pipe flag and
+     * the --enable-unsafe-extension-debugging flag is set.
+     */
+    export namespace Extensions {
+
+        export interface LoadUnpackedRequest {
+            /**
+             * Absolute file path.
+             */
+            path: string;
+        }
+
+        export interface LoadUnpackedResponse {
+            /**
+             * Extension id.
+             */
+            id: string;
+        }
+    }
+
     /**
      * Defines commands and events for Autofill.
      */