Exception filters کیا ہیں؟

Question

Accepted Answer

**Exception filters** آپ کو مکمل کنٹرول دیتے ہیں کہ errors کو کیسے **پکڑا جائے اور responses میں تبدیل کیا جائے**۔ یہ request lifecycle کے آخر میں بیٹھتے ہیں، request میں کہیں سے بھی پھینکی گئی exceptions کو پکڑتے ہیں اور آپ کو error response format، status، اور logging کو customize کرنے دیتے ہیں۔

## ایک سادہ exception filter

```ts
import { ExceptionFilter, Catch, ArgumentsHost, HttpException } from "@nestjs/common";

@Catch(HttpException)                    // catch HttpExceptions specifically
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const request = ctx.getRequest();
    const status = exception.getStatus();

// build a CUSTOM error response shape
    response.status(status).json({
      statusCode: status,
      timestamp: new Date().toISOString(),
      path: request.url,
      message: exception.message,
    });
  }
}
```

`@Catch()` decorator اس filter کو بتاتا ہے کہ یہ کون سی exception types کو handle کرے، اور `catch()` method کو exception اور context ملتے ہیں — جو آپ کو کوئی بھی response بنانے دیتا ہے۔

## تمام exceptions پکڑنا (non-HTTP سمیت)

```ts
@Catch()                                 // no argument = catch EVERYTHING
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const status = exception instanceof HttpException
      ? exception.getStatus()
      : 500;                              // unknown errors → 500
    // log the full error internally, return a safe message to the client
    this.logger.error(exception);
    ctx.getResponse().status(status).json({ statusCode: status, message: "..." });
  }
}
```

ایک filter جس میں `@Catch()` (کوئی argument نہیں) ہو ہر exception کو handle کرتا ہے — یہ unexpected errors کو log کرنے کی جگہ ہے اور یقینی بناتا ہے کہ non-HTTP errors بھی ایک صاف، محفوظ response واپس دیں (stack traces clients تک leak کیے بغیر)۔

## Filters لاگو کرنا

```ts
@UseFilters(HttpExceptionFilter)         // method or controller level
export class UsersController {}

app.useGlobalFilters(new AllExceptionsFilter());   // GLOBAL — app-wide, most common
```

Filters عام طور پر **globally** لاگو کیے جاتے ہیں تاکہ پورے API میں ایک مستقل error format enforce کیا جائے۔

## Exception filters کیوں استعمال کریں؟

```text
✓ Consistent error response format across ALL endpoints (a standard shape)
✓ Centralized error LOGGING (log every error in one place)
✓ Handle non-HTTP errors safely (turn unexpected errors into clean 500s)
✓ Hide internal details from clients (no leaked stack traces — security)
✓ Add context (request path, timestamp, correlation IDs) to error responses
```

## Filters بمقابلہ exceptions پھینکنا

```text
Throwing exceptions (NotFoundException, etc.) → SIGNALS an error with a status
Exception filters → control HOW those errors are FORMATTED/logged into responses
→ You throw exceptions in your code; filters customize the resulting response globally.
```

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

Exception filters robust، professional APIs بنانے کے لیے NestJS کی ایک اہم خصوصیت ہیں جس میں **مستقل، کنٹرول شدہ error handling** ہو۔

ہالانکہ NestJS کی built-in exception layer پہلے سے ہی پھینکی گئی exceptions کو HTTP responses میں تبدیل کر دیتی ہے، exception filters آپ کو اس رویے کو customize کرنے کے لیے مکمل کنٹرول دیتے ہیں — جو کئی حقیقی مسائل کے لیے اہم ہے: ہر endpoint میں **مستقل error-response shape** enforce کرنا (تاکہ clients کو ہمیشہ errors اسی format میں ملیں)، **error logging کو centralize کرنا** (ہر error کو ایک جگہ پر capture کرنا بجائے scattered try/catch کے)، **unexpected non-HTTP errors کو محفوظ طریقے سے handle کرنا** (انہیں صاف 500s میں تبدیل کرنا بجائے crash کرنے یا details leak کرنے کے)، اور **security** (clients سے internal stack traces اور sensitive details کو چھپاتے ہوئے انہیں internally log کرنا)۔

ایک global "catch-all" filter کو specific HTTP exceptions پھینکنے کے ساتھ combine کرنا production-grade error handling کا معیاری pattern ہے۔

یہ سمجھنا کہ filters کب اور کیسے استعمال کریں (بمقابلہ سادگی سے exceptions پھینکنے کے)، اور consistency کے لیے انہیں globally لاگو کریں، well-built NestJS applications کی علامت ہے اور یہ error handling کے اردگرد mature back-end practice کو ظاہر کرتا ہے — جو اکثر نظر انداز کیا جانے والا لیکن اہم معاملہ ہے۔