NestJS Swagger -如何声明多选枚举字段？

NestJS Swagger是一个用于生成API文档和交互式测试界面的工具。它基于OpenAPI规范（以前称为Swagger规范）并与NestJS框架集成，可以自动生成API文档，包括请求和响应的结构、参数、路径等信息。

在NestJS Swagger中声明多选枚举字段可以通过使用装饰器@ApiProperty()来实现。以下是声明多选枚举字段的步骤：

首先，确保你的NestJS应用已经安装并配置了@nestjs/swagger模块。
在你的DTO（数据传输对象）或实体类中，使用@ApiProperty()装饰器来声明多选枚举字段。例如，假设你有一个名为UserDto的DTO类，其中有一个名为roles的字段，它是一个多选枚举字段，可以选择多个角色：

import { ApiProperty } from '@nestjs/swagger';

export class UserDto {
  @ApiProperty({
    enum: ['admin', 'user', 'guest'],
    enumName: 'UserRole',
    isArray: true,
  })
  roles: string[];
}

在上面的例子中，enum属性指定了可选的枚举值，enumName属性指定了枚举的名称，isArray属性设置为true表示这是一个数组类型的字段。

在你的控制器类中，使用@ApiBody()装饰器将DTO类与请求体关联起来。例如：

import { Controller, Post, Body } from '@nestjs/common';
import { ApiBody } from '@nestjs/swagger';
import { UserDto } from './user.dto';

@Controller('users')
export class UsersController {
  @Post()
  @ApiBody({ type: UserDto })
  createUser(@Body() userDto: UserDto) {
    // 处理创建用户的逻辑
  }
}

在上面的例子中，@ApiBody()装饰器将UserDto类与createUser()方法的请求体关联起来。

这样，当你使用NestJS Swagger生成API文档时，它将会显示roles字段是一个多选枚举字段，可选的枚举值为admin、user和guest。

推荐的腾讯云相关产品：腾讯云API网关（API Gateway）可以帮助您快速构建、发布、运维和安全管理API，提供了丰富的功能和工具来管理和保护API。您可以通过以下链接了解更多信息：腾讯云API网关产品介绍

请注意，以上答案仅供参考，具体的实现方式可能会根据您的实际需求和环境而有所不同。