A GraphQL sikeres transport esetén mindig HTTP 200-at ad vissza; a problémákat a válasz törzsében jelzi, nem a státuszkódban. Egy válasznak két top-level kulcsa van: data és errors, és mindkettő jelen lehet egyszerre — ez a részleges adat.
Ha egy mező resolvere kivételt dob, az a mező lesz, egy bejegyzés kerül az tömbbe, de minden más mező továbbra is resolvulódik. A kliens megkapja azt, ami sikerült, plusz a leírást arról, mi bukott el.
nullerrors{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // exactly which field failed
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Az extensions.code mező egy géppel olvasható hibakódot hordoz, így a kliensek elágazhatnak rajta. Hogy egy hibát dobó mező csak önmagát nullázza-e, vagy feljebb buborékol, a nullability-től függ: egy non-null mező (posts: [Post!]!), amely hibázik, a legközelebbi nullable parentjét nullázza helyette.
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" },
});
}
// ...
},
},
};
Sok csapat a várható hibákat (validáció, „email taken") is a séma részeként modellezi union/result típusokon keresztül, az errors tömböt pedig a váratlan hibáknak tartja fenn — így a happy-path típusozás tiszta marad.
Az interjúztatók azt firtatják, tudod-e, hogy a hibák a törzsben, részleges data mellett élnek, hogy a kódok az extensions-be tartoznak, és hogy a nullability szabályozza, meddig buborékol egy hiba. A GraphQL hibák összekeverése a HTTP státuszkódokkal klasszikus árulkodó jele annak, hogy valaki csak REST-et használt.
IT interjúkérdések gyűjteménye részletes válaszokkal — Juniortól Seniorig.
Adományozás