Global prefix (tiền tố toàn cục) — Tài liệu NestJS tiếng Việt

Để đặt tiền tố cho tất cả route được đăng ký trong một HTTP application, dùng phương thức setGlobalPrefix() của instance INestApplication.

const app = await NestFactory.create(AppModule);
app.setGlobalPrefix('v1');

Bạn có thể loại trừ một số route khỏi tiền tố toàn cục bằng cú pháp sau:

app.setGlobalPrefix('v1', {
  exclude: [{ path: 'health', method: RequestMethod.GET }],
});

Ngoài ra, bạn cũng có thể chỉ định route dưới dạng chuỗi (nó sẽ áp dụng cho mọi HTTP method):

app.setGlobalPrefix('v1', { exclude: ['cats'] });

Gợi ý Thuộc tính path hỗ trợ tham số wildcard thông qua package path-to-regexp. Lưu ý: nó không hỗ trợ dấu sao wildcard *. Thay vào đó, bạn phải dùng tham số (:param) hoặc named wildcard (*splat).

Ghi chú người dịch Nếu bạn quen với Express, app.use('/api/*', ...) hay dùng * để bắt mọi path con — path-to-regexp bản Nest dùng lại không cho phép kiểu này nữa, bạn phải viết tường minh như '/api/*splat'. Đây là lỗi hay gặp khi copy code Express cũ sang.