Библиотека из 30 компонентов: как типовые экраны стали собираться втрое быстрее
Почему я начал с форм, таблиц и навигации, как описывал состояния компонентов в Storybook и что именно проверяли тесты.
Одна и та же задача, решённая по-разному
В билайне приложение росло быстрее, чем договорённости о том, как оно должно выглядеть и вести себя. Формы, таблицы и навигация на разных экранах были реализованы по-разному, и один и тот же баг приходилось исправлять в нескольких местах.
Я начал именно с этих трёх групп: они встречались почти на каждом экране, и их унификация давала максимальный эффект.
Компонент как набор состояний
Для каждого компонента я сначала описывал состояния, а уже потом внешний вид: загрузка, пустые данные, ошибка, недоступность. Все они задокументированы в Storybook. Дизайнер, тестировщик и разработчик смотрят на одно и то же, а не спорят о том, как «должно быть».
Всего получилось 30 переиспользуемых UI-компонентов. Новый экран теперь собирается из них, а не верстается заново.
Тесты на поведение, а не на реализацию
Тесты я писал на Jest и React Testing Library и проверял в них то, что видит и делает пользователь: подписи полей, связь ошибки с полем, блокировку отправки. Такие тесты не ломаются при рефакторинге внутренностей компонента и заодно проверяют базовую доступность.
В итоге время разработки типовых экранов сократилось примерно на 67%, а проверка интерфейса стала заметно быстрее.
it('связывает ошибку с полем', () => {
render(<TextField label="Email" error="Неверный формат" />);
const input = screen.getByRole('textbox', { name: 'Email' });
expect(input).toHaveAccessibleDescription('Неверный формат');
expect(input).toHaveAttribute('aria-invalid', 'true');
});Что я вынес
- Начинать с компонентов, которые есть почти на каждом экране.
- Описывать состояния компонента до его внешнего вида.
- Тестировать поведение, которое видит пользователь.