Phone icon Зв'язатись з нами

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();
});
render, screen, getByRole, getByLabelText і userEvent.

Часті запитання

Чому не рекомендують шукати елементи за класом чи id?

Класи й id — деталі реалізації, які змінюються при рефакторингу, хоча поведінка для користувача та сама. Пошук за роллю, підписом і текстом робить тести стабільнішими й заодно перевіряє доступність.

Чим getBy відрізняється від findBy і queryBy?

getBy шукає елемент одразу й викидає помилку, якщо його немає. findBy чекає появи елемента асинхронно. queryBy повертає null замість помилки — його використовують, щоб перевірити, що елемента немає.

Що обрати: Jest чи Vitest?

Обидва працюють з React Testing Library. Vitest швидший і природно поєднується з проєктами на Vite, Jest — давній стандарт з великою екосистемою. API в них майже однаковий.

Навчання тестуванню в OWU

Опануйте професію QA-інженера на практичних курсах із менторами та реальними проєктами.

Обрати курс