Изоляция тестов Playwright и контекст браузера

В этой главе представлен механизм изоляции тестов Playwright и концепция Browser Context — ключевой дизайн для обеспечения стабильных и надёжных тестов.


Что такое изоляция тестов

Изоляция тестов означает, что каждый тестовый пример выполняется вполностью независимойсреде и они не влияют друг на друга.

В Playwright каждый тест автоматически получает независимый `BrowserContext`Контекст браузера(контекст браузера).


Что такое контекст браузера

Контекст браузера эквивалентенсовершенно новому профилю браузера。

Создание контекста похоже на открытие совершенно нового окна браузера с собственными Cookie, localStorage и sessionStorage, но с чрезвычайно низкими накладными расходами (уровня миллисекунд).

КонцепцияАналогияОписание
Браузер (экземпляр браузера)Открывает программу браузераВысокие накладные расходы; обычно создаётся только один раз за весь прогон тестов
Контекст браузера (контекст браузера)Независимый профиль в браузереНизкие накладные расходы; по одному на каждый тест
Page (вкладка)Вкладка в браузереОткрывает страницы в контексте

`page` в каждом тестеpageиcontextсоздаётся с нуля, поэтому если один тест изменяет localStorage или Cookie, это не повлияет на другие тесты.


Что изолирует контекст

Следующее содержимое полностью изолировано между каждым контекстом браузера:

Элемент изоляцииОписание
CookiesКаждый контекст имеет независимое хранилище Cookie
localStorageЛокальное хранилище полностью изолировано
sessionStorageСессионное хранилище полностью изолировано
IndexedDBИзоляция базы данных браузера
КэшированиеИзоляция HTTP-кэша

Пример

// Тест A устанавливает Cookie
test('Тест A', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // Установите Cookie (действует только в текущем контексте)
  await page.context().addCookies([{
    name: 'example_session',
    value: 'abc123',
    domain: 'www.example.com',
    path: '/',
  }]);

  // Последующие операции используют этот Cookie
});

// Тест B получает совершенно новый контекст без Cookie, установленного тестом A
test('Тест B', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // context().cookies() возвращает пустой массив
  const cookies = await page.context().cookies();
  console.log(cookies); // []
});

Использование фикстуры context

Помимо `page`page, тестовая функция также может получить доступ кcontextфикстуре `context` для операций уровня Context.

Пример

test('Использование фикстуры context', async ({ context, page }) => {
  // Установить разрешения на уровне Context
  await context.grantPermissions(['geolocation']);
  await context.setGeolocation({ latitude: 39.9, longitude: 116.4 });

  // Перехватывать сетевой трафик на уровне Context
  await context.route('**/*.{png,jpg,jpeg}', route => route.abort());

  // page находится в том же контексте и наследует вышеуказанные настройки
  await page.goto('https://www.example.com/');
});

Сценарии с несколькими контекстами

Когда нужно смоделировать несколько независимых пользователей в одном тесте, можно вручную создавать контексты.

Пример

test('Два пользователя работают независимо', async ({ browser }) => {
  // Создайте независимые контексты для двух пользователей
  const userAContext = await browser.newContext();
  const userBContext = await browser.newContext();

  // Страницы двух пользователей полностью изолированы
  const pageA = await userAContext.newPage();
  const pageB = await userBContext.newPage();

  await pageA.goto('https://www.example.com/login');
  await pageB.goto('https://www.example.com/login');

  // Пользователь A входит в систему
  await pageA.getByLabel('Username').fill('user_a');
  await pageA.getByLabel('Password').fill('password_a');
  await pageA.getByRole('button', { name: 'Login' }).click();

  // Пользователь B входит в систему (у каждого независимые Cookie/Session, не влияющие друг на друга)
  await pageB.getByLabel('Username').fill('user_b');
  await pageB.getByLabel('Password').fill('password_b');
  await pageB.getByRole('button', { name: 'Login' }).click();

  // Очистка
  await userAContext.close();
  await userBContext.close();
});

Преимущества изоляции тестов

1. Воспроизводимость

Каждый тест начинается с одного и того же начального состояния и даёт стабильные результаты независимо от порядка выполнения.

2. Предотвращает каскадные сбои

Сбой теста A не приведёт к сбою теста B; каждый тест можно отлаживать независимо.

3. Поддерживает параллельное выполнение

Поскольку тесты полностью независимы, Playwright может безопасно запускать их параллельно на нескольких воркерах.

Изоляция тестов — поведение Playwright по умолчанию; каждыйtest()`test` автоматически получает независимыйpageиcontext`BrowserContext`, без необходимости какой-либо дополнительной настройки.

Другие расширения