Интеграция Swagger в NestJS: различия между версиями

Материал из wiki.nntc.nnov.ru
Перейти к навигации Перейти к поиску
(Добавлена инструкция настройки файла main.ts)
 
Строка 1: Строка 1:
−
<span id="интеграция-swagger-в-nestjs"></span>
 
−
= Интеграция Swagger в NestJS =
 
−
 
 
<span id="установка-необходимых-зависимостей"></span>
 
<span id="установка-необходимых-зависимостей"></span>
 
== Установка необходимых зависимостей ==
 
== Установка необходимых зависимостей ==

Версия 15:56, 1 марта 2026

Установка необходимых зависимостей

npm install @nestjs/swagger

Настройка файла main.ts

  1. Импорт модулей В начало файла добавляем:
import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'
  1. Конфигурация спецификации Объект config определяет метаданные вашей документации. Его необходимо создать внутри функции bootstrap():
const config = new DocumentBuilder()
    .setTitle('Заголовок документации')
    .setDescription('Описание документации')
    .setVersion('Версия документации')
    .build() 
  1. Инициализация модуля Создание функции-фабрики, которая собирает спецификацию API на основе декораторов в контроллерах.
const documentFactory = () => SwaggerModule.createDocument(app, config);
SwaggerModule.setup('docs', app, documentFactory);

Метод setup подключает интерактивную документацию по пути /docs, связывая ее с приложением NestJS и созданным документом.