Фикстуры и Page Object: структура e2e-тестов
На этой странице
Когда e2e-тестов становится десятки, без структуры они превращаются в копипасту локаторов: поменяли текст кнопки — правим 40 файлов. Два главных инструмента организации в Playwright: Page Object Model (POM) — класс на страницу или крупный компонент, который прячет локаторы и выражает действия на языке предметной области (cart.applyPromo("SALE10"), checkout.payWithTestCard()), и фикстуры — механизм test.extend, который готовит окружение для теста (страницу, пользователя, данные, page objects) и убирает его после, с ленивым созданием и областью видимости test или worker. Правила: page object содержит локаторы и действия, а утверждения — в тестах (или в явно названных методах-проверках), не превращай POM в «бога» на 1000 строк, предпочитай компоненты (Header, ProductCard) крупным страницам, а тесты пиши на уровне пользовательских сценариев. Для повторяющихся шагов внутри теста есть test.step — шаги видны в отчёте и трассе.
Вопрос
Как структурировать e2e-тесты в Playwright? Что такое Page Object Model и фикстуры, и как их сочетать?
Без структуры
// Повторяется в 30 тестах; изменение текста кнопки ломает их все
await page.getByLabel("Промокод").fill("SALE10");
await page.getByRole("button", { name: "Применить" }).click();
await expect(page.getByTestId("cart-total")).toHaveText("2 691 ₽");Page Object
// e2e/pages/cart-page.ts
import type { Page, Locator } from "@playwright/test";
export class CartPage {
readonly heading: Locator;
readonly total: Locator;
readonly promoInput: Locator;
readonly checkoutButton: Locator;
constructor(private readonly page: Page) {
this.heading = page.getByRole("heading", { name: "Корзина" });
this.total = page.getByTestId("cart-total");
this.promoInput = page.getByLabel("Промокод");
this.checkoutButton = page.getByRole("button", { name: "Оформить заказ" });
}
async goto() {
await this.page.goto("/cart");
}
item(title: string) {
return this.page.getByRole("listitem").filter({ hasText: title });
}
async applyPromo(code: string) {
await this.promoInput.fill(code);
await this.page.getByRole("button", { name: "Применить" }).click();
}
async removeItem(title: string) {
await this.item(title).getByRole("button", { name: "Удалить" }).click();
}
}test("промокод уменьшает сумму на 10%", async ({ page }) => {
const cart = new CartPage(page);
await cart.goto();
await cart.applyPromo("SALE10");
await expect(cart.total).toHaveText("2 691 ₽"); // утверждение в тесте
});Фикстуры
// e2e/fixtures.ts
import { test as base, expect } from "@playwright/test";
import { CartPage } from "./pages/cart-page";
import { CatalogPage } from "./pages/catalog-page";
import { createProduct, deleteProduct, type Product } from "./api/products";
type Fixtures = {
cartPage: CartPage;
catalogPage: CatalogPage;
product: Product; // тестовый товар, созданный через API
};
export const test = base.extend<Fixtures>({
cartPage: async ({ page }, use) => {
await use(new CartPage(page));
},
catalogPage: async ({ page }, use) => {
await use(new CatalogPage(page));
},
product: async ({ request }, use) => {
const product = await createProduct(request, { title: `Чайник ${crypto.randomUUID().slice(0, 8)}`, price: 2990 });
await use(product); // ← тест выполняется здесь
await deleteProduct(request, product.id); // очистка после теста
},
});
export { expect };// e2e/cart.customer.spec.ts
import { test, expect } from "./fixtures";
test("товар можно удалить из корзины", async ({ page, catalogPage, cartPage, product }) => {
await catalogPage.addToCart(product.title);
await cartPage.goto();
await cartPage.removeItem(product.title);
await expect(cartPage.item(product.title)).toHaveCount(0);
await expect(page.getByText("Корзина пуста")).toBeVisible();
});Фикстуры ленивые: product создаётся, только если тест его запрашивает. Встроенные фикстуры: page, context, browser, request, baseURL, browserName.
Опции и автоматические фикстуры
export const test = base.extend<{ locale: string; failOnConsoleError: void }>({
locale: ["ru-RU", { option: true }], // переопределяется в конфиге проекта
failOnConsoleError: [async ({ page }, use) => {
const errors: string[] = [];
page.on("pageerror", (e) => errors.push(e.message));
page.on("console", (m) => m.type() === "error" && errors.push(m.text()));
await use();
expect(errors, "ошибки в консоли браузера").toEqual([]);
}, { auto: true }], // применяется ко всем тестам
});test.step
test("оформление заказа", async ({ page, cartPage, product }) => {
await test.step("добавить товар в корзину", async () => { /* … */ });
await test.step("заполнить адрес доставки", async () => { /* … */ });
await test.step("оплатить тестовой картой", async () => { /* … */ });
await expect(page.getByRole("heading", { name: /Заказ №\d+ оформлен/ })).toBeVisible();
});Шаги отображаются в HTML-отчёте и Trace Viewer — сразу видно, на каком шаге упало.
Структура папок
e2e/
├── fixtures.ts ← test.extend: page objects, данные, авто-фикстуры
├── auth.setup.ts ← вход, storageState
├── pages/ ← page objects страниц
│ ├── cart-page.ts
│ └── checkout-page.ts
├── components/ ← переиспользуемые части: header, product-card, dialog
├── api/ ← хелперы создания данных через API
├── data/ ← константы: тестовые карты, адреса
└── specs/
├── checkout.customer.spec.ts
├── catalog.guest.spec.ts
└── admin-users.admin.spec.tsАнти-паттерны
| Анти-паттерн | Лучше |
|---|---|
| POM-«бог» со всеми действиями приложения | Небольшие page objects и компоненты |
Утверждения спрятаны в действиях (login() проверяет 5 вещей) | Утверждения в тесте, понятные при падении |
| Наследование page objects в 4 уровня | Композиция: страница содержит компоненты |
| Тесты зависят друг от друга (второй использует данные первого) | Каждый тест готовит своё через фикстуры |
Хелперы с if (isMobile) внутри | Разные проекты/page objects для разных платформ |
| Локаторы через CSS-классы | Роли и доступные имена |
Что важно помнить
- Page object = локаторы + действия на языке предметной области.
- Утверждения — в тестах.
- Фикстуры готовят и убирают окружение, ленивые, бывают
testиworkerscope. - Авто-фикстуры для общих проверок (ошибки консоли).
test.stepделает отчёты читаемыми.
Мини-шпаргалка
class CartPage { constructor(page) { this.total = page.getByTestId(...) } }.base.extend({ name: async ({ page }, use) => { …; await use(x); …cleanup } }).{ scope: "worker" },{ auto: true },{ option: true }.await test.step("…", async () => {}).