GraphQL renvoie toujours le code HTTP 200 pour un transport réussi ; les problèmes sont signalés dans le corps de la réponse, pas dans le code de statut. Une réponse possède deux clés de premier niveau : data et errors, et les deux peuvent être présentes en même temps — c'est le principe des données partielles.
Si le resolver d'un champ lève une exception, ce champ devient null, une entrée est ajoutée à errors, mais tous les autres champs se résolvent quand même. Le client obtient ce qui a réussi ainsi qu'une description de ce qui a échoué.
{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // exactement quel champ a échoué
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Le champ extensions.code porte un code d'erreur exploitable par la machine, afin que les clients puissent brancher leur logique dessus. Le fait qu'un champ en erreur ne mette à null que lui-même ou remonte plus haut dépend de la nullability : un champ non-null (posts: [Post!]!) en erreur met plutôt à null son plus proche parent nullable.
import { GraphQLError } from "graphql";
const resolvers = {
Mutation: {
transfer: (_p, args, ctx) => {
if (!ctx.user) {
// attache un code stable sur lequel les clients peuvent brancher ; masque les détails internes
throw new GraphQLError("Not authenticated", {
extensions: { code: "UNAUTHENTICATED" },
});
}
// ...
},
},
};
Beaucoup d'équipes modélisent aussi les erreurs attendues (validation, « email déjà pris ») directement dans le schéma via des types union/result, réservant le tableau errors aux défaillances inattendues — ce qui garde un typage propre pour le chemin nominal.
Les recruteurs sondent si vous savez que les erreurs vivent dans le corps avec des data partielles, que les codes se placent dans extensions, et que la nullability contrôle jusqu'où une erreur remonte. Confondre les erreurs GraphQL avec les codes de statut HTTP est un signe classique que l'on n'a utilisé que REST.
Une bibliothèque de questions d'entretien IT avec des réponses détaillées — du Junior au Senior.
Faire un don