FileChooser class

File choosers let you react to the page requesting for a file.

Signature

export declare class FileChooser

Remarks

FileChooser instances are returned via the Page.waitForFileChooser() method.

In browsers, only one file chooser can be opened at a time. All file choosers must be accepted or canceled. Not doing so will prevent subsequent file choosers from appearing.

The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the FileChooser class.

Example

const [fileChooser] = await Promise.all([
  page.waitForFileChooser(),
  page.click('#upload-file-button'), // some button that triggers file selection
]);
await fileChooser.accept(['/tmp/myfile.pdf']);

Methods

Method Modifiers Description
[accept(paths)](./puppeteer.filechooser.accept.md) Accept the file chooser request with the given file paths. **Remarks:** This will not validate whether the file paths exists. Also, if a path is relative, then it is resolved against the [current working directory](https://nodejs.org/api/process.html#process_process_cwd). For locals script connecting to remote chrome environments, paths must be absolute.
[cancel()](./puppeteer.filechooser.cancel.md) Closes the file chooser without selecting any files.
[isMultiple()](./puppeteer.filechooser.ismultiple.md) Whether file chooser allow for [multiple](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#attr-multiple) file selection.