Spec-Zone.ru › Playwright

FileChooser

Объекты 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'));

Методы​

element​

Добавлено до версии 1.9

Возвращает элемент input, связанный с этим диалогом выбора файлов.

Использование

fileChooser.element();

Возвращает

  • ElementHandle

isMultiple​

Добавлено до версии 1.9

Возвращает, принимает ли этот диалог выбора файлов несколько файлов.

Использование

fileChooser.isMultiple();

Возвращает

  • boolean

page​

Добавлено до версии 1.9

Возвращает страницу, к которой относится этот диалог выбора файлов.

Использование

fileChooser.page();

Возвращает

  • Page

setFiles​

Добавлено до версии 1.9

Задает значение поля ввода файлов, связанного с этим диалогом выбора. Если некоторые из filePaths являются относительными путями, они разрешаются относительно текущего рабочего каталога. Пустой массив очищает список выбранных файлов.

Использование

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

Аргументы

  • files string | Array<string> | Object | Array<Object>
    • name string

      Имя файла

    • mimeType string

      Тип файла

    • buffer Buffer

      Содержимое файла

  • options Object (необязательно)
    • noWaitAfter boolean (необязательно)

      Устарело

      Этот параметр не влияет на результат.

      Этот параметр не влияет на результат.

    • signal AbortSignal (необязательно)

      Позволяет отменить операцию с помощью AbortSignal. Если сигнал отменен, операция будет прервана и вызовет ошибку. Обратите внимание: передача сигнала не отключает тайм-аут по умолчанию, который можно изменить с помощью browserContext.setDefaultTimeout() или page.setDefaultTimeout(); передайте timeout: 0, чтобы полностью отключить тайм-аут.

    • timeout number (необязательно)

      Максимальное время в миллисекундах. По умолчанию — 0, то есть без тайм-аута. Значение по умолчанию можно изменить с помощью параметра actionTimeout в конфигурации или методов browserContext.setDefaultTimeout() либо page.setDefaultTimeout().

Возвращает

  • Promise<void>

© 2026 Microsoft
Licensed under the Apache License, Version 2.0.
https://playwright.dev/docs/api/class-filechooser

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API