Page.waitForFileChooser() 方法
¥Page.waitForFileChooser() method
此方法通常与触发文件选择的操作结合使用。
¥This method is typically coupled with an action that triggers file choosing.
必须在启动文件选择器之前调用此函数。它不会返回当前活动的文件选择器。
¥This must be called before the file chooser is launched. It will not return a currently active file chooser.
目前不支持拦截通过 DOM API(例如 window.showOpenFilePicker)触发的文件对话框。
¥Interception of file dialogs triggered via DOM APIs such as window.showOpenFilePicker is currently not supported.
签名
¥Signature
class Page {
abstract waitForFileChooser(
options?: WaitTimeoutOptions
): Promise<FileChooser>;
}
参数
¥Parameters
范围 | 类型 | 描述 |
---|---|---|
options | (可选的) |
Returns:
Promise<FileChooser>
备注
¥Remarks
在 "有头" 浏览器中,此方法会为用户生成原生文件选择器对话框 not showing up
。
¥In the "headful" browser, this method results in the native file picker dialog not showing up
for the user.
示例
¥Example
以下示例单击一个发送文件选择器的按钮,然后使用 /tmp/myfile.pdf
进行响应,就好像用户已选择该文件一样。
¥The following example clicks a button that issues a file chooser and then responds with /tmp/myfile.pdf
as if a user has selected this file.
const [fileChooser] = await Promise.all([
page.waitForFileChooser(),
page.click('#upload-file-button'),
// some button that triggers file selection
]);
await fileChooser.accept(['/tmp/myfile.pdf']);