前言
Session
是记录客户状态的机制,为每个用户的浏览器创建的一个会话对象,今天我们来看一下怎么在 Nest.js 中使用 Session
安装依赖
pnpm add express-session
pnpm add @types/express-session -D
全局配置
安装完成后,在 main.ts
中将 express-session
配置为全局中间件:
import session from 'express-session';
// 配置 session
app.use(
session({
secret: 'baiwumm', // 签名
resave: false, // 强制保存 sseion 即使它并没有变化,默认为true
saveUninitialized: false, // 强制将未初始化的 session 存储
}),
);
参数说明
属性 | 类型 | 默认值 | 是否必填 | 描述 |
---|---|---|---|---|
secret | string | - | ✅ | 用于加密 session ID 的秘密字符串。强烈建议使用一个足够长且随机的字符串 |
resave | boolean | true | ⭕ | 是否在每次请求时保存 session,即使 session 没有更改。通常设置为 false 以提高性能 |
saveUninitialized | boolean | true | ⭕ | 是否为尚未初始化的 session 创建新的 session 对象。通常设置为 false 以避免不必要的数据库写入 |
name | string | connect.sid | ⭕ | 设置 session ID 的名称 |
更多参数请参考:Api 文档
使用方式
使用
@Req
修饰器:import { Controller, Get, Res } from '@nestjs/common'; import { Request } from 'express'; @Get() findAll(@Req() req: Request) { req.session.username = 'admin'; }
使用
@Session
修饰器:import { Controller, Get, Session } from '@nestjs/common'; import { Request } from 'express'; @Get() findAll(@Session() session: SessionInfo) { session.username = 'admin'; }
常用方法
- 设置会话数据:
session.userName = 'admin'
- 获取会话数据:
session.userName // admin
- 删除会话数据
delete session.userName;
- 销毁整个会话
session.destroy();