Авторизация и состояние: 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 |
Токены в sessionStorage | storageState его не сохраняет — добавить через 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 })для второго пользователя.