1. Введение

В предыдущих статьях объяснялось, как загружать файлы. Поскольку есть загрузки, могут быть и загрузки. Поэтому брат Хун продолжит объяснять и делиться: файлы автоматической тестовой загрузки. Некоторые друзья или дети могут подумать, что это не так просто. Вам все равно нужно представить и объяснить это. Вам просто нужно посетить страницу загрузки, затем найти кнопку загрузки файла, который вы хотите загрузить, и нажать кнопку. На самом деле это не так. Послушайте, что медленно сказал брат Хун: Загрузка здесь — это загрузка без всплывающего окна загрузки. Мы видим, что при загрузке файла появляется диалоговое окно Windows. Мы знаем, что селен может работать только с веб-страницами и не может работать с диалоговыми окнами Windows. В руководстве по Selenium эта часть объясняется использованием параметров браузера для отключения. загрузите всплывающие окна или используйте инструмент autoIT или симуляцию клавиатуры. Так как же Playwright реализует загрузку файлов?

2. API для скачивания файлов

Playwright — это современный инструмент автоматического тестирования, который поддерживает несколько браузеров и операционных систем и помогает разработчикам и тестировщикам легко создавать и запускать надежные комплексные тесты. Помимо возможностей тестирования, Playwright также предоставляет ряд утилит и API, включая возможности загрузки и скачивания файлов. Эти функции могут помочь пользователям моделировать сценарии, в которых пользователи загружают или скачивают файлы, и проверять, что эти операции выполняются должным образом. В этой статье мы рассмотрим, как реализовать загрузку файлов в Playwright, а также предоставим пример кода и лучшие практики.

Например: функция загрузки на платформе предоставит шаблон (например, Excel, CSV). На данный момент нам нужно загрузить этот шаблон, изменить его, а затем загрузить. Как тестировщику, нам необходимо проверить, существует ли он. был загружен локально. Драматург может загружать файлы без использования других инструментов.

Скачать официальный файл введенияAPIАдрес документа：Downloads | Playwright Python

2.1 Синтаксис файла загрузки

# Start waiting for the download
with page.expect_download() as download_info:
    # Perform the action that initiates download
    page.get_by_text("Download file").click()
download = download_info.value

# Wait for the download process to complete and save the downloaded file somewhere
download.save_as("/path/to/save/at/" + download.suggested_filename)

Из приведенного выше синтаксиса мы знаем, что playwright предоставляет операцию ожидаемой загрузки() для реализации операций загрузки файлов, но особое внимание следует обратить на то, что при закрытии контекста браузера все загруженные файлы, принадлежащие контексту браузера, будут удалены. Событие загрузки генерируется после начала загрузки. После завершения загрузки путь загрузки станет доступен.

3.Загрузка связанных операций

3.1 Отменить загрузку

Отменить загрузку. Это не произойдет, если загрузка уже завершена или отменена. После успешной отмены функция download.failure() примет значение «отменено».

download.cancel()

3.2 Удаление загрузок

Удалить загруженные файлы. При необходимости он будет ждать завершения загрузки.

download.delete()

3.3 Возврат ошибок загрузки (если есть)

Возвращает ошибки загрузки (если есть). При необходимости он будет ждать завершения загрузки.

download.failure()

3.4 Получить страницу загрузки

Получите страницу, к которой принадлежит загрузка.

download.page

3.5 Путь загрузки

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

Обратите внимание, что имя загруженного файла представляет собой случайный GUID. Используйте download.suggested_filename, чтобы получить предлагаемое имя файла.

download.path() #ReturnNoneType|pathlib.Path тип

3.6 Скопируйте загрузку по указанному пользователем пути.

Копирует загрузку по указанному пользователем пути. Этот метод можно безопасно вызывать, пока загрузка еще продолжается. При необходимости он будет ждать завершения загрузки.

download.save_as(path)

3.7 Верните предложенное имя файла для этой загрузки

Возвращает предложенное имя файла для этой загрузки.

Обычно он используется браузером на основеContent-Dispositionзаголовок ответа илиdownloadСвойства рассчитаны。Видетьwhatwgспецификации на。Разные браузеры могут использовать разную логику для расчета.。

download.suggested_filename

3.8 Возврат загруженного URL

Возвращает загруженный URL.

download.url

4. Проект реального боя

Брат Хонг находится на этом сайте：https://sahitest.com/demo/saveAs.htm Я нашел пример текущего онлайн-файла и хотел бы продемонстрировать его здесь своим друзьям или детям.

4.1 Разработка кода

4.2 Справочный код

# coding=utf-8🔥

# 1. Сначала установите кодировку UTF-8, которая поддерживает китайский и английский языки, как указано выше, обычно они располагаются в первой строке.

# 2. Примечания: включая время создания записи, автора и название проекта.
'''
Created on 2024-05-07
@author: Пекин-Хонге
Публичный аккаунт: Beijing Hongge (поиск WeChat: Beijing Hongge, фокус на Брат Хун, разблокируй больше тестовых предметов заранее! )
Project: Первый взгляд на серию «Последний релиз» — автоматическое тестирование Python+Playwright-58 — Загрузка файла
'''

# 3. Импортировать модули

from playwright.sync_api import Playwright, sync_playwright, expect
def run(playwright: Playwright) -> None:
    browser = playwright.chromium.launch(headless=False)
    context = browser.new_context()
    page = context.new_page()
    page.goto("https://sahitest.com/demo/saveAs.htm")
    page.wait_for_timeout(1000)
    with page.expect_download() as download_info:
        page.get_by_text("testsaveas.zip").click()
    download = download_info.value
    # wait for download to complete
    print(download.url)  # Получить URL-адрес загрузки
    # Этот шаг заключается в том, чтобы просто загрузить его, сгенерировать случайное значение uuid и сохранить его. Оно будет автоматически очищено после выполнения кода.
    print(download.path())
    name = download.suggested_filename # get suggested name
    file = f"download/{name}" # file path    download = download_info.value
    # Наконец, вы можете использовать save_as Сохранить на локальном компьютере
    download.save_as(file) # download file
    page.wait_for_timeout(1000)
    print("browser will be close")
    # page.close()
    # context.close()
    # page.pause()
    browser.close()
with sync_playwright() as playwright:
    run(playwright)

4.3 Запуск кода

1. Запустите код, щелкните правой кнопкой мыши «Выполнить тест», и вы увидите вывод консоли, как показано ниже:

2. Действия браузера на компьютере после запуска кода (скачать файл в левом нижнем углу браузера). Как показано ниже:

3. Вы можете видеть, что файл был успешно загружен по пути загрузки по умолчанию на локальном компьютере Хонге, как показано на рисунке ниже:

5. Резюме

В этой статье в основном рассказывается об использовании драматурга для реализации автоматической загрузки файлов. По сравнению с Selenium, функция загрузки файлов драматурга является более мощной и может быть достигнута без помощи других инструментов. Брат Хонг объясняет и делится файлом загрузки браузера Chrome. Другие браузеры аналогичны. Заинтересованные друзья или дети могут попробовать его сами. Ладно, уже поздно. Начнем с введения и объяснения загружаемого файла драматурга. Спасибо за терпение при чтении! ! !

Я участвую в последнем конкурсе эссе для специального учебного лагеря Tencent Technology Creation 2024. Приходите и разделите со мной приз!