آپ NestJS میں استثنیٰ (exceptions) کو کیسے سنبھالتے ہیں؟

Question

Accepted Answer

NestJS میں **بلٹ ان استثنیٰ کی ایک تہہ** ہے جو خود بخود غیر سنبھالی ہوئی خرابیوں کو پکڑتی ہے اور انہیں مناسب HTTP ردعمل میں تبدیل کرتی ہے۔ آپ **استثنیٰ پھینک کر** خرابیوں کو ظاہر کرتے ہیں (اکثر بلٹ ان HTTP استثنیٰ کی کلاسز)، اور Nest انہیں صحیح status code کے ساتھ ساختی JSON ردعمل میں فارمیٹ کرتا ہے۔

## بلٹ ان HTTP استثنیٰ پھینکنا

```ts
import { NotFoundException, BadRequestException, UnauthorizedException } from "@nestjs/common";

@Get(":id")
findOne(@Param("id") id: string) {
  const user = this.usersService.findOne(id);
  if (!user) {
    throw new NotFoundException("User not found");   // → 404 with a JSON error body
  }
  return user;
}
```

NestJS HTTP status codes سے منسلک استثنیٰ کی کلاسز فراہم کرتا ہے، اور ایک کو پھینکنے سے خود بخود ایک درست، ساختی ردعمل ملتا ہے:

```json
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
```

## عام بلٹ ان HTTP استثنیٰ

```text
BadRequestException        → 400
UnauthorizedException      → 401
ForbiddenException         → 403
NotFoundException          → 404
ConflictException          → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
```

ہر عام HTTP خرابی کے لیے ایک کلاس ہے — صحیح status ظاہر کرنے کے لیے مناسب کو استعمال کریں۔

## حسب ضرورت پیغامات اور عام HttpException

```ts
// custom status + body via the base HttpException
throw new HttpException(
  { status: HttpStatus.FORBIDDEN, error: "custom message" },
  HttpStatus.FORBIDDEN,
);
```

## حسب ضرورت استثنیٰ کی کلاسز

```ts
export class UserNotFoundException extends NotFoundException {
  constructor(id: string) {
    super(`User with id ${id} not found`);   // domain-specific, reusable
  }
}
throw new UserNotFoundException(id);
```

## سنبھالی نہ گئی خرابیاں 500 بن جاتی ہیں

```text
If code throws a non-HttpException error (e.g. a plain Error or an unexpected
exception), NestJS's default exception filter catches it and returns a generic
500 Internal Server Error (without leaking internal details to the client).
```

## عام اضافی تبدیلی کے لیے استثنیٰ کی تہہیں

```ts
// a custom exception filter customizes how errors are formatted/logged globally
@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    // log, format the response, etc.
  }
}
app.useGlobalFilters(new AllExceptionsFilter());   // apply app-wide
```

مستقل خرابی کی فارمیٹنگ، لاگنگ، یا non-HTTP خرابیوں کی سنبھال کے لیے، آپ **استثنیٰ کی تہہیں** استعمال کرتے ہیں (ایک متعلقہ، زیادہ پیشرفتہ خصوصیت)۔

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

صحیح استثنیٰ کی سنبھال قابل اعتماد APIs بنانے کے لیے ضروری ہے، اور NestJS کی بلٹ ان استثنیٰ کی تہہ اسے صاف اور مستقل بناتی ہے۔

یہ سمجھنا کہ **HTTP استثنیٰ کو کیسے پھینکا جائے** (`NotFoundException`, `BadRequestException` وغیرہ) روز مرہ کا علم ہے — یہ صحیح status codes اور ساختی، کلائنٹ کے لیے موافق JSON ردعمل کے ساتھ خرابیوں کو ظاہر کرنے کا متحدہ طریقہ ہے، ہر ہینڈلر میں خود سے خرابی کے ردعمل کی تعمیر کے بغیر۔

فریم ورک خود بخود ان کو پکڑتا ہے اور انہیں فارمیٹ کرتا ہے، اور یہ غیر متوقع خرابیوں کو محفوظ طریقے سے عام 500s میں تبدیل کرتا ہے بغیر اندرونی تفصیلات کو ظاہر کیے (سیکیورٹی کے لیے اہم)۔

عام استثنیٰ کی کلاسز جاننا، حسب ضرورت پیغامات/استثنیٰ کو کیسے پھینکا جائے، اور یہ کہ **استثنیٰ کی تہہیں** عام اضافی تبدیلی کے لیے موجود ہیں (مستقل فارمیٹنگ، لاگنگ) مضبوط، پروفیشنل NestJS APIs بنانے کے لیے بنیادی ہے۔

صاف، مستقل خرابی کی سنبھال معیاری بیک اینڈ کوڈ کی نشانی ہے، اس لیے یہ فریم ورک کا ایک بنیادی، بار بار استعمال ہونے والا حصہ ہے۔