Filleann GraphQL HTTP 200 i gcónaí le haghaidh iompair rathúil; tuairiscítear fadhbanna i gcorp an fhreagra, ní sa stádaschód. Tá dhá eochair ardleibhéil ag freagra: data agus errors, agus is féidir an dá cheann a bheith i láthair ag an am céanna — is é sin sonraí páirteach.
Má chaitheann resolver réimse amháin eisceacht, éiríonn an réimse sin null, cuirtear iontráil le errors, ach réitíonn gach réimse eile fós. Faigheann an cliant an méid a d'éirigh leis chomh maith le cur síos ar an méid a theip.
{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // exactly which field failed
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Iompraíonn an réimse extensions.code cód earráide inléite ag meaisín ionas gur féidir le cliaint brainseáil air. Braitheann sé ar nullability an ndéanann réimse a chaitear é féin amháin a null nó an mbolgann sé aníos: réimse non-null (posts: [Post!]!) a chaitheann earráid, déanann sé a thuismitheoir nullable is gaire dó a null ina ionad.
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" },
});
}
// ...
},
},
};
Samhlaíonn go leor foirne earráidí a bhfuiltear ag súil leo (bailíochtú, "ríomhphost tógtha") mar chuid den schema trí union/result types freisin, agus coinníonn siad an t-eagar errors do theipeanna nach bhfuiltear ag súil leo — rud a choinníonn clóscríobh an happy-path glan.
Fiosraíonn agallóirí an bhfuil a fhios agat go maireann earráidí sa chorp le data páirteach, go mbaineann cóid le extensions, agus go rialaíonn nullability cé chomh fada is a bholgann earráid. Is comhartha clasaiceach é earráidí GraphQL a mheascadh suas le stádaschóid HTTP nár úsáid duine ach REST.
Leabharlann de cheisteanna agallaimh TF le freagraí mionsonraithe — ó Shóisearach go Sinsearach.
Síntiús