GraphQL uvijek vraća HTTP 200 za uspješan transport; problemi se prijavljuju u tijelu odgovora, a ne u statusnom kodu. Odgovor ima dva ključa najviše razine: data i errors, i oba mogu biti prisutna istovremeno — to su djelomični podaci.
Ako resolver jednog polja baci iznimku, to polje postaje , u se dodaje unos, ali sva ostala polja i dalje se razrješavaju. Klijent dobiva ono što je uspjelo plus opis onoga što je zakazalo.
nullerrors{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // točno koje je polje zakazalo
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Polje extensions.code nosi strojno čitljiv kod pogreške pa klijenti mogu granati na temelju njega. Hoće li polje koje je bacilo iznimku poništiti (null) samo sebe ili se propagirati prema gore ovisi o nullabilnosti: non-null polje (posts: [Post!]!) koje zakaže umjesto toga poništava svog najbližeg nullable roditelja.
import { GraphQLError } from "graphql";
const resolvers = {
Mutation: {
transfer: (_p, args, ctx) => {
if (!ctx.user) {
// pridruži stabilan kod na koji klijenti mogu granati; sakrij interne detalje
throw new GraphQLError("Not authenticated", {
extensions: { code: "UNAUTHENTICATED" },
});
}
// ...
},
},
};
Mnogi timovi očekivane pogreške (validacija, "email je zauzet") modeliraju kao dio sheme putem union/result tipova, rezervirajući polje errors za neočekivane greške — čime tipizacija sretnog puta ostaje čista.
Ispitivači ispituju znate li da pogreške žive u tijelu uz djelomične data, da kodovi pripadaju u extensions te da nullabilnost kontrolira koliko se daleko pogreška propagira. Brkanje GraphQL pogrešaka s HTTP statusnim kodovima klasičan je znak da je netko koristio samo REST.
Knjižnica IT pitanja za razgovore za posao s detaljnim odgovorima — od Juniora do Seniora.
Doniraj