GraphQL sėkmingam transportui visada grąžina HTTP 200; problemos pranešamos atsakymo turinyje, o ne statuso kode. Atsakymas turi du aukščiausio lygio raktus: data ir errors, ir abu gali būti pateikti vienu metu — tai daliniai duomenys (partial data).
Jei vieno lauko resolveris meta klaidą (throw), tas laukas tampa , į pridedamas įrašas, tačiau visi kiti laukai vis tiek išsprendžiami. Klientas gauna tai, kas pavyko, plius aprašymą, kas nepavyko.
nullerrors{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // tiksliai kuris laukas nepavyko
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Laukas extensions.code perduoda mašininiu būdu skaitomą klaidos kodą, kad klientai galėtų pagal jį šakotis. Ar mestas laukas paverčia null tik save, ar sklinda aukštyn (bubbles up), priklauso nuo nullability: non-null laukas (posts: [Post!]!), kuris meta klaidą, vietoj savęs paverčia null artimiausią nullable tėvą.
import { GraphQLError } from "graphql";
const resolvers = {
Mutation: {
transfer: (_p, args, ctx) => {
if (!ctx.user) {
// pridedame stabilų kodą, pagal kurį klientai gali šakotis; slepiame vidines detales
throw new GraphQLError("Not authenticated", {
extensions: { code: "UNAUTHENTICATED" },
});
}
// ...
},
},
};
Daugelis komandų laukiamas klaidas (validacija, „email jau užimtas“) modeliuoja kaip schemos dalį per union/result tipus, palikdamos errors masyvą nelauktoms klaidoms — taip išlaikomas švarus laimingo kelio (happy-path) tipizavimas.
Interviuotojai tiria, ar žinote, kad klaidos gyvena turinyje kartu su daliniu data, kad kodai priklauso extensions, ir kad nullability valdo, kiek toli klaida sklinda. GraphQL klaidų painiojimas su HTTP statuso kodais — klasikinis požymis, kad žmogus naudojo tik REST.
IT pokalbių klausimų biblioteka su išsamiais atsakymais — nuo Junior iki Senior.
Paaukoti