Nestjs + Swagger：如何向@ApiProperty 添加自定義選項

Question

是否可以向 @ApiProperty 裝飾器添加自定義選項？

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

class Animal {

  @ApiProperty({
    type: String,
    description: 'animal name',
    'x-description': 'some information' // how to add a cutom option 'x-description' ?
  })
  name: string;
}

Answer 1

我不確定我是否完全理解，但如果你在談論openapi 的擴展。 看看這個： https ://github.com/nestjs/swagger/issues/195

Answer 2

來自https://github.com/nestjs/swagger/issues/195#issuecomment-526215840的解決方案

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

type SwaggerDecoratorParams = Parameters<typeof ApiProperty>;
type SwaggerDecoratorMetadata = SwaggerDecoratorParams[0];
type Options = SwaggerDecoratorMetadata & DictionarySwaggerParameters;
type DictionarySwaggerParameters = { 'x-property'?: string };

export const ApiPropertyX = (params: Options) => {
  return ApiProperty(params);
};