Playwright: основы, локаторы и автоожидания
На этой странице
Playwright — стандарт e2e-тестирования веба: один API для Chromium, Firefox и WebKit (включая эмуляцию мобильных устройств), встроенный тест-раннер @playwright/test с параллельностью, ретраями, фикстурами и отчётами. Его главные идеи: локаторы — «ленивое» описание элемента (page.getByRole("button", { name: "Купить" })), которое ищет элемент заново при каждом действии, поэтому не устаревает после перерендера; автоожидание (auto-waiting) — перед кликом Playwright сам ждёт, пока элемент появится, станет видимым, стабильным (без анимации), включённым и сможет принять событие; web-first утверждения — await expect(locator).toBeVisible() / toHaveText() повторяют проверку до успеха или таймаута. Поэтому в Playwright-тестах не нужны sleep и ручные ожидания. Для поиска используй те же приоритеты, что в Testing Library: getByRole, getByLabel, getByText, и getByTestId как запасной вариант. Инструменты: codegen (запись действий), UI mode (--ui), Trace Viewer (покадровая запись упавшего теста) и VS Code-расширение.
Вопрос
Что такое Playwright и чем он удобен для e2e-тестов? Что такое локаторы, автоожидание и web-first assertions?
Установка
pnpm create playwright # конфиг, пример теста, GitHub Actions workflow
pnpm exec playwright install --with-deps chromium
pnpm exec playwright test # прогон
pnpm exec playwright test --ui # интерактивный режим
pnpm exec playwright codegen http://localhost:3000 # записать сценарий
pnpm exec playwright show-reportПервый тест
// e2e/checkout.spec.ts
import { test, expect } from "@playwright/test";
test("покупатель добавляет товар в корзину и видит сумму", async ({ page }) => {
await page.goto("/catalog/kettles");
await page.getByRole("link", { name: "Электрический чайник Aqua" }).click();
await expect(page).toHaveURL(/\/product\/aqua-kettle/);
await page.getByRole("button", { name: "В корзину" }).click();
await expect(page.getByRole("status", { name: "Товаров в корзине" })).toHaveText("1");
await page.getByRole("link", { name: "Корзина" }).click();
await expect(page.getByRole("heading", { name: "Корзина" })).toBeVisible();
await expect(page.getByTestId("cart-total")).toHaveText("2 990 ₽");
});Локаторы
page.getByRole("button", { name: "Оформить заказ" });
page.getByRole("heading", { level: 1 });
page.getByRole("checkbox", { name: "Согласен с условиями" });
page.getByLabel("Email");
page.getByPlaceholder("Поиск");
page.getByText("Заказ оформлен"); // подстрока; { exact: true } для точного
page.getByAltText("Логотип");
page.getByTestId("price-chart"); // data-testid по умолчанию
// Цепочки и фильтры
page.getByRole("listitem").filter({ hasText: "Чайник" }).getByRole("button", { name: "Удалить" });
page.getByRole("row").filter({ has: page.getByText("Заказ №42") });
page.getByRole("button", { name: "Удалить" }).first(); // осторожно: хрупко
page.getByRole("option").nth(2);
// Комбинирование
page.getByRole("button", { name: "Сохранить" }).or(page.getByRole("button", { name: "Save" }));
page.getByRole("button").and(page.getByTitle("Подписаться"));Строгость: если локатор для действия нашёл больше одного элемента, Playwright бросит ошибку (strict mode) — это защищает от клика «не туда». Уточняй локатор, а не добавляй .first() по привычке.
CSS и XPath (page.locator(".btn-primary")) возможны, но хрупки: привязаны к вёрстке.
Автоожидание действий
Перед click() Playwright ждёт, пока элемент:
| Проверка | Значение |
|---|---|
| Attached | Есть в DOM |
| Visible | Виден (не display: none, ненулевой размер) |
| Stable | Не анимируется (координаты не меняются два кадра) |
| Receives events | Не перекрыт другим элементом (оверлей, модалка) |
| Enabled | Не disabled |
Если условие не выполнилось за actionTimeout, тест падает с понятным сообщением, например «element is covered by