Session

HTTP session cung cấp cách lưu thông tin về user qua nhiều request khác nhau, đặc biệt hữu ích cho ứng dụng MVC.

Dùng với Express (mặc định)

Đầu tiên, cài package cần thiết (và type của nó cho người dùng TypeScript):

$ npm i express-session
$ npm i -D @types/express-session

Sau khi cài đặt xong, áp dụng middleware express-session như một middleware global (ví dụ, trong file main.ts của bạn).

import session from 'express-session';
// đặt ở đâu đó trong file khởi tạo (initialization) của bạn
app.use(
  session({
    secret: 'my-secret',
    resave: false,
    saveUninitialized: false,
  }),
);

secret được dùng để ký (sign) session ID cookie. Giá trị này có thể là một string cho một secret duy nhất, hoặc một array chứa nhiều secret. Nếu bạn cung cấp một array secret, chỉ phần tử đầu tiên được dùng để ký session ID cookie, còn tất cả các phần tử sẽ được xem xét khi verify chữ ký trong các request. Secret bản thân nó nên khó bị con người đoán ra, tốt nhất nên là một tập ký tự ngẫu nhiên.

Bật option resave sẽ buộc session phải được lưu lại (save back) vào session store, ngay cả khi session không hề bị thay đổi trong suốt request đó. Giá trị mặc định là true, nhưng dùng mặc định này đã bị deprecated (không còn khuyến nghị), vì giá trị mặc định sẽ thay đổi trong tương lai.

Tương tự, bật option saveUninitialized sẽ buộc một session đang “chưa được khởi tạo” (uninitialized) phải được lưu vào store. Một session được coi là uninitialized khi nó mới được tạo nhưng chưa bị thay đổi. Chọn false hữu ích khi implement session đăng nhập, giảm dung lượng lưu trữ ở server, hoặc để tuân thủ các luật yêu cầu phải có sự cho phép trước khi set cookie. Chọn false cũng giúp tránh race condition khi client gửi nhiều request song song mà chưa có session (nguồn).

Bạn có thể truyền nhiều option khác cho middleware session, đọc thêm về chúng trong tài liệu API.

Với những cài đặt trên, bây giờ bạn có thể set và đọc giá trị session ngay trong route handler, như sau:

@Get()
findAll(@Req() request: Request) {
  request.session.visits = request.session.visits ? request.session.visits + 1 : 1;
}

Ngoài ra, bạn có thể dùng decorator @Session() để lấy session object ra từ request, như sau:

@Get()
findAll(@Session() session: Record<string, any>) {
  session.visits = session.visits ? session.visits + 1 : 1;
}

Dùng với Fastify

Đầu tiên, cài package cần thiết:

$ npm i @fastify/secure-session

Sau khi cài đặt xong, register plugin fastify-secure-session:

import secureSession from '@fastify/secure-session';

// đặt ở đâu đó trong file khởi tạo (initialization) của bạn
const app = await NestFactory.create<NestFastifyApplication>(
  AppModule,
  new FastifyAdapter(),
);
await app.register(secureSession, {
  secret: 'averylogphrasebiggerthanthirtytwochars',
  salt: 'mq9hDxBVDbspDR6n',
});

Đọc thêm về các option khả dụng trong repository chính thức.

Với những cài đặt trên, bây giờ bạn có thể set và đọc giá trị session ngay trong route handler, như sau:

@Get()
findAll(@Req() request: FastifyRequest) {
  const visits = request.session.get('visits');
  request.session.set('visits', visits ? visits + 1 : 1);
}

Ngoài ra, bạn có thể dùng decorator @Session() để lấy session object ra từ request, như sau:

@Get()
findAll(@Session() session: secureSession.Session) {
  const visits = session.get('visits');
  session.set('visits', visits ? visits + 1 : 1);
}