Queries, mutationer og subscriptions

Kæd .input(zodSchema).query(async ({ input, ctx }) => ...) på publicProcedure. Håndteringen modtager det validerede input og forespørgslens kontekst. Returnér en vilkårlig serialiserbar værdi: et objekt, en array eller en primitiv værdi.

Returtypen udledes automatisk og bliver datatypen for det tilsvarende useQuery-hook på klienten.

trpc.post.getById.useQuery({ id: '1' }) kalder getById-proceduren i post-routeren. Hooket returnerer det velkendte resultatobjekt fra React Query: { data, isLoading, isError, refetch }.

Inputobjektet er statisk typet: Hvis du sender { id: 123 }, når skemaet forventer en streng, får du en TypeScript-fejl, som opdages under udviklingen.

Brug .input(zodSchema).mutation(async ({ input, ctx }) => ...) til skrivehandlinger på serveren: oprettelse, opdatering eller sletning af data. Mutationer kaldes eksplicit i stedet for at køre ved montering.

Mutationshåndteringen har adgang til hele forespørgslens kontekst via ctx, herunder sessionen fra NextAuth.

const { mutate, isLoading, error } = trpc.post.create.useMutation(). Kald mutate({ title: 'Ny', content: '...' }) for at udløse mutationen. Ligesom React Query's useMutation kører den ikke ved montering.

Send onSuccess- og onError-callbacks til useMutation-indstillingerne for sideeffekter efter mutationen.

Hvis du vil opdatere query-data efter en vellykket mutation, skal du bruge tRPC's hjælpehook: const utils = trpc.useUtils(). Kald utils.post.getAll.invalidate() i onSuccess for at udløse en ny hentning af postlisten.

Dette svarer i tRPC til React Query's queryClient.invalidateQueries() og følger det samme mønster med forældelse og ny hentning.

tRPC bruger som standard Zod til inputvalidering. Zod-skemaet køres på serveren under kørsel og afviser ugyldigt input, før det når din håndtering. Det samme skema leverer TypeScript-typer til klienten.

Denne dobbelte rolle (validering under kørsel + TypeScript-typer) fjerner dobbeltarbejde: Du definerer aftalen én gang i Zod og får begge sikkerhedsgarantier automatisk.

Som standard bruger tRPC httpBatchLink, der samler flere samtidige tRPC-forespørgsler i én HTTP-forespørgsel. Flere useQuery-kald i den samme komponents gengivelsescyklus sendes og behandles samlet.

Det reducerer netværksbelastningen markant sammenlignet med separate HTTP-forespørgsler for hver query på en side med flere datakrav.

Definér en subscription-procedure: publicProcedure.subscription(async function*() { while (true) { yield await nextEvent(); } }). Subscriptions bruger asynkrone generatorer og kræver en WebSocket-transport.

Subscriptions er ideelle til funktioner i realtid: direkte notifikationer, markører til samarbejdende redigering eller streamede AI-svar.

Erstat httpBatchLink med en kombination af httpBatchLink og wsLink ved hjælp af splitLink: send subscriptions til wsLink og queries/mutationer til httpBatchLink. Opret WebSocket-klienten med createWSClient({ url: 'ws://localhost:3000' }).

Denne hybride transport betyder, at de fleste forespørgsler bruger effektiv HTTP-batching, mens subscriptions bruger vedvarende WebSocket-forbindelser.

trpc.notifications.onNew.useSubscription(undefined, { onData: (notification) => addToList(notification), onError: console.error }) abonnerer på proceduren. onData-callbacken kaldes for hver værdi, proceduren leverer.

Subscriptionen oprettes automatisk igen, hvis WebSocket-forbindelsen afbrydes og genoprettes.

En side med en liste i realtid kan bruge en query til at indlæse den oprindelige liste, en mutation til at tilføje et element og en subscription til at modtage nye elementer fra andre brugere i realtid. Alle tre er typet ud fra den samme AppRouter og kan kombineres naturligt.

Strategien for ugyldiggørelse af cachen afhænger af, om du foretrækker en fuld ny hentning (ugyldiggør efter en mutation) eller opdateringer af cachen (utils.post.getAll.setData).

Definér queries med .query() og mutationer med .mutation(), som begge valideres af Zod-skemaer. På klienten skal du bruge trpc.router.procedure.useQuery() og useMutation(). Ugyldiggør queries efter en mutation med utils.procedure.invalidate(). Subscriptions bruger asynkrone generatorer og kræver wsLink som WebSocket-transport.

httpBatchLink samler som standard samtidige queries i én HTTP-forespørgsel.