跳到正文
本页尚未翻译成中文,以下为英文原文。 查看英文版

FileChooser ​

Added in: v1.8

FileChooser objects are dispatched by the page in the page.on('fileChooser') event.

js
// 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 ​

fileChooser.element() ​

Added in: v1.8

Returns input element associated with this file chooser.

Returns

  • ElementHandle

fileChooser.isMultiple() ​

Added in: v1.8

Returns whether this file chooser accepts multiple files.

Returns

  • boolean

fileChooser.page() ​

Added in: v1.8

Returns page this file chooser belongs to.

Returns

  • Page

fileChooser.setFiles() ​

Added in: v1.8 async

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.

Arguments

  • files path | Array<path> | Object | Array<Object>

    • name string

      File name

    • mimeType string

      File type

    • buffer Buffer

      File content

  • options Object (optional)

    • noWaitAfter boolean (optional)

      This option has no effect.

    • signal AbortSignal (optional) Added in: v1.62

      Allows to cancel the operation using an AbortSignal. If the signal is aborted, the operation will be aborted and throw an error. Note that providing a signal does not disable the default timeout, which can be changed using browserContext.setDefaultTimeout() or page.setDefaultTimeout(); pass timeout: 0 to disable the timeout entirely.

    • timeout float (optional)

      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.

基于 Apache 2.0 许可证发布。