Фильтрация тестов

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

Фильтрация тестов с помощью флагов командной строки

Один из самых простых и распространённых способов фильтрации тестов в Jest — это использование флагов командной строки. Jest предоставляет несколько флагов, которые позволяют настроить, какие тесты будут выполнены.

1. Флаг --testNamePattern

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

jest --testNamePattern="login"

Этот флаг примет регулярное выражение, которое будет использовано для поиска в именах тестов. Например, в данном случае будут выполнены только те тесты, которые содержат слово “login” в своём описании.

Флаг --testNamePattern полезен, если необходимо ограничить запуск тестов по определённой группе функций или методам.

2. Флаг --testPathPattern

Если тесты распределены по папкам и нужно запустить тесты только в определённых директориях, то используется флаг --testPathPattern. Этот флаг позволяет указать путь, по которому Jest будет искать и выполнять тесты. Например:

jest --testPathPattern="src/utils"

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

3. Флаг --onlyChanged

Когда код был изменён, и требуется выполнить только те тесты, которые связаны с изменениями, можно использовать флаг --onlyChanged. Он автоматически определит файлы, которые были изменены с момента последнего коммита, и выполнит только те тесты, которые затрагивают эти файлы.

jest --onlyChanged

Этот флаг особенно полезен в больших проектах, где тестов может быть много, а запускать все тесты на каждом изменении может быть неэффективно.

Использование .only для фокусировки на тестах

Jest поддерживает возможность “фокусировки” на отдельных тестах, чтобы выполнить только их, игнорируя остальные. Для этого используется метод .only. Этот метод можно применить как к отдельным тестам, так и к целым группам тестов.

1. Фокусировка на отдельных тестах

Чтобы выполнить только один тест, можно использовать метод .only:

test.only('Тест на успешный вход', () => {
  expect(authenticate('user', 'password')).toBe(true);
});

При этом Jest выполнит только этот тест, пропуская все остальные.

2. Фокусировка на группе тестов

Если нужно сосредоточиться на группе тестов, то можно применить .only к группе, например, к describe:

describe.only('Тесты аутентификации', () => {
  test('Успешная авторизация', () => {
    expect(authenticate('user', 'password')).toBe(true);
  });

  test('Неуспешная авторизация', () => {
    expect(authenticate('user', 'wrong-password')).toBe(false);
  });
});

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

Использование .skip для пропуска тестов

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

1. Пропуск отдельного теста

test.skip('Тест на неправильный вход', () => {
  expect(authenticate('user', 'wrong-password')).toBe(false);
});

Этот тест не будет выполнен, но код останется в проекте.

2. Пропуск группы тестов

describe.skip('Тесты регистрации', () => {
  test('Тест на создание пользователя', () => {
    expect(createUser('newuser')).toBe(true);
  });
});

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

Фильтрация с использованием кастомных меток

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

1. Использование меток в тестах

test('Тест на авторизацию', () => {
  expect(authenticate('user', 'password')).toBe(true);
}).tag('auth');

Затем можно настроить запуск тестов, содержащих метки:

jest --testNamePattern="auth"

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

Конфигурация фильтрации тестов

Для более сложных сценариев фильтрации тестов, например, для интеграции с CI/CD пайплайнами или настройкой глобальных флагов, можно использовать конфигурацию Jest. В конфигурационном файле jest.config.js можно настроить параметры, которые будут использоваться для фильтрации тестов.

Пример настройки jest.config.js:

module.exports = {
  testMatch: ['**/?(*.)+(spec|test).[tj]s?(x)'], // Определение шаблона для тестовых файлов
  testPathIgnorePatterns: ['/node_modules/', '/dist/'], // Игнорирование определённых путей
  testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.js$', // Шаблон для тестов
};

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

Заключение

Фильтрация тестов в Jest — мощный инструмент, который позволяет разработчикам гибко настраивать запуск тестов в зависимости от нужд проекта. Использование командных флагов, аннотаций, меток и конфигурации позволяет быстро и эффективно управлять тестовым процессом. Эти возможности делают Jest идеальным инструментом для тестирования в проектах любой сложности.

Оглавление