Интеграция Swagger в NestJS: различия между версиями
Перейти к навигации
Перейти к поиску
(Добавлена инструкция настройки файла main.ts) |
|||
| Строка 1: | Строка 1: | ||
| − | |||
| − | |||
| − | |||
<span id="установка-необходимых-зависимостей"></span> | <span id="установка-необходимых-зависимостей"></span> | ||
== Установка необходимых зависимостей == | == Установка необходимых зависимостей == | ||
Версия 15:56, 1 марта 2026
Установка необходимых зависимостей
npm install @nestjs/swagger
Настройка файла main.ts
- Импорт модулей В начало файла добавляем:
import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger'
- Конфигурация спецификации Объект config определяет метаданные вашей документации. Его необходимо создать внутри функции bootstrap():
const config = new DocumentBuilder()
.setTitle('Заголовок документации')
.setDescription('Описание документации')
.setVersion('Версия документации')
.build()
- Инициализация модуля Создание функции-фабрики, которая собирает спецификацию API на основе декораторов в контроллерах.
const documentFactory = () => SwaggerModule.createDocument(app, config);
SwaggerModule.setup('docs', app, documentFactory);
Метод setup подключает интерактивную документацию по пути /docs, связывая ее с приложением NestJS и созданным документом.