input.setFiles command

Syntax

{
  "method": "input.setFiles",
  "params": {
    "context": "<contextId>",
    "element": "<elementId>",
    "files": ["<filePath>", ...]
  }
}

Parameters

The params field contains:

context

A string that contains the ID (UUID) of the context with the target <input type="file"> element. Context IDs are returned by commands such as browsingContext.getTree.

element

An object containing the ID that uniquely identifies the <input type="file"> DOM element to use for file selection. The ID is returned by the browser when you locate the element using script.evaluate or script.callFunction.

files

An array of strings, where each string is the absolute file path of a file to select. This command overrides any previously selected files. You can pass an empty array to clear the selection. If the array contains more than one file path, ensure that the <input type="file"> element has the multiple attribute.

Return value

The result field in the response is an empty object ({}).

Errors

no such element

The element reference cannot be resolved to a valid DOM element in the given context.

unable to set file input

The element is not an <input> element with type="file", the element is disabled, or more than one file path is provided without the multiple attribute.

unsupported operation

The browser is unable to set the selected files to the provided paths; for example, if any of the specified files do not exist on the filesystem.

Examples

Setting a file on a file input

With a WebDriver BiDi connection and an active session, first obtain the sharedId of a <input type="file"> element using script.evaluate, script.callFunction, or an input.fileDialogOpened event, then send the following message to set its selected file:

{
  "id": 1,
  "method": "input.setFiles",
  "params": {
    "context": "5f07e3ca-ecac-465e-b9ef-49000c196ecf",
    "element": {
      "sharedId": "3be28343-afd3-4dea-a2b6-a863fbbb80e1"
    },
    "files": ["/home/user/documents/test-upload.txt"]
  }
}

The browser responds as follows:

{
  "id": 1,
  "type": "success",
  "result": {}
}

Clearing the file selection

To clear all previously selected files, pass an empty array:

{
  "id": 2,
  "method": "input.setFiles",
  "params": {
    "context": "5f07e3ca-ecac-465e-b9ef-49000c196ecf",
    "element": {
      "sharedId": "3be28343-afd3-4dea-a2b6-a863fbbb80e1"
    },
    "files": []
  }
}

The browser responds as follows:

{
  "id": 2,
  "type": "success",
  "result": {}
}

Specifications

Browser compatibility

See also

• input.performActions command
• input.releaseActions command
• input.fileDialogOpened event
• script.evaluate command