TypeScript Academy · Lektion

Die tRPC-Architektur

Erfahren Sie, wie tRPC die doppelte Definition von API-Schemas überflüssig macht.

Die tRPC-Architektur ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Das End-to-End-Problem

In einer typischen Webanwendung definiert der Server eine API, und der Client ruft sie auf. Ihre Typen synchron zu halten, ist schwierig: Wenn Sie ein Feld auf dem Server ändern, bricht der Client unbemerkt zur Laufzeit. tRPC löst dieses Problem, indem Typen direkt gemeinsam verwendet werden – ohne Codegenerierung.

// Server: returns { id: number; name: string }
// Client: must know that shape exactly
// Without sync: runtime errors when they drift

Was tRPC ist

tRPC ist eine Bibliothek zum Erstellen vollständig typisierter APIs in TypeScript. Der Server definiert Prozeduren; der Client ruft sie auf, als wären es lokale Funktionen, mit vollständiger Autovervollständigung und aus dem Servercode abgeleiteter Typprüfung.

// Client call looks like a local function:
// const user = await client.user.byId.query(1);
// user is typed automatically from the server

Keine Codegenerierung

Im Gegensatz zu GraphQL- oder OpenAPI-Workflows benötigt tRPC keinen Schritt zur Codegenerierung. Es gibt keine Schemadatei, die kompiliert werden muss, und keinen generierten Client. Die Typen fließen ausschließlich durch die TypeScript-Inferenz zur Compilezeit vom Server zum Client.

// No .graphql files, no generated SDK
// Just import a type from the server package

Der Router ist der Vertrag

Das Zentrum von tRPC ist der Router. Er ist ein Baum aus Prozeduren (Queries und Mutations). Das Routerobjekt auf dem Server und insbesondere sein inferierter Typ sind die einzige Quelle der Wahrheit, die mit dem Client geteilt wird.

// appRouter (server) defines every procedure
// type AppRouter = typeof appRouter is the contract

Wie Typen geteilt werden

Der Server exportiert nur den Typ seines Routers, nicht dessen Implementierung. Der Client importiert diesen Typ und verwendet ihn, um einen typisierten Proxy-Client zu erstellen. Es wird kein Servercode an den Browser ausgeliefert, sondern nur Typen, die beim Build entfernt werden.

// server.ts
export type AppRouter = typeof appRouter;

// client.ts
import type { AppRouter } from '../server';

Queries und Mutationen

Procedures gibt es in zwei Hauptarten. Eine Query liest Daten und ist in der Regel idempotent. Eine Mutation ändert Daten. Diese Unterscheidung entspricht den Regeln für Caching und HTTP-Semantik und bestimmt, wie der Client sie aufruft.

// client.user.list.query()      -> read
// client.user.create.mutate(...) -> write

Laufzeit vs. Typen

tRPC hat zwei Ebenen. Zur Laufzeit werden Aufrufe als JSON über HTTP übertragen und von einem Adapter verarbeitet. Zur Compile-Zeit sorgt der gemeinsame Typ AppRouter dafür, dass jeder Aufruf vollständig geprüft wird. Die Laufzeit ist schlank; der eigentliche Wert liegt in der Typsicherheit.

// Runtime: POST /trpc/user.byId  body: {"input":1}
// Types: client.user.byId.query(1) is checked end to end

Warum Inferenz besser ist als Codegenerierung

Da die Typen abgeleitet werden, gibt es keinen Synchronisierungsschritt, den Sie vergessen könnten. Wenn Sie eine Procedure bearbeiten, spiegelt der Client die Änderung sofort wider und zeigt dort rote Wellenlinien, wo Aufrufe nicht mehr passen. Das Feedback ist unmittelbar und erscheint direkt in Ihrem Editor.

// Add a required input field on the server
// -> every client call missing it becomes a type error

Wo tRPC eingesetzt wird

tRPC spielt seine Stärken in Full-Stack-TypeScript-Monorepos aus, in denen Client und Server eine Codebasis gemeinsam nutzen, etwa in Next.js-Apps. Für öffentliche APIs, die von anderen Programmiersprachen genutzt werden, ist es nicht gedacht; dafür benötigen Sie weiterhin ein sprachunabhängiges Schema wie OpenAPI oder GraphQL.

// Great: Next.js app, shared types, internal API
// Not ideal: public API for non-TS consumers

Das große Ganze

Der Ablauf ist: Sie definieren Procedures in einem Router, exportieren den Router-Typ, binden einen HTTP-Adapter an und erstellen aus diesem Typ einen typisierten Client. Jeder Aufruf wird ohne jeglichen generierten Code gegen den Serververtrag geprüft. In den nächsten Lektionen erstellen Sie die einzelnen Bestandteile.

// Roadmap:
// 1. initTRPC + procedures + appRouter
// 2. export AppRouter, create typed client
// 3. context + middleware for auth

Vertrauen Sie dem Compiler

Der entscheidende Perspektivwechsel: Der API-Vertrag lebt in Typen, die vom Compiler durchgesetzt werden, nicht allein in Dokumentation oder Laufzeitvalidierung. Wenn der Code kompiliert, stimmen Client und Server überein. Genau das bedeutet „Ende-zu-Ende-Typsicherheit“.

// If client.ts compiles, it matches the current server.

Kurzer Test

Testen Sie Ihr Verständnis der tRPC-Architektur.

Zusammenfassung

Sie haben das tRPC-Modell kennengelernt.

Der Router ist der Vertrag; sein Typ ist die einzige Quelle der Wahrheit.
Der Server exportiert nur den Typ AppRouter, keinen Code.
Queries lesen, Mutationen schreiben; zur Laufzeit wird JSON über HTTP übertragen.
Die Typsicherheit entsteht durch Inferenz, ohne Schritt zur Codegenerierung.

Als Nächstes: Router und Procedures definieren.

Häufig gestellte Fragen

Ist die Lektion „Die tRPC-Architektur“ kostenlos?

Ja — der vollständige Text von „Die tRPC-Architektur“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Die tRPC-Architektur“?

Erfahren Sie, wie tRPC die doppelte Definition von API-Schemas überflüssig macht. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um TypeScript Academy zu starten?

Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „Die tRPC-Architektur“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?

Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu TypeScript Academy