devtools-protocol 0.0.1304863 → 0.0.1305504

package/json/browser_protocol.json

@@ -26247,6 +26247,33 @@
                             "$ref": "Target.TargetID"
                         }
                     ]
+                },
+                {
+                    "name": "launchFilesInApp",
+                    "description": "Opens one or more local files from an installed web app identified by its\nmanifestId. The web app needs to have file handlers registered to process\nthe files. The API returns one or more tabs / web contents' based\nTarget.TargetIDs which can be used to attach to via Target.attachToTarget or\nsimilar APIs.\nIf some files in the parameters cannot be handled by the web app, they will\nbe ignored. If none of the files can be handled, this API returns an error.\nIf no files provided as the parameter, this API also returns an error.\n\nAccording to the definition of the file handlers in the manifest file, one\nTarget.TargetID may represent a tab handling one or more files. The order of\nthe returned Target.TargetIDs is also not guaranteed.\n\nTODO(crbug.com/339454034): Check the existences of the input files.",
+                    "parameters": [
+                        {
+                            "name": "manifestId",
+                            "type": "string"
+                        },
+                        {
+                            "name": "files",
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            }
+                        }
+                    ],
+                    "returns": [
+                        {
+                            "name": "targetIds",
+                            "description": "IDs of the tab targets created as the result.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "Target.TargetID"
+                            }
+                        }
+                    ]
                 }
             ]
         }

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -12401,3 +12401,25 @@ experimental domain PWA
     returns
       # ID of the tab target created as a result.
       Target.TargetID targetId
+
+  # Opens one or more local files from an installed web app identified by its
+  # manifestId. The web app needs to have file handlers registered to process
+  # the files. The API returns one or more tabs / web contents' based
+  # Target.TargetIDs which can be used to attach to via Target.attachToTarget or
+  # similar APIs.
+  # If some files in the parameters cannot be handled by the web app, they will
+  # be ignored. If none of the files can be handled, this API returns an error.
+  # If no files provided as the parameter, this API also returns an error.
+  #
+  # According to the definition of the file handlers in the manifest file, one
+  # Target.TargetID may represent a tab handling one or more files. The order of
+  # the returned Target.TargetIDs is also not guaranteed.
+  #
+  # TODO(crbug.com/339454034): Check the existences of the input files.
+  command launchFilesInApp
+    parameters
+      string manifestId
+      array of string files
+    returns
+      # IDs of the tab targets created as the result.
+      array of Target.TargetID targetIds

package/types/protocol-mapping.d.ts

@@ -4992,6 +4992,26 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.PWA.LaunchRequest];
             returnType: Protocol.PWA.LaunchResponse;
         };
+        /**
+         * Opens one or more local files from an installed web app identified by its
+         * manifestId. The web app needs to have file handlers registered to process
+         * the files. The API returns one or more tabs / web contents' based
+         * Target.TargetIDs which can be used to attach to via Target.attachToTarget or
+         * similar APIs.
+         * If some files in the parameters cannot be handled by the web app, they will
+         * be ignored. If none of the files can be handled, this API returns an error.
+         * If no files provided as the parameter, this API also returns an error.
+         * 
+         * According to the definition of the file handlers in the manifest file, one
+         * Target.TargetID may represent a tab handling one or more files. The order of
+         * the returned Target.TargetIDs is also not guaranteed.
+         * 
+         * TODO(crbug.com/339454034): Check the existences of the input files.
+         */
+        'PWA.launchFilesInApp': {
+            paramsType: [Protocol.PWA.LaunchFilesInAppRequest];
+            returnType: Protocol.PWA.LaunchFilesInAppResponse;
+        };
     }
 }
 

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

@@ -4261,6 +4261,24 @@ export namespace ProtocolProxyApi {
          */
         launch(params: Protocol.PWA.LaunchRequest): Promise<Protocol.PWA.LaunchResponse>;
 
+        /**
+         * Opens one or more local files from an installed web app identified by its
+         * manifestId. The web app needs to have file handlers registered to process
+         * the files. The API returns one or more tabs / web contents' based
+         * Target.TargetIDs which can be used to attach to via Target.attachToTarget or
+         * similar APIs.
+         * If some files in the parameters cannot be handled by the web app, they will
+         * be ignored. If none of the files can be handled, this API returns an error.
+         * If no files provided as the parameter, this API also returns an error.
+         * 
+         * According to the definition of the file handlers in the manifest file, one
+         * Target.TargetID may represent a tab handling one or more files. The order of
+         * the returned Target.TargetIDs is also not guaranteed.
+         * 
+         * TODO(crbug.com/339454034): Check the existences of the input files.
+         */
+        launchFilesInApp(params: Protocol.PWA.LaunchFilesInAppRequest): Promise<Protocol.PWA.LaunchFilesInAppResponse>;
+
     }
 }
 

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

@@ -4645,6 +4645,24 @@ export namespace ProtocolTestsProxyApi {
          */
         launch(params: Protocol.PWA.LaunchRequest): Promise<{id: number, result: Protocol.PWA.LaunchResponse, sessionId: string}>;
 
+        /**
+         * Opens one or more local files from an installed web app identified by its
+         * manifestId. The web app needs to have file handlers registered to process
+         * the files. The API returns one or more tabs / web contents' based
+         * Target.TargetIDs which can be used to attach to via Target.attachToTarget or
+         * similar APIs.
+         * If some files in the parameters cannot be handled by the web app, they will
+         * be ignored. If none of the files can be handled, this API returns an error.
+         * If no files provided as the parameter, this API also returns an error.
+         * 
+         * According to the definition of the file handlers in the manifest file, one
+         * Target.TargetID may represent a tab handling one or more files. The order of
+         * the returned Target.TargetIDs is also not guaranteed.
+         * 
+         * TODO(crbug.com/339454034): Check the existences of the input files.
+         */
+        launchFilesInApp(params: Protocol.PWA.LaunchFilesInAppRequest): Promise<{id: number, result: Protocol.PWA.LaunchFilesInAppResponse, sessionId: string}>;
+
     }
 }
 

package/types/protocol.d.ts

@@ -18569,6 +18569,18 @@ export namespace Protocol {
              */
             targetId: Target.TargetID;
         }
+
+        export interface LaunchFilesInAppRequest {
+            manifestId: string;
+            files: string[];
+        }
+
+        export interface LaunchFilesInAppResponse {
+            /**
+             * IDs of the tab targets created as the result.
+             */
+            targetIds: Target.TargetID[];
+        }
     }
 }