Урок 052 минуты чтения
Зачем разделять app и server?
На этой странице
Кратко
Файл app.ts собирает Express-приложение, а server.ts подключает окружение, открывает порт и управляет жизненным циклом процесса. Такое разделение упрощает тестирование и остановку сервера.
Вопрос
Зачем разделять Express-приложение на app.ts и server.ts? Как это помогает тестам и остановке сервера?
src/app.ts
import express from "express";
export const app = express();
app.use(express.json({ limit: "100kb" }));
app.get("/api/health", (request, response) => {
response.json({ status: "ok" });
});Здесь нет listen(). Файл только создаёт и настраивает приложение.
src/server.ts
import "dotenv/config";
import { app } from "./app.js";
const port = Number(process.env.PORT ?? 3000);
const server = app.listen(port, () => {
console.log(`Сервер запущен: http://localhost:${port}`);
});
function shutdown(signal: string) {
console.log(`Получен сигнал ${signal}`);
server.close((error) => {
if (error) {
console.error(error);
process.exitCode = 1;
return;
}
process.exitCode = 0;
});
}
process.on("SIGTERM", () => shutdown("SIGTERM"));
process.on("SIGINT", () => shutdown("SIGINT"));Почему так удобнее тестировать
Проверка может импортировать app и отправлять запросы без настоящего сетевого порта:
import request from "supertest";
import { app } from "./app.js";
const response = await request(app).get("/api/health");Если listen() выполняется при импорте, каждый тест пытается открыть порт, и завершать процесс становится сложнее.
Более крупная структура
src/
├── app.ts
├── server.ts
├── config/
├── db/
├── middleware/
└── modules/
└── users/
├── users.routes.ts
├── users.controller.ts
├── users.service.ts
└── users.repository.tsНе нужно создавать все слои для двух маршрутов. Разделяй проект по мере появления настоящей сложности.
Что важно помнить
app.tsне должен вызыватьlisten()— тогда его можно импортировать в тесты без открытия порта.server.tsотвечает за окружение, порт и сигналыSIGTERM/SIGINT.server.close()перестаёт принимать новые соединения и дожидается текущих запросов.- Слои и папки добавляются по мере роста проекта, а не заранее.
Мини-шпаргалка
app.tsсобирает Express-приложение.server.tsоткрывает порт.- Приложение без
listen()проще тестировать. server.close()перестаёт принимать новые соединения.- Сложность структуры должна соответствовать размеру проекта.
Документация
Express: Health checks and graceful shutdown, Supertest, Node.js: http.Server.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.