İnterceptorlar, bir route handler'ın yürütülmesini sarmalayarak, handler'dan önce ve sonra çalıştırılacak mantığı çalıştırmanızı ve isteği veya yanıtı dönüştürmenizi sağlar. Aspect-oriented programming'den ilham alırlar ve logging, response dönüşümü, caching ve timing gibi cross-cutting concerns'ler için idealdir.
()
{
(: , : ): <> {
.();
now = .();
next.().(
( .()),
);
}
}
Bir interceptor intercept() metodunu implement eder. next.handle() çağrısından önce gelen kod handler'dan önce çalışır; next.handle() yanıtın RxJS Observable'ını döndürür ve tap/map gibi operatörler handler tamamlandıktan sonra yanıt üzerinde işlem yapmanızı sağlar.
@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 }
);
}
}
Bir interceptor map kullanarak her yanıtı yeniden şekillendirebilir — örneğin tüm yanıtları standart bir envelope içine sarmalama, tutarlı API yanıtları için çok yaygın bir modeldir.
// 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
Belirleyici özellik: interceptorlar handler'dan sonra mantık çalıştırabilir ve yanıtı dönüştürebilir — middleware ve guardlar bunu temiz bir şekilde yapamaz.
İnterceptorlar, cross-cutting concerns'leri zarifçe yönetmek için güçlü bir NestJS özelliğidir ve bunların ayırt edici yeteneği — handler'dan hem önce hem de sonra mantık çalıştırabilme ve yanıtı dönüştürebilme — middleware ve guardlar'ın karşılayamadığı ihtiyaçlar için onları doğru araç haline getirir.
Bunları anlamak önemlidir çünkü birçok yaygın gereksinim doğal olarak interceptor'lar ile eşleşir: tutarlı response formatlaması (tüm yanıtları standart bir { success, data } envelope içine sarmalama), logging/timing (handler süresini ölçme), caching (cache'lenmiş yanıtları döndürme), zaman aşımı, hata dönüşümü ve serialization (hassas alanları hariç tutma).
Yapıyı bilmek (the next.handle() Observable, önce/sonra işlem yapmak için tap/map/catchError ile), yaygın kullanım durumlarını ve özellikle interceptor'ların middleware ve guardlar'dan nasıl farklı olduğunu (yanıtı sarmalama ve dönüştürme yeteneği), NestJS mimarı yeterliliğinin önemli bir parçasıdır.
İnterceptorlar, cross-cutting mantığını DRY ve merkezi tutarak handler'lar arasında tekrarlanan mantıktan kurtarır, böylece temiz, bakımı kolay NestJS uygulamaları geliştirmek için sık kullanılan ve önemli bir araç haline gelirler.