Успешный тест первой страницы списка подтверждает лишь формат схемы ответа, но упускает гонки и рассинхронизацию между БД, API и интерфейсом.
Шесть частых ловушек курсорной пагинации:
- Неоднозначная сортировка:
ORDER BY created_at DESCбез уникального ключа (id DESC) вызывает хаотичный сдвиг строк с одинаковым временем между страницами. - Дублирующие вызовы: быстрый скролл порождает параллельные запросы с одинаковым курсором из
IntersectionObserver. - Гонки фильтров: запоздалый ответ старого фильтра перезаписывает свежие данные в UI, если запросы не отменяются через
AbortControllerиqueryKey. - Короткие страницы: по стандарту Google AIP-158 сервер вправе вернуть меньше элементов до конца списка. Признаком завершения служит только пустой
next_page_token. - Повторы при сбоях: автоматический retry после ошибки 503 дублирует элементы в списке.
- Отсутствие полного прохода: отсутствие теста на сквозной обход коллекции с некратным остатком.
Надежная стратегия проверок разделяет уровни: интеграционные тесты API валидируют строгий порядок и токен, компонентные тесты изолируют гонки состояния, а E2E-сценарии в Playwright проверяют сетевые задержки.
![Node.JS [ru]](/api/digests/it_development/daily/20260823/assets/sources/we-use-js.jpg)