Группировка тестов describe блоками

Группировка тестов в Playwright с использованием блоков describe

Playwright — это мощный инструмент для автоматизации браузеров, который позволяет проводить тестирование веб-приложений в различных браузерах. Одной из важнейших особенностей Playwright является возможность организовывать тесты в логичные и структурированные блоки, что значительно облегчает чтение и поддержку тестов.

Один из таких способов группировки тестов — использование блоков describe. Этот механизм позволяет объединить несколько тестов в одну группу, что дает возможность настраивать общий контекст для всех тестов в группе и улучшает читаемость тестов.

В Playwright, как и в других библиотеках тестирования на JavaScript, используется блок describe, который служит для логической группировки тестов. Блоки describe позволяют создать описание набора тестов, указывающее на их взаимосвязь или общую цель.

Пример базовой структуры:

describe('Тестирование страницы входа', () => {
  test('Проверка формы входа с правильными данными', async ({ page }) => {
    // тестовый код
  });

  test('Проверка формы входа с неверными данными', async ({ page }) => {
    // тестовый код
  });
});

В этом примере два теста, которые связаны с тестированием страницы входа. Группа тестов (блок describe) определяет, что все эти тесты относятся к одной функциональности — проверке формы входа.

Вложенные блоки describe

В Playwright возможно создание вложенных блоков describe, что позволяет еще более детально организовывать тесты, особенно когда проект становится более сложным и требует более точного разделения тестов по категориям.

describe('Тестирование страницы входа', () => {
  describe('Проверка правильных данных', () => {
    test('Проверка успешного входа', async ({ page }) => {
      // тестовый код
    });

    test('Проверка редиректа на главную страницу', async ({ page }) => {
      // тестовый код
    });
  });

  describe('Проверка неправильных данных', () => {
    test('Ошибка при вводе неверного пароля', async ({ page }) => {
      // тестовый код
    });

    test('Ошибка при вводе неверного логина', async ({ page }) => {
      // тестовый код
    });
  });
});

Такой подход помогает организовать тесты по категориям, разделяя их по логическим блокам, например, по типу данных (правильные и неправильные данные).

Использование beforeAll, afterAll, beforeEach и afterEach в describe

Для настройки общего контекста или выполнения действий до или после всех тестов в группе можно использовать функции beforeAll, afterAll, beforeEach и afterEach. Эти функции полезны для подготовки среды тестирования или для очистки состояния после выполнения тестов.

  • beforeAll выполняется один раз перед всеми тестами в группе.
  • afterAll выполняется один раз после всех тестов в группе.
  • beforeEach выполняется перед каждым тестом в группе.
  • afterEach выполняется после каждого теста в группе.

Пример использования:

describe('Тестирование страницы входа', () => {
  beforeAll(async () => {
    // Выполняется один раз перед всеми тестами
    console.log('Подготовка к тестам');
  });

  afterAll(async () => {
    // Выполняется один раз после всех тестов
    console.log('Очистка после тестов');
  });

  beforeEach(async () => {
    // Выполняется перед каждым тестом
    console.log('Подготовка перед тестом');
  });

  afterEach(async () => {
    // Выполняется после каждого теста
    console.log('Очистка после теста');
  });

  test('Проверка формы входа с правильными данными', async ({ page }) => {
    // тестовый код
  });

  test('Проверка формы входа с неверными данными', async ({ page }) => {
    // тестовый код
  });
});

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

Группировка с использованием параметризации

Еще одной полезной техникой является параметризация тестов внутри блока describe. Это позволяет запускать один и тот же тест с различными наборами данных, что повышает покрытие и эффективность тестирования.

describe('Тестирование формы входа', () => {
  const testCases = [
    { login: 'user1', password: 'pass1', shouldPass: true },
    { login: 'user2', password: 'wrongpass', shouldPass: false }
  ];

  testCases.forEach(({ login, password, shouldPass }) => {
    test(`Проверка входа для ${login}`, async ({ page }) => {
      // тестовый код с использованием login и password
      if (shouldPass) {
        // проверка успешного входа
      } else {
        // проверка ошибки входа
      }
    });
  });
});

Параметризация позволяет уменьшить количество повторяющегося кода и эффективно проверять различные сценарии с использованием разных данных.

Использование фокусов и исключений

Во время разработки тестов часто требуется сфокусироваться на определенных тестах, исключая остальные из выполнения. Для этого используются функции test.only и test.skip.

  • test.only позволяет выполнить только этот тест, игнорируя все остальные в блоке.
  • test.skip пропускает выполнение теста, но оставляет его в коде.

Пример:

describe('Тестирование формы входа', () => {
  test('Проверка формы с правильными данными', async ({ page }) => {
    // тестовый код
  });

  test.only('Проверка формы с неверными данными', async ({ page }) => {
    // тестовый код
  });

  test.skip('Проверка формы с пустыми данными', async ({ page }) => {
    // тестовый код
  });
});

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

Вывод

Группировка тестов с использованием блоков describe позволяет организовать тесты в Playwright, делая их более читаемыми, управляемыми и структурированными. Такой подход помогает не только улучшить качество кода тестов, но и повысить их поддерживаемость в будущем.

Оглавление