СтатьиEsc
Антон Ишинкин2 мин чтения

Библиотека из 30 компонентов: как типовые экраны стали собираться втрое быстрее

Почему я начал с форм, таблиц и навигации, как описывал состояния компонентов в Storybook и что именно проверяли тесты.

  • beeline
  • React
  • Storybook
  • React Testing Library
  • UI Component Library

Одна и та же задача, решённая по-разному

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

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

Компонент как набор состояний

Для каждого компонента я сначала описывал состояния, а уже потом внешний вид: загрузка, пустые данные, ошибка, недоступность. Все они задокументированы в Storybook. Дизайнер, тестировщик и разработчик смотрят на одно и то же, а не спорят о том, как «должно быть».

Всего получилось 30 переиспользуемых UI-компонентов. Новый экран теперь собирается из них, а не верстается заново.

Тесты на поведение, а не на реализацию

Тесты я писал на Jest и React Testing Library и проверял в них то, что видит и делает пользователь: подписи полей, связь ошибки с полем, блокировку отправки. Такие тесты не ломаются при рефакторинге внутренностей компонента и заодно проверяют базовую доступность.

В итоге время разработки типовых экранов сократилось примерно на 67%, а проверка интерфейса стала заметно быстрее.

TSX · React Testing Library
it('связывает ошибку с полем', () => {
  render(<TextField label="Email" error="Неверный формат" />);
  const input = screen.getByRole('textbox', { name: 'Email' });
  expect(input).toHaveAccessibleDescription('Неверный формат');
  expect(input).toHaveAttribute('aria-invalid', 'true');
});

Что я вынес

  • Начинать с компонентов, которые есть почти на каждом экране.
  • Описывать состояния компонента до его внешнего вида.
  • Тестировать поведение, которое видит пользователь.