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

Фикстуры и 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 и worker scope.
  • Авто-фикстуры для общих проверок (ошибки консоли).
  • 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 () => {}).

Документация

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

Поиск

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