GraphQL za uspešen transport vedno vrne HTTP 200; težave se poročajo v telesu odgovora, ne v statusni kodi. Odgovor ima dva ključa najvišje ravni: data in errors, oba pa sta lahko prisotna hkrati — to so delni podatki.
Če resolver enega polja vrže napako, to polje postane , v se doda vnos, vsa druga polja pa se še vedno razrešijo. Odjemalec dobi tisto, kar je uspelo, plus opis tega, kar je spodletelo.
nullerrors{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // exactly which field failed
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Polje extensions.code nosi strojno berljivo kodo napake, tako da lahko odjemalci glede nanjo vejijo logiko. Ali polje z napako postane null samo zase ali se napaka razširi navzgor, je odvisno od ničelnosti: non-null polje (posts: [Post!]!), ki vrže napako, namesto tega postavi na null svojega najbližjega ničljivega prednika.
import { GraphQLError } from "graphql";
const resolvers = {
Mutation: {
transfer: (_p, args, ctx) => {
if (!ctx.user) {
// attach a stable code clients can switch on; hide internal details
throw new GraphQLError("Not authenticated", {
extensions: { code: "UNAUTHENTICATED" },
});
}
// ...
},
},
};
Mnoge ekipe pričakovane napake (validacija, "email taken") modelirajo tudi kot del sheme prek union/result tipov, polje errors pa prihranijo za nepričakovane odpovedi — s čimer ohranijo čisto tipizacijo srečne poti.
Izpraševalci preverjajo, ali veš, da napake živijo v telesu skupaj z delnimi data, da kode sodijo v extensions in da ničelnost nadzoruje, kako daleč se napaka razširi. Zamenjevanje GraphQL napak s HTTP statusnimi kodami je klasičen znak, da je nekdo uporabljal le REST.
Knjižnica IT vprašanj za razgovore s podrobnimi odgovori — od začetnika do izkušenega.
Doniraj