Interceptors περιτυλίγουν την εκτέλεση ενός route handler, επιτρέποντάς σας να εκτελέσετε λογική πριν και μετά από αυτό — και να μετατρέψετε το request ή το response. Εμπνέονται από aspect-oriented programming, ιδανικοί για cross-cutting concerns όπως logging, response transformation, caching, και timing.
()
{
(: , : ): <> {
.();
now = .();
next.().(
( .()),
);
}
}
Ένας interceptor υλοποιεί intercept(). Ο κώδικας πριν από next.handle() εκτελείται πριν τον handler· next.handle() επιστρέφει ένα RxJS Observable του response, και operators όπως tap/map σας επιτρέπουν να ενεργήσετε στο response μετά την ολοκλήρωση του handler.
@Injectable()
export class TransformInterceptor implements NestInterceptor {
intercept(context: ExecutionContext, next: CallHandler) {
return next.handle().pipe(
map(data => ({ success: true, data, timestamp: new Date().toISOString() })),
// wraps EVERY response in a consistent envelope: { success, data, timestamp }
);
}
}
Χρησιμοποιώντας map, ένας interceptor μπορεί να αναδιαμορφώσει κάθε response — για παράδειγμα περιτυλίγοντας όλα τα responses σε ένα standard envelope, ένα πολύ κοινό pattern για συνεπή API responses.
// caching — return a cached response, skipping the handler entirely
// timeout — fail requests taking too long
return next.handle().pipe(timeout(5000));
// error mapping — transform exceptions
return next.handle().pipe(catchError(err => throwError(() => new BadGatewayException())));
// excluding fields (serialization) — ClassSerializerInterceptor strips @Exclude() fields
Common interceptor uses:
✓ Logging / timing requests (before + after)
✓ Transforming responses (consistent envelopes, field exclusion)
✓ Caching responses
✓ Adding timeouts
✓ Mapping/handling errors
@UseInterceptors(LoggingInterceptor) // method or controller level
app.useGlobalInterceptors(new TransformInterceptor()); // global
Middleware → runs BEFORE everything, with raw req/res (can't easily touch the response)
Guard → AUTHORIZATION decision (allow/block) before the handler
Interceptor → wraps the handler — runs BEFORE and AFTER, can TRANSFORM the response
Το καθοριστικό χαρακτηριστικό: οι interceptors μπορούν να εκτελέσουν λογική μετά τον handler και να μετατρέψουν το response — κάτι που middleware και guards δεν μπορούν να κάνουν καθαρά.
Οι interceptors είναι ένα ισχυρό χαρακτηριστικό του NestJS για το χειρισμό cross-cutting concerns με κομψότητα, και η διακριτική τους ικανότητα — εκτέλεση λογικής τόσο πριν όσο και μετά τον handler, και μετατροπή του response — τα κάνει το σωστό εργαλείο για ανάγκες που middleware και guards δεν μπορούν να αντιμετωπίσουν.
Η κατανόησή τους είναι σημαντική επειδή πολλές κοινές απαιτήσεις αντιστοιχίζονται φυσικά σε interceptors: συνεπής μορφοποίηση response (περιτύλιγμα όλων των responses σε ένα standard { success, data } envelope), logging/timing (μέτρηση διάρκειας handler), caching (επιστροφή cached responses), timeouts, error transformation, και serialization (αποκλεισμός ευαίσθητων πεδίων).
Η γνώση της δομής (το next.handle() Observable, με tap/map/catchError για ενέργεια πριν/μετά), των κοινών περιπτώσεων χρήσης, και ιδιαίτερα πώς διαφέρουν οι interceptors από middleware και guards (η ικανότητα περιτυλίγματος και μετατροπής του response) είναι ένα κύριο μέρος της αρχιτεκτονικής ικανότητας του NestJS.
Οι interceptors διατηρούν τη cross-cutting λογική DRY και κεντρικοποιημένη αντί να αναπαραχθεί σε διάφορους handlers, κάνοντάς τα ένα συχνά χρησιμοποιούμενο, σημαντικό εργαλείο για τη δημιουργία καθαρών, συντηρήσιμων εφαρμογών NestJS.