Skip to main content
Version: Next

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)

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. For locals script connecting to remote chrome environments, paths must be absolute.

cancel()

Closes the file chooser without selecting any files.

isMultiple()

Whether file chooser allow for multiple file selection.