Interceptorët mbështjellin ekzekutimin e një handler-i rute, duke të lejuar të ekzekutosh logjikë para dhe pas tij — dhe të transformosh request-in ose response-in. Ata janë inspiruar nga programimi i orientuar tek aspektet, ideale për shqetësimet e shumëfishtë si logging-u, transformimi i response-it, caching-u, dhe matja e kohës.
()
{
(: , : ): <> {
.();
now = .();
next.().(
( .()),
);
}
}
Një interceptor implementon intercept(). Kodi para next.handle() ekzekutohet përpara handler-it; next.handle() kthen një RxJS Observable të response-it, dhe operatorë si tap/map të lejojnë të veprojsh në response pas se handler-i përfundon.
@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 }
);
}
}
Duke përdorur map, një interceptor mund të rishapojë çdo response — p.sh. mbështjelljen e të gjithë response-ve në një zarf standard, një model shumë i zakonshëm për response-e API konsistente.
// 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
Faktori përcaktues: interceptorët mund të ekzekutojnë logjikë pas handler-it dhe transformojnë response-in — të cilat middleware dhe guardat nuk mund ta bëjnë në mënyrë të pastër.
Interceptorët janë një veçori e fuqishme e NestJS-it për trajtimin e shqetësimeve të shumëfishtë në mënyrë elegante, dhe aftësia e tyre dallues — ekzekutimi i logjikës si para ashtu edhe pas handler-it, dhe transformimi i response-it — i bën ata mjeti i duhur për nevojat që middleware dhe guardat nuk mund t'i adresojnë.
Kuptimi i tyre është i rëndësishëm sepse shumë kërkesa të zakonshme përputhen natyrshëm me interceptorët: formatimi i rregullt i response-it (mbështjelljet e të gjithë response-ve në një zarf standard { success, data }), logging-u/matja e kohës (matja e kohëzgjatjes së handler-it), caching-u (kthimi i response-ve në cache), timeout-e, transformimi i gabimeve, dhe serijalizimi (përjashtimi i fushave të ndjeshme).
Dija e strukturës (Observable next.handle(), me tap/map/catchError për të vepruar përpara/pas), të rasteve të zakonshme të përdorimit, dhe veçanërisht si ndryshojnë interceptorët nga middleware dhe guardat (aftësia për të mbështjellur dhe transformuar response-in) është një pjesë kyçe e kompetencës arkitekturale të NestJS-it.
Interceptorët e mbajnë logjikën e shumëfishtë DRY dhe të centralizuar në vend që të replikohej nëpër handler-a, duke i bërë ata një mjet të përdorur shpesh dhe të rëndësishëm për ndërtimin e aplikacioneve të pastra dhe të lehtë për t'u mbajtur me NestJS.