Сквозные тесты: Playwright
Сквозные (E2E) тесты с Playwright: локаторы, автоожидание, проверки, просмотр трассировки и запуск в CI.
Что такое E2E
Сквозной тест управляет настоящим браузером: открывает страницу, кликает, вводит текст и проверяет, что пользователь видит нужное. Такие тесты медленнее модульных, зато проверяют приложение целиком. Playwright — один из популярных инструментов для этого; у него есть собственная документация и много возможностей, мы посмотрим основу. С модульным тестированием вы уже знакомились в предыдущих модулях.
Установка
npm init playwright@latest
npx playwright test
npx playwright show-report
Мастер создаст конфигурацию playwright.config, папку для тестов и пример. Браузеры (Chromium, Firefox, WebKit) загружаются отдельно.
Первый тест
import { test, expect } from "@playwright/test";
test("поиск находит статью", async ({ page }) => {
await page.goto("https://example.com/");
await page.getByRole("textbox", { name: "Поиск" }).fill("javascript");
await page.getByRole("button", { name: "Найти" }).click();
await expect(page.getByRole("heading", { level: 1 })).toContainText("javascript");
});
Локаторы
Локатор описывает, как найти элемент. Playwright советует искать так, как это делает пользователь:
| Локатор | Что ищет |
|---|---|
getByRole | по роли и доступному имени (кнопка, ссылка, заголовок) |
getByLabel | поле по тексту подписи |
getByText | по видимому тексту |
getByTestId | по атрибуту data-testid |
locator("css") | по CSS-селектору, когда другого пути нет |
Локаторы по роли заодно проверяют доступность интерфейса, а не ломаются от смены CSS-классов.
Автоожидание и проверки
Playwright сам ждёт, пока элемент появится и станет доступен для действия, — не нужны sleep и ручные таймеры. Проверки expect с веб-ориентированными методами тоже повторяются до таймаута:
await expect(page.getByText("Сохранено")).toBeVisible();
await expect(page).toHaveURL(/\/profile/);
await expect(page.getByRole("listitem")).toHaveCount(3);
Не используйте фиксированные паузы вроде page.waitForTimeout(3000) — тесты станут медленными и всё равно нестабильными.
Trace Viewer и CI
Трассировка записывает шаги теста со снимками страницы, сетью и консолью. Включается в конфигурации, например «при первой повторной попытке»:
// playwright.config.js
import { defineConfig } from "@playwright/test";
export default defineConfig({
retries: process.env.CI ? 2 : 0,
use: {
baseURL: "http://localhost:3000",
trace: "on-first-retry",
},
});
Открыть файл трассировки можно командой npx playwright show-trace trace.zip. В CI (например, GitHub Actions) обычно ставят браузеры командой npx playwright install --with-deps, запускают тесты и сохраняют отчёт как артефакт, чтобы смотреть упавшие прогоны.
E2E-тестов должно быть немного: покройте ими главные пользовательские сценарии (вход, оформление заказа), а детали оставьте быстрым модульным тестам.
Установите Playwright в любой проект и напишите тест для страницы (можно https://example.com/): откройте её и проверьте заголовок h1 через getByRole. Запустите с флагом --ui или откройте отчёт через show-report.
Оглавление курса
Модуль 1Старт10
- 1Что такое JavaScript и где он работает
- 2Инструменты: редактор и консоль браузера
- 3Первый скрипт: script, console.log и Node.js
- 4Переменные: let, const и var
- 5Типы данных
- 6Числа и объект Math
- 7Строки и шаблонные литералы
- 8Комментарии, стиль кода и точка с запятой
- 9Браузер и Node.js: чем отличаются среды
- 10История языка и стандарт ECMAScript
Модуль 2Операторы и управление потоком10
Модуль 3Функции10
Модуль 4Объекты и массивы10
Модуль 5Строки, числа, даты и данные10
Модуль 6DOM и события10
Модуль 7Браузерные API10
Модуль 8Прототипы и классы10
Модуль 9Асинхронность10
Модуль 10Модули и инструменты10
Модуль 11Продвинутые возможности10
Модуль 12Ошибки, тесты и безопасность10
Модуль 13Node.js10
Модуль 14Экосистема и фреймворки10
- 131TypeScript: типы в повседневной работе
- 132React: обзор
- 133Vue и Svelte: обзор
- 134Управление состоянием: обзор
- 135Мета-фреймворки: Next.js, Nuxt, SvelteKit
- 136Современные инструменты сборки
- 137Сквозные тесты: Playwright
- 138Паттерны проектирования в JavaScript
- 139Архитектура больших приложений
- 140Безопасность зависимостей
Модуль 15Профи10
- 141Движок V8 и JIT-компиляция
- 142Память и сборка мусора
- 143Event Loop глубже: микрозадачи и макрозадачи
- 144Производительность и Web Vitals
- 145Вопросы на собеседовании по JavaScript
- 146Алгоритмы и структуры данных на JavaScript
- 147Код-ревью
- 148Вклад в open source
- 149Дипломный проект: разработка
- 150Дипломный проект: защита и итоги
