puppeteer/website/versioned_docs/version-15.4.0/api/puppeteer.filechooser.md
release-please[bot] f0c28085c0
chore(main): release 15.4.0 (#8668)
* chore(main): release 15.4.0

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-07-13 15:52:23 +02:00

1.9 KiB

sidebar_label
FileChooser

FileChooser class

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

Signature:

export declare class FileChooser

Remarks

FileChooser objects are returned via the page.waitForFileChooser method.

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

An example of using FileChooser:

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

**NOTE** 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.

Methods

Method Modifiers Description
accept(filePaths) Accept the file chooser request with given paths.
cancel() Closes the file chooser without selecting any files.
isMultiple() Whether file chooser allow for multiple file selection.