Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Jest и Vitest: юнит-тесты для фронтендера — что проверять, как писать и где научиться

Jest и Vitest — фреймворки, на которых фронтенд-разработчик пишет юнит-тесты к своему коду на JavaScript и TypeScript. Тест вызывает функцию или отрисовывает компонент, сравнивает результат с ожидаемым через expect, подменяет сеть и соседние модули моками и падает, если поведение изменилось. Vitest естественно встраивается в проекты на Vite, Jest чаще встречается в проектах постарше, а API у них почти одинаковый. Ниже — что проверять, учебный пример с формой промокода, ошибки с моками, снапшотами и покрытием, порядок освоения и выбор обучения.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Jest и Vitest: юнит-тесты для фронтендера — что проверять, как писать и где научиться

Распространённое заблуждение — считать, что тесты пишет тестировщик. Юнит-тесты пишет автор кода, обычно в том же коммите: рядом с price.ts лежит price.test.ts, а CI не даёт влить изменения с упавшим тестом. Первая задача новичка скромна: покрыть тестами функцию форматирования цены или валидатор формы, которые уже ломались после чужих правок.

Что проверять юнит-тестами во фронтенде

Юнит-тест проверяет небольшой кусок кода в изоляции и выполняется за миллисекунды. Хорошо тестируются чистые функции: форматирование дат и сумм, разбор ответа API, валидация полей, редьюсеры. Следующий слой — хуки и компоненты: тест отрисовывает компонент в имитации браузера, выполняет действие пользователя и проверяет, что изменилось на экране или какой запрос ушёл.

Тестировать стоит поведение, а не устройство кода. Проверка «после клика по кнопке „Применить“ появилась надпись о скидке» переживёт рефакторинг, а проверка внутреннего флага isLoading сломается при любой перестановке. На этом построена Testing Library: её документация о запросах советует искать элементы так, как их находит человек. Первым в списке приоритетов идёт getByRole, работающий по дереву доступности, последним — getByTestId, потому что такие атрибуты пользователь не видит и не слышит.

У юнит-тестов есть граница. Сценарий «войти, положить товар в корзину, оплатить» в настоящем браузере — задача сквозных тестов на Playwright или Cypress, это тема наших материалов об автоматизации тестирования. Юнит-тест не заметит, что бэкенд поменял формат ответа, зато за секунды покажет, какая функция сломалась.

Jest или Vitest

Если проект собран на Vite, разумно брать Vitest: он использует тот же конфиг, алиасы и преобразование TypeScript, отдельный Babel не нужен. Актуальная ветка — Vitest 5 (в документации значится 5.0.4), и по руководству по миграции ей нужны Node.js 22.12+ и Vite от 6.4. Jest остаётся стандартом в проектах на Webpack и в коде, написанном до Vite; его документация описывает версию 30.5.

Переход между ними несложен: describe, it, expect и большинство матчеров совпадают, jest.fn() превращается в vi.fn(), jest.mock() — в vi.mock(). Важнее знать настройки по умолчанию. В обоих фреймворках тесты идут в среде Node.js без DOM: у Jest testEnvironment равен node, у Vitest, по описанию опции environment, тоже. Для компонентов нужно включить jsdom или happy-dom, иначе первый render упадёт на отсутствующем document.

Учебный пример: форма промокода

Учебная задача: в корзине есть поле промокода и кнопка «Применить». Код нужно очистить от пробелов, привести к верхнему регистру, отклонить, если он не из шести латинских букв и цифр, отправить на сервер и показать скидку. Нормализацию выносим в отдельную функцию — её проще проверить без интерфейса.

export function normalizePromo(raw: string): string | null {
  const code = raw.trim().toUpperCase();
  return /^[A-Z0-9]{6}$/.test(code) ? code : null;
}

Тесты к функции перебирают граничные случаи: пробелы по краям, строчные буквы, пять и семь символов, кириллицу, пустую строку. Для однотипных проверок есть it.each с таблицей входов и ожидаемых результатов, и по отчёту сразу видно, какой случай сломался.

Тест компонента устроен иначе: модуль api подменяется моком, компонент отрисовывается через render, действия имитирует userEvent. Матчер toBeInTheDocument даёт пакет @testing-library/jest-dom.

vi.mock('./api', () => ({ applyPromo: vi.fn() }));
it('применяет нормализованный код', async () => {
  vi.mocked(applyPromo).mockResolvedValue({ discount: 10 });
  render(<PromoForm />);
  await userEvent.type(screen.getByRole('textbox', { name: 'Промокод' }), ' sale24 ');
  await userEvent.click(screen.getByRole('button', { name: 'Применить' }));
  expect(applyPromo).toHaveBeenCalledWith('SALE24');
  expect(await screen.findByText('Скидка 10 %')).toBeInTheDocument();
});

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

Моки: что подменять и где они ломаются

Мок заменяет настоящую зависимость управляемой подделкой. vi.fn() или jest.fn() создаёт функцию, которая запоминает аргументы вызовов, vi.mock подменяет модуль целиком, а vi.useFakeTimers «перематывает» setTimeout без реальной паузы.

Первая ловушка — порядок выполнения. По справочнику Vitest, вызов vi.mock поднимается в начало файла, выше импортов, поэтому в фабрике нельзя использовать обычные переменные файла; для общих значений есть vi.hoisted. Вторая — состояние, переходящее из теста в тест: без сброса вызовов проверка toHaveBeenCalledTimes(1) зависит от порядка запуска. Третья ошибка не техническая: когда подменено всё, тест проверяет сам мок. Подменяйте границы системы — сеть, время, хранилище браузера, случайные числа.

Снапшоты: когда помогают, а когда мешают

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

По описанию флагов Jest, с опцией --ci новый снапшот не записывается автоматически: тест падает и требует запуска с --updateSnapshot. Это защита от эталона, который молча появился на сервере сборки. Флаг -u перезаписывает все упавшие снапшоты разом, поэтому дифф файлов .snap перед коммитом читайте так же внимательно, как код.

Покрытие: что на самом деле значит процент

Отчёт о покрытии показывает, какие строки и ветви выполнялись во время тестов. Выполненная строка не значит, что её результат проверили: тест без expect тоже даёт покрытие.

Цифра зависит и от того, какие файлы попали в отчёт. В руководстве Vitest по покрытию сказано: по умолчанию показываются только файлы, импортированные во время тестов. Модуль без единого теста в отчёт не попадёт и не потянет процент вниз. Чтобы увидеть всю картину, в coverage.include задают шаблон исходников, например src/**/*.{ts,tsx}. У Jest для этого есть collectCoverageFrom: по документации, для подходящих под шаблон файлов покрытие собирается, даже если тестов к ним нет. Без такой настройки «90 % покрытия» может означать 90 % от нескольких протестированных файлов, а порог coverageThreshold в CI проверяет ту же неполную выборку.

С чего начать и в каком порядке осваивать

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

  1. Поставить Vitest в проект на Vite, написать тесты к двум-трём чистым функциям, запустить в режиме наблюдения.
  2. Освоить матчеры toBe, toEqual, toThrow и асинхронные проверки.
  3. Подключить jsdom и Testing Library, протестировать форму по ролям и подписям.
  4. Подменить запрос к API моком, проверить успех и ошибку, поработать с фальшивыми таймерами.
  5. Включить покрытие с явным include, найти непроверенные ветки, добавить порог и запуск в CI.

Для самопроверки сломайте функцию намеренно, например уберите trim(), и убедитесь, что падает нужный тест с понятным сообщением. Перепишите компонент, сохранив поведение, — хорошие тесты пройдут без правок. Частые ошибки новичков: забытый await перед userEvent, поиск элементов по классам CSS, один огромный тест на всё и зависимость от текущей даты.

Когда нужен курс и что проверить в программе

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

На курсе Skillbox «Фронтенд-разработчик + ИИ» Jest и Vitest перечислены среди инструментов, тестирование разбирают вместе с TypeScript, а в треках по React и Vue заявлены тесты компонентов. Программа рассчитана на 9 месяцев; сколько времени уходит именно на юнит-тесты, по описанию не понять.

Открыть курс «Профессия Фронтенд-разработчик»

Смотрите, где в программе стоят тесты. Один урок в конце навык не закрепит; лучше, когда тесты требуют в нескольких проектах подряд и проверяют на ревью.

Если HTML, CSS и JavaScript уже знакомы, подойдёт короткая программа: на курсе Skillbox «React» за три месяца выполняют 15 практических работ и три проекта, а тестирование с Jest и Vitest названо в программе рядом с Redux и сборщиками.

Открыть курс «по React»

Новичку с нуля надёжнее длинная программа: тесты осмысленны, когда уже есть код, который жалко сломать. Сравните, на каком месяце появляются тесты и сколько проектов к этому моменту сделано.

На курсе Яндекс Практикума «Фронтенд-разработчик» базовая программа длится 10 месяцев, десять проектов проходят ручное ревью, в стеке указаны Vite, Jest и Playwright. Тестирование стоит в заключительной части рядом с React, но объём работы с Jest карточка не раскрывает — уточните его у школы.

Как навык влияет на доход

За Jest или Vitest отдельно не доплачивают: тесты входят в требования к фронтендеру наравне с Git и TypeScript, данных о надбавке за этот навык в открытых источниках нет. Влияние косвенное: на собеседовании просят написать тест к функции, а в команде с обязательным ревью код без тестов не примут. Кто умеет настроить тесты и покрытие в CI, берёт задачи уровня мидла.

Общий фон даёт исследование Хабр Карьеры за первое полугодие 2026 года по 45 226 зарплатам из калькулятора сервиса. Медиана разработчиков — 270 000 рублей в Москве, 247 000 в Петербурге и 200 000 в регионах; у фронтенд-, бэкенд- и мобильных разработчиков зарплаты за полугодие выросли на 3 %. Разбивки по грейдам для фронтенда нет, до или после налога — не уточняется.

Как понять, что база освоена

Возьмите компонент с запросом к API и за час напишите тесты на успех, ошибку и загрузку, не обращаясь к внутреннему состоянию. Затем включите покрытие с явным шаблоном исходников и объясните каждую непокрытую строку. Если получается, дальше учитесь на проектах с ревью.

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