GraphQL sentiasa memulangkan HTTP 200 untuk pengangkutan yang berjaya; masalah dilaporkan dalam badan respons, bukan kod status. Satu respons mempunyai dua kunci peringkat atas: data dan errors, dan kedua-duanya boleh hadir serentak — itulah yang dipanggil data separa (partial data).
Jika resolver satu medan melontar ralat, medan itu menjadi null, satu entri ditambah ke errors, tetapi setiap medan lain masih diselesaikan. Klien mendapat apa yang berjaya berserta penerangan tentang apa yang gagal.
{
"data": { "user": { "name": "Ada", "posts": null } },
"errors": [
{
"message": "Failed to load posts",
"path": ["user", "posts"], // exactly which field failed
"extensions": { "code": "DOWNSTREAM_TIMEOUT" }
}
]
}
Medan extensions.code membawa kod ralat yang boleh dibaca mesin supaya klien boleh bercabang berdasarkannya. Sama ada medan yang melontar itu hanya menjadikan dirinya sendiri null atau menggelembung ke atas bergantung kepada nullability: medan non-null (posts: [Post!]!) yang ralat akan menjadikan induk nullable terdekatnya null sebaliknya.
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" },
});
}
// ...
},
},
};
Banyak pasukan turut memodelkan ralat yang dijangka (pengesahan, "email taken") sebagai sebahagian daripada skema melalui jenis union/result, sambil menyimpan array errors untuk kegagalan yang tidak dijangka — memastikan penaipan laluan-bahagia (happy-path) kekal bersih.
Penemu duga menyiasat sama ada anda tahu ralat berada dalam badan bersama data separa, bahawa kod tergolong dalam extensions, dan bahawa nullability mengawal sejauh mana sesuatu ralat menggelembung. Mengelirukan ralat GraphQL dengan kod status HTTP ialah petanda klasik bahawa seseorang itu hanya pernah menggunakan REST.
Pustaka soalan temu duga IT dengan jawapan terperinci — daripada Junior hingga Senior.
Derma