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-інженера на практичних курсах із менторами та реальними проєктами.
Обрати курс