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

Авторизация и состояние: storageState и setup-проекты

На этой странице
Кратко

Почти все e2e-сценарии требуют вошедшего пользователя. Логиниться через форму в каждом тесте медленно и хрупко, поэтому в Playwright вход выполняют один раз в setup-проекте, сохраняют cookie и localStorage в файл через storageState, а тестовые проекты начинают с этим состоянием — уже авторизованными. Для нескольких ролей (покупатель, админ, менеджер) сохраняют отдельные файлы и выбирают нужный через test.use({ storageState }) или разные проекты. Для тестов, где пользователи не должны мешать друг другу (меняют профиль, корзину), создают отдельного пользователя на воркер через фикстуру. Вход лучше выполнять через API (быстрее и стабильнее), а форму логина проверить одним отдельным тестом. Файлы состояния содержат сессионные cookie — их добавляют в .gitignore, а тестовые учётные данные берут из переменных окружения CI.

Вопрос

Как организовать авторизацию в e2e-тестах Playwright, чтобы не логиниться в каждом тесте? Как тестировать разные роли пользователей?

Setup-проект и storageState

// e2e/auth.setup.ts
import { test as setup, expect } from "@playwright/test";
 
const customerFile = "e2e/.auth/customer.json";
const adminFile = "e2e/.auth/admin.json";
 
setup("вход покупателя", async ({ page }) => {
  await page.goto("/login");
  await page.getByLabel("Email").fill(process.env.E2E_CUSTOMER_EMAIL!);
  await page.getByLabel("Пароль").fill(process.env.E2E_CUSTOMER_PASSWORD!);
  await page.getByRole("button", { name: "Войти" }).click();
  await expect(page.getByRole("button", { name: "Профиль" })).toBeVisible();   // дождаться входа
  await page.context().storageState({ path: customerFile });
});
 
setup("вход администратора через API", async ({ request }) => {
  const res = await request.post("/api/auth/sign-in", {
    data: { email: process.env.E2E_ADMIN_EMAIL, password: process.env.E2E_ADMIN_PASSWORD },
  });
  expect(res.ok()).toBeTruthy();
  await request.storageState({ path: adminFile });     // cookie из ответа сохраняются
});
// playwright.config.ts
projects: [
  { name: "setup", testMatch: /.*\.setup\.ts/ },
  {
    name: "customer",
    testMatch: /.*\.customer\.spec\.ts/,
    use: { ...devices["Desktop Chrome"], storageState: "e2e/.auth/customer.json" },
    dependencies: ["setup"],
  },
  {
    name: "admin",
    testMatch: /.*\.admin\.spec\.ts/,
    use: { ...devices["Desktop Chrome"], storageState: "e2e/.auth/admin.json" },
    dependencies: ["setup"],
  },
  {
    name: "guest",
    testMatch: /.*\.guest\.spec\.ts/,
    use: { ...devices["Desktop Chrome"] },   // без авторизации
  },
],
e2e/.auth/

Роль в отдельном файле или тесте

// Внутри одного файла
test.describe("админка", () => {
  test.use({ storageState: "e2e/.auth/admin.json" });
  test("видит раздел «Пользователи»", async ({ page }) => { /* … */ });
});
 
test.describe("гость", () => {
  test.use({ storageState: { cookies: [], origins: [] } });   // сбросить авторизацию
  test("перенаправляется на вход", async ({ page }) => {
    await page.goto("/account");
    await expect(page).toHaveURL(/\/login\?next=%2Faccount/);
  });
});

Два пользователя в одном тесте

test("админ блокирует пользователя, и тот теряет доступ", async ({ browser }) => {
  const adminContext = await browser.newContext({ storageState: "e2e/.auth/admin.json" });
  const userContext = await browser.newContext({ storageState: "e2e/.auth/customer.json" });
  const admin = await adminContext.newPage();
  const user = await userContext.newPage();
 
  await admin.goto("/admin/users");
  await admin.getByRole("row", { name: /customer@/ }).getByRole("button", { name: "Заблокировать" }).click();
 
  await user.goto("/account");
  await expect(user).toHaveURL(/\/login/);
 
  await adminContext.close();
  await userContext.close();
});

Контексты браузера изолированы (как разные профили), поэтому так удобно проверять чаты, совместное редактирование и права.

Пользователь на воркер

Если тесты меняют данные пользователя (корзина, настройки), общий аккаунт приведёт к конфликтам при параллельном запуске. Решение — создавать аккаунт на каждый воркер:

// e2e/fixtures.ts
import { test as base, expect } from "@playwright/test";
import { randomUUID } from "node:crypto";
 
export const test = base.extend<{}, { workerStorageState: string }>({
  storageState: ({ workerStorageState }, use) => use(workerStorageState),
 
  workerStorageState: [async ({ browser }, use, workerInfo) => {
    const file = `e2e/.auth/worker-${workerInfo.parallelIndex}.json`;
    const page = await browser.newPage({ storageState: undefined, baseURL: workerInfo.project.use.baseURL });
    const email = `e2e-${workerInfo.parallelIndex}-${randomUUID()}@example.com`;
 
    const res = await page.request.post("/api/test/users", { data: { email, password: "Test_Password_123" } }); // тестовый эндпоинт
    expect(res.ok()).toBeTruthy();
    await page.request.post("/api/auth/sign-in", { data: { email, password: "Test_Password_123" } });
    await page.context().storageState({ path: file });
    await page.close();
    await use(file);
  }, { scope: "worker" }],
});
 
export { expect };

Что не забыть

ВопросРешение
Сессия истекает в долгих прогонахВремя жизни тестовой сессии больше времени прогона или повторный setup
Токены в sessionStoragestorageState его не сохраняет — добавить через addInitScript
2FA / капча на входеОтключить в тестовом окружении или тестовый обход по секрету окружения
OAuth-провайдер (Google и т. п.)Не логиниться через чужой продакшен-сервис; тестовый провайдер или вход по паролю/API в test-окружении
СекретыПеременные окружения CI; .auth/ в .gitignore
Проверка самого логинаОтдельный тест формы входа (гостевой проект)

Что важно помнить

  • Логин один раз в setup-проекте, состояние в storageState.
  • Вход через API быстрее и стабильнее, форму входа проверяет отдельный тест.
  • Разные роли — разные файлы состояния и проекты.
  • Несколько контекстов браузера — несколько пользователей в одном тесте.
  • Изменяемые данные — отдельный пользователь на воркер.

Мини-шпаргалка

  • page.context().storageState({ path }) / request.storageState({ path }).
  • projects: [{ name: "setup" }, { dependencies: ["setup"], use: { storageState } }].
  • test.use({ storageState }), сброс: { cookies: [], origins: [] }.
  • browser.newContext({ storageState }) для второго пользователя.

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

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

Поиск

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