ENATIV Logo
ENATIV
Powrót
© 2026 ENATIV
ProjektyOfertaBaza wiedzyKontakt
kontakt@enativ.pl
  1. Baza wiedzy
  2. ›
  3. Backend i API
  4. ›
  5. tRPC

tRPC

Biblioteka do API w TypeScripcie, w której typy z serwera trafiają do klienta bez schematu i generowania kodu.

Backend i APIUżywam od 2022 · Wyróżniony projekt: Gaia Lens (w zespole Code & Pepper)

Kategoria
Backend i API
Używam od
2022
Wyróżniony projekt
Gaia Lensw zespole Code & Pepper

W praktyce

tRPC wybieram wtedy, gdy frontend i backend siedzą w jednym projekcie TypeScript i nie chcę utrzymywać osobnego schematu API. Stoi w stosie Gaia Lens i TPH Global, obu w zespole Code & Pepper. Gdy API ma obsługiwać klientów w innych językach, wybieram GraphQL albo REST.

Czym jest tRPC?

tRPC to biblioteka do budowy i używania w pełni otypowanych API bez schematów i generowania kodu. Opiera się na wnioskowaniu typów w TypeScripcie: serwer eksportuje typ routera, a klient dostaje z niego typy wejść i wyjść każdej procedury. Błąd kontraktu wychodzi więc przy budowaniu, a nie w przeglądarce użytkownika.

Funkcje serwera to procedury, czyli zapytania i mutacje, zgrupowane w routerach. Dla klienta wyglądają jak wywołanie funkcji, a pod spodem są zwykłymi żądaniami HTTP. Do uruchomienia służą adaptery, między innymi do Next.js i Fastify.

Kontrakt
Typ routera, bez schematu
Generowanie kodu
Brak
Procedury
Zapytania i mutacje
Język
TypeScript po obu stronach

Jak pracuję z tRPC

Zaczynam od pytania, kto będzie czytał to API. Jeśli tylko moje aplikacje w jednym repozytorium, tRPC upraszcza pracę, bo kontrakt jest kodem, a nie osobnym plikiem do pilnowania.

  1. Router i procedury

    Procedury grupuję w routerach, a typ głównego routera eksportuję dla klienta. Klient zna wtedy każdą procedurę razem z jej wejściem i wyjściem, bez pliku schematu i bez kroku generowania kodu.

  2. Walidacja na wejściu

    Dane wejściowe procedury sprawdzam walidatorem, na przykład Zod, bo typy TypeScripta znikają w czasie działania i nie obronią przed złym zapytaniem. Ten sam walidator daje klientowi typ wejścia.

  3. Adapter i cache

    Adapter dobieram do frameworka, na przykład do Next.js. Przy cache HTTP uważam na łączenie żądań, bo w jednej paczce mogą się znaleźć dane osobowe.

tRPC czy GraphQL?

Oba dbają o to, żeby klient wiedział, co zwraca serwer. tRPC robi to typami TypeScripta, GraphQL schematem, który nie zależy od języka.

Porównanie tRPC i GraphQL
KryteriumtRPCGraphQL
Gdzie jest kontraktTyp routera na serwerze, bez schematuSchemat GraphQL jako osobny opis
Języki obu stronTypeScript po stronie serwera i klientaWiele języków, wspólny schemat
Typy w kliencieWnioskowane z serwera, bez generowania koduNarzędzia czytają schemat przez introspekcję
Punkt wejściaProcedury: zapytania i mutacjeZazwyczaj jeden adres obsługuje całe API
Kształt odpowiedziUstala go procedura na serwerzeKlient wybiera pola w zapytaniu
Cache HTTPZapytania to zwykłe GET, działają nagłówkiAdres nie identyfikuje obiektu, trzeba identyfikatorów

Zwykle decyduje preferencja zespołu

O wyborze między tRPC a GraphQL zwykle decyduje to, co zespół woli utrzymywać, a nie jedna słuszna odpowiedź.

W nowszym Next.js

tRPC dobrze mi się sprawdza w pracy, ale w Next.js z cache components może już nie być potrzebny.

tRPC stoi w stosie Gaia Lens i TPH Global, obu w zespole Code & Pepper, a GraphQL w Kuma.de i Little Birdie.

Często zadawane pytania

Nie. Typy wynikają z TypeScripta: serwer eksportuje typ routera, a klient go importuje, więc zmiana procedury od razu pokazuje błąd w edytorze klienta. Cena to założenie, że oba końce są w TypeScripcie i widzą wspólny typ, co najłatwiej osiągnąć w jednym repozytorium.
Nie musi. Procedury tRPC to zwykłe żądania HTTP, więc może stać jako endpoint obok istniejącego REST API i nie trzeba go przepisywać od razu. Nowe procedury dodajesz stopniowo, a stare endpointy działają dalej, dopóki ktoś z nich korzysta.
Przez adaptery, między innymi do Next.js, Express, Fastify, AWS Lambda i zwykłego serwera HTTP w Node.js. Dane wejściowe sprawdzasz walidatorem, na przykład Zod. Adapter dobieram do projektu, a o hostingu decydujemy razem.
Tak, bo zapytania to zwykłe żądania GET i działają standardowe nagłówki cache HTTP. Domyślne łączenie żądań w paczki może zmieszać dane osobowe z publicznymi. Dlatego nagłówki ustawiam ostrożnie albo pomijam, gdy żądanie niesie logowanie.

Na tej stronie

  • W praktyce
  • Czym jest tRPC?
  • Jak pracuję z tRPC
  • tRPC czy GraphQL?
  • Często zadawane pytania

Powiązane hasła

  • tRPC
  • TypeScript
  • Next.js
  • GraphQL
  • React
  • Node.js

W ofercie

  • Aplikacje WeboweNowoczesne, szybkie i skalowalne aplikacje webowe w React i Next.js.

Całość w jednym projekcie TypeScript?

Napisz, kto będzie korzystał z API i w jakich językach. Zdecydujemy razem, czy tRPC wystarczy, czy potrzebny jest GraphQL albo REST.

Opisz swój projektZobacz Gaia Lens