GraphQL میں error handling کیسے کام کرتی ہے؟

Question

IT Interview Practice · Accepted Answer

GraphQL کامیاب transport کے لیے ہمیشہ HTTP **200** واپس کرتا ہے؛ مسائل response body میں رپورٹ کیے جاتے ہیں، status code میں نہیں۔ ایک response کی دو top-level keys ہوتی ہیں: **`data`** اور **`errors`**، اور دونوں بیک وقت موجود ہو سکتی ہیں — یہی **partial data** ہے۔

## Partial data + errors array

اگر کسی ایک field کا resolver throw کرتا ہے، تو وہ field `null` بن جاتی ہے، `errors` میں ایک entry شامل ہو جاتی ہے، مگر باقی ہر field پھر بھی resolve ہو جاتی ہے۔ Client کو وہ سب مل جاتا ہے جو کامیاب ہوا، اور ساتھ میں یہ تفصیل بھی کہ کیا ناکام ہوا۔

```json
{
  "data": { "user": { "name": "Ada", "posts": null } },
  "errors": [
    {
      "message": "Failed to load posts",
      "path": ["user", "posts"],        // exactly which field failed
      "extensions": { "code": "DOWNSTREAM_TIMEOUT" }
    }
  ]
}
```

**`extensions.code`** field ایک machine-readable error code رکھتی ہے تاکہ clients اس پر branch کر سکیں۔ آیا کوئی throw کی گئی field صرف خود کو null کرتی ہے یا اوپر تک bubble کرتی ہے، یہ **nullability** پر منحصر ہے: ایک non-null field (`posts: [Post!]!`) جو error دے، وہ اپنے قریب ترین nullable parent کو null کر دیتی ہے۔

```js
import { GraphQLError } from "graphql";

بہت سی teams **متوقع** errors (validation، "email taken") کو schema کا حصہ بنا کر union/result types کے ذریعے ماڈل کرتی ہیں، اور `errors` array کو **غیر متوقع** ناکامیوں کے لیے مخصوص رکھتی ہیں — تاکہ happy-path typing صاف رہے۔

## یہ کیوں اہم ہے

Interviewers یہ جانچتے ہیں کہ آیا آپ جانتے ہیں کہ errors body میں partial `data` کے ساتھ رہتی ہیں، codes کا مقام `extensions` ہے، اور nullability یہ کنٹرول کرتی ہے کہ error کتنی دور تک bubble کرتی ہے۔ GraphQL errors کو HTTP status codes کے ساتھ خلط ملط کرنا ایک کلاسک اشارہ ہے کہ کسی نے صرف REST استعمال کیا ہے۔

Partial data + errors array

یہ کیوں اہم ہے

متعلقہ سوالات