re:re:actable
Урок 015 минут чтения

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

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам