Τι είναι τα exception filters;

Question

Accepted Answer

**Exception filters** σας δίνουν πλήρη έλεγχο στο πώς τα σφάλματα **αιχμαλωτίζονται και μετατρέπονται σε responses**. Βρίσκονται στο τέλος του request lifecycle, αιχμαλωτίζοντας exceptions που εμφανίζονται οπουδήποτε στο request και σας επιτρέποντας να προσαρμόσετε τη μορφή, το status και τη καταγραφή της απάντησης σφάλματος.

## Ένα βασικό 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 καθορίζει ποιοι τύποι exception αυτό το filter χειρίζεται, και η `catch()` μέθοδος λαμβάνει το exception συν το context — επιτρέποντάς σας να δημιουργήσετε οποιοδήποτε response θέλετε.

## Αιχμαλώτιση ΟΛΩNτων 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()` (χωρίς όρισμα) χειρίζεται κάθε exception — το σημείο για καταγραφή απροσδόκητων σφαλμάτων και διασφάλιση ότι ακόμη και τα non-HTTP σφάλματα επιστρέφουν μια καθαρή, ασφαλή απάντηση (χωρίς διαρροή stack traces στους clients).

## Εφαρμογή filters

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

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

Τα filters εφαρμόζονται συνήθως **globally** για να επιβάλλουν μια συνεπή μορφή σφάλματος σε όλο το API.

## Γιατί να χρησιμοποιήσετε 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 έναντι throwing 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 είναι ένα σημαντικό χαρακτηριστικό του NestJS για τη δημιουργία ισχυρών, επαγγελματικών APIs με **συνεπή, ελεγχόμενη χειρισμό σφαλμάτων**.

Αν και το ενσωματωμένο exception layer του NestJS ήδη μετατρέπει τα thrown exceptions σε HTTP responses, τα exception filters σας δίνουν πλήρη έλεγχο για να προσαρμόσετε αυτή τη συμπεριφορά — που σημαίνει για αρκετές πραγματικές ανησυχίες: επιβολή **συνεπούς σχήματος error-response** σε κάθε endpoint (ώστε οι clients να λαμβάνουν πάντα σφάλματα στο ίδιο format), **κεντροποίηση καταγραφής σφαλμάτων** (αιχμαλώτιση κάθε σφάλματος σε ένα σημείο αντί να είναι διασκορπισμένα try/catch), ασφαλής **χειρισμός απροσδόκητων non-HTTP σφαλμάτων** (μετατροπή τους σε καθαρά 500s αντί να κρασάρουν ή να διαρρεύσουν λεπτομέρειες), και **ασφάλεια** (απόκρυψη εσωτερικών stack traces και ευαίσθητων λεπτομερειών από clients ενώ καταγράφονται εσωτερικά).

Ένα global "catch-all" filter σε συνδυασμό με το throwing συγκεκριμένων HTTP exceptions στον κώδικά σας είναι το standard pattern για error handling επιπέδου παραγωγής.

Η κατανόηση του πότε και πώς να χρησιμοποιήσετε filters (έναντι απλού throwing exceptions), και η εφαρμογή τους globally για συνέπεια, είναι χαρακτηριστικό καλά δομημένων NestJS εφαρμογών και αντανακλά μώλυη back-end πρακτική γύρω από το συχνά παραβλεπόμενο αλλά κρίσιμο ζήτημα του χειρισμού σφαλμάτων.