QA и тестирование
Что такое React Testing Library?
React Testing Library (RTL) — это библиотека для тестирования React-компонентов, которая стала стандартом в React-сообществе. Её главный принцип: тестировать поведение так, как его видит пользователь, а не внутреннюю реализацию компонента.
Тест рендерит компонент в виртуальном DOM, находит элементы так же, как человек, — по роли (кнопка, поле, заголовок), подписи поля, тексту или плейсхолдеру, — и выполняет действия через библиотеку user-event: клики, ввод текста, выбор в списке. Затем проверяет, что на экране появился ожидаемый результат.
Библиотеку запускают вместе с тестовым фреймворком — Jest или Vitest, — а для удобных проверок используют пакет jest-dom с методами вроде toBeInTheDocument и toBeDisabled. Поиск по ролям заодно проверяет доступность: если кнопку не удаётся найти по роли, её, скорее всего, не найдёт и программа экранного чтения.
Где применяется
React Testing Library используют фронтенд-разработчики и QA-автоматизаторы для модульных и интеграционных тестов компонентов: форм и валидации, условного рендеринга, модальных окон, списков и фильтров, работы с данными из API через поддельные ответы.
Такие тесты быстрые и запускаются в CI при каждом изменении кода. Для проверки полных сценариев в настоящем браузере их дополняют E2E-тестами на Playwright или Cypress.
Пример
Тесты формы заявки: ошибка при пустом поле и успешная отправка.
import { render, screen } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import LeadForm from './LeadForm';
test('shows an error when phone is empty', async () => {
const user = userEvent.setup();
render(<LeadForm />);
await user.type(screen.getByLabelText(/name/i), 'Anna');
await user.click(screen.getByRole('button', { name: /send/i }));
expect(await screen.findByText(/enter your phone/i)).toBeInTheDocument();
});
test('sends the form with valid data', async () => {
const user = userEvent.setup();
render(<LeadForm />);
await user.type(screen.getByLabelText(/name/i), 'Anna');
await user.type(screen.getByLabelText(/phone/i), '+380501234567');
await user.click(screen.getByRole('button', { name: /send/i }));
expect(await screen.findByText(/thank you/i)).toBeInTheDocument();
});
Частые вопросы
Почему не рекомендуют искать элементы по классу или id?
Классы и id — детали реализации, которые меняются при рефакторинге, хотя поведение для пользователя то же. Поиск по роли, подписи и тексту делает тесты стабильнее и заодно проверяет доступность.
Чем getBy отличается от findBy и queryBy?
getBy ищет элемент сразу и выбрасывает ошибку, если его нет. findBy ждёт появления элемента асинхронно. queryBy возвращает null вместо ошибки — его используют, чтобы проверить, что элемента нет.
Что выбрать: Jest или Vitest?
Оба работают с React Testing Library. Vitest быстрее и естественно сочетается с проектами на Vite, Jest — давний стандарт с большой экосистемой. API у них почти одинаковый.
Обучение тестированию в OWU
Освойте профессию QA-инженера на практических курсах с менторами и реальными проектами.
Выбрать курс