文件选择器

FileChooser 对象由页面在 page.on('filechooser') 事件中派发。

// 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'));

---

方法

元素

在 v1.9 之前添加 fileChooser.element

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

用法

fileChooser.element();

返回

• ElementHandle#

---

isMultiple

在 v1.9 之前添加 fileChooser.isMultiple

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

用法

fileChooser.isMultiple();

返回

• 布尔值#

---

页面

在 v1.9 之前添加 fileChooser.page

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

用法

fileChooser.page();

返回

• 页面#

---

setFiles

在 v1.9 之前添加 fileChooser.setFiles

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

用法

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

参数

• files 字符串 | 数组<字符串> | 对象 | 数组<对象>#

  • name 字符串

    文件名

  • mimeType 字符串

    文件类型

  • buffer 缓冲区

    文件内容

• options 对象 (可选)

  • noWaitAfter 布尔值 (可选)#

    已弃用

    此选项没有效果。

    此选项没有效果。

  • timeout 数字 (可选)#

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

返回

• Promise<void>#