Interceptor bao bọc việc thực thi của một route handler, cho phép bạn chạy logic trước và sau nó — và biến đổi request hoặc response. Chúng được lấy cảm hứng từ lập trình hướng khía cạnh (aspect-oriented programming), lý tưởng cho các mối quan tâm xuyên suốt như logging, biến đổi response, caching, và timing.
()
{
(: , : ): <> {
.();
now = .();
next.().(
( .()),
);
}
}
Một interceptor implement intercept(). Code trước next.handle() chạy trước handler; next.handle() trả về một RxJS Observable của response, và các operator như tap/map cho phép bạn tác động lên response sau khi handler hoàn thành.
@Injectable()
export class TransformInterceptor implements NestInterceptor {
intercept(context: ExecutionContext, next: CallHandler) {
return next.handle().pipe(
map(data => ({ success: true, data, timestamp: new Date().toISOString() })),
// bọc MỌI response trong một envelope nhất quán: { success, data, timestamp }
);
}
}
Dùng map, một interceptor có thể định hình lại mọi response — vd. bọc tất cả response trong một envelope chuẩn, một pattern rất phổ biến cho response API nhất quán.
// caching — trả về response đã cache, bỏ qua handler hoàn toàn
// timeout — cho thất bại các request mất quá lâu
return next.handle().pipe(timeout(5000));
// ánh xạ lỗi — biến đổi exception
return next.handle().pipe(catchError(err => throwError(() => new BadGatewayException())));
// loại bỏ trường (serialization) — ClassSerializerInterceptor loại bỏ các trường @Exclude()
Các cách dùng interceptor phổ biến:
✓ Logging / timing request (trước + sau)
✓ Biến đổi response (envelope nhất quán, loại bỏ trường)
✓ Cache response
✓ Thêm timeout
✓ Ánh xạ/xử lý lỗi
@UseInterceptors(LoggingInterceptor) // cấp method hoặc controller
app.useGlobalInterceptors(new TransformInterceptor()); // toàn cục
Middleware → chạy TRƯỚC mọi thứ, với req/res thô (khó chạm tới response)
Guard → quyết định PHÂN QUYỀN (cho phép/chặn) trước handler
Interceptor → bao bọc handler — chạy TRƯỚC và SAU, có thể BIẾN ĐỔI response
Đặc điểm định nghĩa: interceptor có thể chạy logic sau handler và biến đổi response — điều mà middleware và guard không thể làm một cách sạch sẽ.
Interceptor là một tính năng mạnh mẽ của NestJS để xử lý các mối quan tâm xuyên suốt một cách thanh lịch, và khả năng đặc trưng của chúng — chạy logic cả trước và sau handler, và biến đổi response — khiến chúng là công cụ đúng đắn cho các nhu cầu mà middleware và guard không thể giải quyết.
Hiểu chúng là quan trọng vì nhiều yêu cầu phổ biến ánh xạ tự nhiên tới interceptor: định dạng response nhất quán (bọc tất cả response trong một envelope chuẩn { success, data }), logging/timing (đo thời lượng handler), caching (trả về response đã cache), timeout, biến đổi lỗi, và serialization (loại bỏ trường nhạy cảm).
Biết cấu trúc (Observable next.handle(), với tap/map/catchError để tác động trước/sau), các trường hợp dùng phổ biến, và đặc biệt là cách interceptor khác middleware và guard (khả năng bao bọc và biến đổi response) là một phần then chốt của năng lực kiến trúc NestJS.
Interceptor giữ logic xuyên suốt DRY và tập trung thay vì lặp lại khắp các handler, khiến chúng trở thành một công cụ thường dùng, quan trọng để xây dựng các ứng dụng NestJS sạch sẽ, dễ bảo trì.