PH

Pierre Houllière

Retour

nuqs 2.5 - Debounce, TanStack Router, et plus


nuqs est une bibliothèque open source conçue pour gérer de manière type-safe l’état des paramètres d’URL dans les applications React, fonctionnant comme un useState mais stocké directement dans la query string. Elle permet de synchroniser facilement l’interface utilisateur avec l’URL, en offrant des parsers personnalisables, une intégration fluide avec plusieurs frameworks (Next.js, Remix, React Router, etc.) et des outils pour optimiser les performances, comme le throttling ou le debouncing des mises à jour.

La mise à jour vers la version 2.5 introduit notamment une configuration globale des options, permettant de définir des comportements par défaut (comme shallow, scroll ou clearOnDefault) pour toute l’application, ainsi que le remplacement de l’option throttleMs par une nouvelle API, limitUrlUpdates, plus flexible pour contrôler les mises à jour d’URL et éviter les problèmes de rate-limiting. Cette version améliore aussi la compatibilité avec les différents frameworks React, simplifie les tests grâce à un adaptateur dédié, et optimise la taille des bundles, tout en renforçant la stabilité et la maintenabilité du code. L’objectif reste de fournir une solution légère, performante et universelle pour la gestion des paramètres d’URL dans les applications modernes.