Puppeteer 中文文档v25.8.0

FileChooser 类

文件选择器让你可以响应页面发起的文件请求。

签名

export declare class FileChooser

备注

FileChooser 实例通过 Page.waitForFileChooser() 方法返回。

在浏览器中,同一时间只能打开一个文件选择器。所有文件选择器都必须被接受或取消,否则后续的文件选择器将无法出现。

此类的构造函数被标记为内部。第三方代码不应直接调用构造函数,也不应创建扩展 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']);

方法

方法

修饰符

说明

accept(paths)

使用给定的文件路径接受文件选择器请求。

备注:

此方法不会验证文件路径是否存在。此外,如果路径是相对的,则将相对于当前工作目录进行解析。对于连接远程 chrome 环境的本地脚本,路径必须是绝对路径。

cancel()

关闭文件选择器而不选择任何文件。

isMultiple()

文件选择器是否允许多选文件。