Page.waitForFileChooser() 方法

此方法通常与触发文件选择的操作配对使用。

注意

必须在启动文件选择器之前调用此方法。它不会返回当前活动的文件选择器。

注意

目前不支持通过 DOM API（如 window.showOpenFilePicker）触发的文件对话框的拦截。

签名

class Page {
  abstract waitForFileChooser(
    options?: WaitTimeoutOptions,
  ): Promise<FileChooser>;
}

参数

参数	类型	描述
options	WaitTimeoutOptions	(可选)

返回

Promise<FileChooser>

备注

在“有头”浏览器中，此方法会导致用户看不到本机文件选择器对话框。

示例

以下示例点击一个发出文件选择器的按钮，然后返回 /tmp/myfile.pdf，就像用户选择了此文件一样。

const [fileChooser] = await Promise.all([
  page.waitForFileChooser(),
  page.click('#upload-file-button'),
  // some button that triggers file selection
]);
await fileChooser.accept(['/tmp/myfile.pdf']);