Volumes и сохранение артефактов

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

Что такое Volumes в Playwright?

Playwright предоставляет инструмент, который позволяет работать с данными, хранящимися в браузере, в том числе в локальном хранилище (LocalStorage), сессионных данных (SessionStorage) и куки. В контексте тестирования на Playwright Volumes представляют собой механизм сохранения и восстановления состояния этих данных между тестами, что позволяет более эффективно повторно использовать их в различных тестовых сценариях.

Этот подход позволяет ускорить выполнение тестов и снизить их зависимость от времени, необходимого для загрузки и подготовки начальных данных в приложении. Он также позволяет избежать необходимости в многократной авторизации и настройки состояния перед каждым тестом.

Настройка Volumes

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

Пример создания и использования Volumes:

const { test, expect, chromium } = require('@playwright/test');

test('сохранение состояния и восстановление сессии', async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();

  // Действия, которые создают состояние
  await page.goto('https://example.com');
  await page.fill('input[name="username"]', 'user');
  await page.fill('input[name="password"]', 'password');
  await page.click('button[type="submit"]');

  // Сохранение состояния в файл
  const storageState = await page.context().storageState();
  await page.context().storageState({ path: 'state.json' });

  await browser.close();

  // Запуск нового теста с восстановлением состояния
  const newBrowser = await chromium.launch();
  const newPage = await newBrowser.newPage();
  const newContext = await newBrowser.newContext({ storageState: 'state.json' });

  await newPage.goto('https://example.com');
  await expect(await newPage.locator('text=Welcome user')).toBeVisible();

  await newBrowser.close();
});

В этом примере создается файл состояния state.json, который сохраняет куки, LocalStorage и SessionStorage. В дальнейшем состояние восстанавливается для нового контекста браузера, что позволяет избежать повторной авторизации и других операций.

Сохранение артефактов для отладки

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

Скриншоты и записи видео являются основными инструментами для визуального анализа тестов. Их можно настраивать как для каждого отдельного теста, так и для всех тестов в целом.

Пример сохранения скриншота и видео в Playwright:

const { test, expect, chromium } = require('@playwright/test');

test('сохранение скриншота и видео', async ({ page }) => {
  // Настройка записи видео
  await page.context().startScreenshot({ path: 'screenshot.png' });
  await page.context().startVideo({ path: 'test-video.mp4' });

  await page.goto('https://example.com');
  await expect(page).toHaveText('Example Domain');

  // Сохранение артефактов
  await page.screenshot({ path: 'example-screenshot.png' });
  await page.video().saveAs('example-video.mp4');
});

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

Настройка сохранения артефактов по умолчанию

В Playwright можно настроить автоматическое сохранение артефактов для каждого теста. Это можно сделать через конфигурационный файл playwright.config.js, где задаются параметры для записи видео, скриншотов и сохранения состояния.

Пример настройки конфигурации для автоматического сохранения артефактов:

// playwright.config.js
module.exports = {
  use: {
    video: 'on-first-retry', // Запись видео только при первой ошибке
    screenshot: 'on-failure', // Снимки экрана только при ошибках
    storageState: 'state.json', // Сохранение состояния по умолчанию
  },
};

В этом примере скриншоты будут сохраняться только в случае ошибки, а видео записываться при первой неудаче теста.

Применение Volumes для ускорения тестов

Одним из основных преимуществ использования Volumes является ускорение выполнения тестов. Если приложение требует времени для настройки состояния (например, авторизация или настройка данных), использование сохраненных данных позволяет избежать повторных затрат времени. Это особенно важно для крупных тестовых наборов, где время на настройку может составлять значительную часть общего времени выполнения.

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

Лучшие практики для работы с Volumes и артефактами

  1. Минимизация объема данных: сохраняйте только те данные, которые критичны для вашего теста. Избегайте сохранения избыточных данных, так как это может повлиять на производительность.

  2. Очистка данных: убедитесь, что состояние не содержит личных или чувствительных данных, таких как пароли. Старайтесь очищать или обнулять эти данные перед их сохранением.

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

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

  5. Интеграция с CI/CD: интегрируйте сохранение артефактов в процессы непрерывной интеграции и доставки. Это позволит вам отслеживать результаты тестирования и быстро реагировать на любые проблемы.

Заключение

Использование Volumes в Playwright для сохранения состояния и управления артефактами тестов позволяет улучшить стабильность и ускорить тестирование, избегая повторных действий и настроек. Благодаря возможности сохранять и восстанавливать состояние браузера, а также автоматизировать процесс записи видео и скриншотов, тесты становятся более предсказуемыми и легче анализируемыми.

Оглавление