Cette page a été traduite par PageTurner AI (bêta). Non approuvée officiellement par le projet. Vous avez trouvé une erreur ? Signaler un problème →
End-to-end typesafe APIs made easy
Introduction
tRPC vous permet de construire et consommer des API entièrement typesafe sans schémas ni génération de code. Il combine des concepts issus de REST et de GraphQL - si ces technologies vous sont inconnues, découvrez les Concepts clés.
Dans les projets TypeScript full-stack, maintenir les contrats d'API synchronisés entre le client et le serveur est un défi récurrent. tRPC résout cela en exploitant directement l'inférence de types de TypeScript, sans étape de génération de code, et détecte les problèmes au moment de la build.
tRPC peut fonctionner de manière autonome ou être monté comme endpoint sur votre API REST existante grâce à notre vaste écosystème d'adaptateurs.
Fonctionnalités
-
✅ Bien testé et prêt pour la production.
-
🧙♂️ Sécurité de typage statique complète et autocomplétion côté client pour les entrées, sorties et erreurs.
-
🐎 DX rapide - Pas de génération de code, de surcharge à l'exécution ou de pipeline de build.
-
🍃 Léger - tRPC n'a aucune dépendance runtime et une empreinte client minime.
-
🐻 Pour projets nouveaux ou existants - Facile à démarrer ou intégrer dans un projet brownfield.
-
🔋 Indépendant du framework - La communauté tRPC a développé des adaptateurs pour tous les frameworks populaires.
-
🥃 Prise en charge des abonnements - Ajoutez des mises à jour en temps réel avec sécurité de typage à votre application.
-
⚡️ Regroupement des requêtes - Les requêtes simultanées sont automatiquement combinées.
-
👀 Exemples - Découvrez un exemple pour apprendre ou démarrer votre projet.
Aperçu rapide
Découvrez-en plus sur la page Vidéos & ressources communautaires.
Essayer tRPC
-
Exemple minimal — Serveur http Node.js + client.
-
Exemple minimal Next.js — endpoint unique + page.
Ou utilisez une application exemple pour démarrer localement.
Adopter tRPC
Créer un nouveau projet
Comme tRPC peut s'intégrer à de nombreux frameworks différents, vous devez d'abord décider où vous souhaitez l'utiliser.
Côté backend, il existe des adaptateurs pour divers frameworks ainsi que pour Node.js vanilla. Côté frontend, vous pouvez utiliser nos intégrations TanStack React Query ou Next.js, une intégration tierce pour d'autres frameworks, ou le client Vanilla qui fonctionne partout où JavaScript s'exécute.
Après avoir choisi votre stack, vous pouvez soit structurer votre application avec un modèle, soit démarrer de zéro en utilisant la documentation pour votre intégration backend et frontend choisie.
Ajouter tRPC à un projet existant
Ajouter tRPC à un projet existant ne diffère pas significativement du démarrage d'un nouveau projet, donc les mêmes ressources s'appliquent. Le principal défi est qu'il peut être difficile de savoir comment intégrer tRPC à votre application existante. Voici quelques conseils :
-
Vous n'avez pas besoin de migrer toute votre logique backend existante vers tRPC. Une stratégie de migration courante consiste à n'utiliser initialement tRPC que pour les nouveaux endpoints, et à migrer ultérieurement les endpoints existants vers tRPC.
-
Si vous ne savez pas par où commencer, consultez la documentation de votre adaptateur backend et de votre implémentation frontend, ainsi que les exemples d'applications.
-
Pour trouver l'inspiration sur l'intégration de tRPC dans une base de code conséquente, explorez les projets open-source utilisant tRPC.
Communauté
Rejoignez-nous sur Discord pour poser vos questions et partager vos expériences !