Skip to main content

class: FileChooser

Added in: v1.8

FileChooser objects are dispatched by the page in the Page.event('fileChooser') event.

// Start waiting for file chooser before clicking. Note no await.
const fileChooserPromise = page.waitForEvent('filechooser');
await page.getByText('Upload file').click();
const fileChooser = await fileChooserPromise;
await fileChooser.setFiles(path.join(__dirname, 'myfile.pdf'));
FileChooser fileChooser = page.waitForFileChooser(() -> page.getByText("Upload file").click());
fileChooser.setFiles(Paths.get("myfile.pdf"));
async with page.expect_file_chooser() as fc_info:
    await page.get_by_text("Upload file").click()
file_chooser = await fc_info.value
await file_chooser.set_files("myfile.pdf")
with page.expect_file_chooser() as fc_info:
    page.get_by_text("Upload file").click()
file_chooser = fc_info.value
file_chooser.set_files("myfile.pdf")
var fileChooser = await page.RunAndWaitForFileChooserAsync(async () =>
{
    await page.GetByText("Upload file").ClickAsync();
});
await fileChooser.SetFilesAsync("temp.txt");

method: FileChooser.element​

Added in: v1.8 Returns: ElementHandle

Returns input element associated with this file chooser.

method: FileChooser.isMultiple​

Added in: v1.8 Returns: boolean

Returns whether this file chooser accepts multiple files.

method: FileChooser.page​

Added in: v1.8 Returns: Page

Returns page this file chooser belongs to.

async method: FileChooser.setFiles​

Added in: v1.8

Sets the value of the file input this chooser is associated with. If some of the filePaths are relative paths, then they are resolved relative to the current working directory. For empty array, clears the selected files.

param: FileChooser.setFiles.files = %%-input-files-%%​

Added in: v1.8

option: FileChooser.setFiles.noWaitAfter = %%-input-no-wait-after-removed-%%​

Added in: v1.8

option: FileChooser.setFiles.timeout = %%-input-timeout-%%​

Added in: v1.8

option: FileChooser.setFiles.timeout = %%-input-timeout-js-%%​

Added in: v1.8