Skip to main content

FileChooser

FileChooser 对象由 page.on('filechooser') 事件中的页面调度。

¥FileChooser objects are dispatched by the page in the page.on('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'));

方法​

¥Methods

element​

Added before v1.9 fileChooser.element

返回与此文件选择器关联的输入元素。

¥Returns input element associated with this file chooser.

用法

¥Usage

fileChooser.element();

返回

¥Returns

isMultiple​

Added before v1.9 fileChooser.isMultiple

返回此文件选择器是否接受多个文件。

¥Returns whether this file chooser accepts multiple files.

用法

¥Usage

fileChooser.isMultiple();

返回

¥Returns

page​

Added before v1.9 fileChooser.page

返回此文件选择器所属的页面。

¥Returns page this file chooser belongs to.

用法

¥Usage

fileChooser.page();

返回

¥Returns

setFiles​

Added before v1.9 fileChooser.setFiles

设置与此选择器关联的文件输入的值。如果某些 filePaths 是相对路径，则它们将相对于当前工作目录进行解析。对于空数组，清除选定的文件。

¥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.

用法

¥Usage

await fileChooser.setFiles(files);
await fileChooser.setFiles(files, options);

参数

¥Arguments

文件名

¥File name

文件类型

¥File type

文件内容

¥File content

Deprecated

This option has no effect.

此选项无效。

¥This option has no effect.

最长时间（以毫秒为单位）。默认为 0 - 没有超时。可以通过配置中的 actionTimeout 选项或使用 browserContext.setDefaultTimeout() 或 page.setDefaultTimeout() 方法更改默认值。

¥Maximum time in milliseconds. Defaults to 0 - no timeout. The default value can be changed via actionTimeout option in the config, or by using the browserContext.setDefaultTimeout() or page.setDefaultTimeout() methods.

返回

¥Returns