Дипломный проект: защита и итоги
Финал курса: доводим «Заметки» до настоящего вида — обработка ошибок, валидация, конфигурация, ESLint и Prettier, тесты, README, Dockerfile и CI, а затем карта того, что учить дальше, чек-лист всего курса и прощание.
Что осталось до готового проекта
Работающий код — только половина дела. Чтобы проектом можно было гордиться и показать его работодателю, нужны: понятные ошибки, проверка входных данных, настройка через окружение, автоматическая проверка стиля, инструкция и повторяемый запуск. Продолжаем проект из прошлого урока. Все изменения ниже мы собрали и прогнали: после них 10 тестов проходят, а ESLint не находит замечаний.
1. Конфигурация: src/config.js
Настройки читаем из переменных окружения, с разумными значениями по умолчанию и проверкой. Принимаем env параметром, чтобы функцию было легко тестировать.
src/config.js
import path from "node:path";
// Все настройки — из переменных окружения, с разумными значениями по умолчанию
export function loadConfig(env = process.env) {
const port = Number(env.PORT ?? 3000);
if (!Number.isInteger(port) || port < 0 || port > 65535) {
throw new Error(`Некорректный PORT: ${env.PORT}`);
}
return {
port,
dataFile: path.resolve(env.DATA_FILE ?? "notes.json"),
maxBodyBytes: Number(env.MAX_BODY_BYTES ?? 100_000),
};
}
2. Валидация и ошибки: src/validate.js
Данные от клиента нельзя считать надёжными. parseNoteInput проверяет типы и длины и возвращает только разрешённые поля (лишнее вроде admin: true отбрасывается). Для ошибок клиента заведён класс HttpError с кодом статуса. Заодно он закрывает слабое место из прошлого урока: PUT без title больше не запишет в заметку undefined.
src/validate.js
export class HttpError extends Error {
constructor(status, message) {
super(message);
this.status = status;
}
}
// Проверяет тело запроса и возвращает только разрешённые поля.
// partial = true — для PUT: поля необязательны, но хотя бы одно нужно.
export function parseNoteInput(body, { partial = false } = {}) {
if (body === null || typeof body !== "object" || Array.isArray(body)) {
throw new HttpError(400, "Ожидался JSON-объект");
}
const result = {};
if (body.title !== undefined || !partial) {
if (typeof body.title !== "string") throw new HttpError(400, "title должен быть строкой");
const title = body.title.trim();
if (title.length < 1 || title.length > 100) {
throw new HttpError(400, "title: от 1 до 100 символов");
}
result.title = title;
}
if (body.text !== undefined) {
if (typeof body.text !== "string") throw new HttpError(400, "text должен быть строкой");
if (body.text.length > 5000) throw new HttpError(400, "text: не более 5000 символов");
result.text = body.text;
}
if (partial && Object.keys(result).length === 0) {
throw new HttpError(400, "Нечего обновлять");
}
return result;
}
3. Единая обработка ошибок: src/app.js
Теперь обработчики не отправляют ответы об ошибках сами, а бросают HttpError; единственный catch в createApp превращает его в JSON с нужным кодом, а всё неожиданное — в безопасное «500» без внутренних подробностей (детали уходят в лог). Добавлены лимит размера тела (защита от огромных запросов), понятный ответ на битый JSON и маршрут /health для проверки работоспособности.
src/app.js
import http from "node:http";
import { readFile } from "node:fs/promises";
import path from "node:path";
import { HttpError, parseNoteInput } from "./validate.js";
const MIME = {
".html": "text/html; charset=utf-8",
".js": "text/javascript; charset=utf-8",
".css": "text/css; charset=utf-8",
".json": "application/json; charset=utf-8",
};
function send(res, status, data) {
const body = JSON.stringify(data);
res.writeHead(status, {
"Content-Type": "application/json; charset=utf-8",
"Content-Length": Buffer.byteLength(body),
});
res.end(body);
}
async function readJson(req, maxBytes) {
const chunks = [];
let size = 0;
for await (const chunk of req) {
size += chunk.length;
if (size > maxBytes) throw new HttpError(413, "Слишком большое тело запроса");
chunks.push(chunk);
}
const raw = Buffer.concat(chunks).toString("utf8");
if (!raw) return {};
try {
return JSON.parse(raw);
} catch {
throw new HttpError(400, "Некорректный JSON");
}
}
async function serveStatic(res, publicDir, pathname) {
const rel = pathname === "/" ? "/index.html" : pathname;
const file = path.join(publicDir, path.normalize(rel));
if (!file.startsWith(publicDir)) throw new HttpError(403, "Forbidden");
try {
const data = await readFile(file);
res.writeHead(200, {
"Content-Type": MIME[path.extname(file)] ?? "application/octet-stream",
});
res.end(data);
} catch {
throw new HttpError(404, "Not found");
}
}
async function handle(req, res, { store, publicDir, maxBodyBytes }) {
const { pathname } = new URL(req.url, "http://localhost");
if (pathname === "/health") return send(res, 200, { status: "ok" });
const match = pathname.match(/^\/api\/notes(?:\/([\w-]+))?$/);
if (!match) return serveStatic(res, publicDir, pathname);
const id = match[1];
if (!id && req.method === "GET") {
return send(res, 200, await store.list());
}
if (!id && req.method === "POST") {
const input = parseNoteInput(await readJson(req, maxBodyBytes));
return send(res, 201, await store.create(input));
}
if (id) {
const notFound = () => new HttpError(404, "Заметка не найдена");
if (req.method === "GET") {
const note = await store.get(id);
if (!note) throw notFound();
return send(res, 200, note);
}
if (req.method === "PUT") {
const input = parseNoteInput(await readJson(req, maxBodyBytes), { partial: true });
const note = await store.update(id, input);
if (!note) throw notFound();
return send(res, 200, note);
}
if (req.method === "DELETE") {
if (!(await store.remove(id))) throw notFound();
res.writeHead(204);
return res.end();
}
}
throw new HttpError(405, "Метод не поддерживается");
}
export function createApp({ store, publicDir, maxBodyBytes = 100_000 }) {
return http.createServer(async (req, res) => {
try {
await handle(req, res, { store, publicDir, maxBodyBytes });
} catch (e) {
if (e instanceof HttpError) return send(res, e.status, { error: e.message });
console.error(e);
send(res, 500, { error: "Внутренняя ошибка" });
}
});
}
4. Точка входа с аккуратной остановкой: src/server.js
Конфигурация подключена; по сигналам SIGINT и SIGTERM (Ctrl+C, остановка контейнера) сервер перестаёт принимать новые соединения, дообслуживает текущие и выходит. Таймер на 5 секунд — страховка от зависших соединений; unref() не даёт самому таймеру удерживать процесс.
src/server.js
import path from "node:path";
import { fileURLToPath } from "node:url";
import { loadConfig } from "./config.js";
import { createStore } from "./store.js";
import { createApp } from "./app.js";
const root = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
const config = loadConfig();
const store = createStore(config.dataFile);
const app = createApp({
store,
publicDir: path.join(root, "public"),
maxBodyBytes: config.maxBodyBytes,
});
app.listen(config.port, () => {
console.log(`Заметки: http://localhost:${config.port}`);
});
// Аккуратная остановка: дообслужить текущие запросы и выйти
function shutdown(signal) {
console.log(`${signal}: останавливаемся`);
app.close(() => process.exit(0));
setTimeout(() => process.exit(1), 5000).unref();
}
process.on("SIGINT", () => shutdown("SIGINT"));
process.on("SIGTERM", () => shutdown("SIGTERM"));
$ PORT=8080 DATA_FILE=data/notes.json node src/server.js
Заметки: http://localhost:8080
В Windows PowerShell переменные задают иначе: $env:PORT = "8080". Ещё один вариант — файл .env и флаг Node.js node --env-file=.env src/server.js; не коммитьте такой файл, если в нём секреты.
5. Тесты
Новое поведение надо закрепить тестами. Сначала модульные тесты валидации и конфигурации — они не поднимают сервер и работают мгновенно:
test/validate.test.js
import { test } from "node:test";
import assert from "node:assert/strict";
import { parseNoteInput, HttpError } from "../src/validate.js";
import { loadConfig } from "../src/config.js";
test("parseNoteInput обрезает title и отбрасывает лишние поля", () => {
const input = parseNoteInput({ title: " Привет ", admin: true });
assert.deepEqual(input, { title: "Привет" });
});
test("parseNoteInput отвергает плохие данные", () => {
assert.throws(() => parseNoteInput({ title: "" }), HttpError);
assert.throws(() => parseNoteInput({ title: 42 }), HttpError);
assert.throws(() => parseNoteInput({ title: "ок", text: 1 }), HttpError);
assert.throws(() => parseNoteInput([]), HttpError);
assert.throws(() => parseNoteInput({}, { partial: true }), /Нечего обновлять/);
});
test("loadConfig читает окружение и проверяет порт", () => {
assert.equal(loadConfig({ PORT: "8080" }).port, 8080);
assert.equal(loadConfig({}).port, 3000);
assert.throws(() => loadConfig({ PORT: "abc" }), /PORT/);
});
И обновлённые интеграционные тесты: добавлены проверки /health, битого JSON и пустого PUT (маленький помощник send убрал повторение).
test/api.test.js
import { test, before, after } from "node:test";
import assert from "node:assert/strict";
import { mkdtemp, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import path from "node:path";
import { createStore } from "../src/store.js";
import { createApp } from "../src/app.js";
let server, base, dir;
before(async () => {
dir = await mkdtemp(path.join(tmpdir(), "notes-"));
const store = createStore(path.join(dir, "notes.json"));
server = createApp({ store, publicDir: path.join(dir, "public") });
await new Promise((resolve) => server.listen(0, resolve));
base = `http://localhost:${server.address().port}`;
});
after(async () => {
server.close();
await rm(dir, { recursive: true, force: true });
});
const send = (url, method, body) =>
fetch(base + url, {
method,
headers: { "Content-Type": "application/json" },
body: typeof body === "string" ? body : JSON.stringify(body),
});
const post = (body) => send("/api/notes", "POST", body);
test("создание и чтение заметки", async () => {
const res = await post({ title: "Первая", text: "Привет" });
assert.equal(res.status, 201);
const note = await res.json();
assert.equal(note.title, "Первая");
const got = await fetch(`${base}/api/notes/${note.id}`);
assert.equal(got.status, 200);
assert.deepEqual(await got.json(), note);
});
test("пустой title даёт 400", async () => {
const res = await post({ title: " " });
assert.equal(res.status, 400);
});
test("обновление и удаление", async () => {
const note = await (await post({ title: "Черновик" })).json();
const put = await send(`/api/notes/${note.id}`, "PUT", { title: "Готово" });
assert.equal((await put.json()).title, "Готово");
const del = await fetch(`${base}/api/notes/${note.id}`, { method: "DELETE" });
assert.equal(del.status, 204);
const again = await fetch(`${base}/api/notes/${note.id}`);
assert.equal(again.status, 404);
});
test("список: новые заметки первыми", async () => {
await post({ title: "A-старая" });
await post({ title: "B-новая" });
const list = await (await fetch(base + "/api/notes")).json();
assert.ok(list.length >= 2);
assert.equal(list[0].title, "B-новая");
});
test("/health отвечает ok", async () => {
const res = await fetch(base + "/health");
assert.deepEqual(await res.json(), { status: "ok" });
});
test("битый JSON даёт 400, а не 500", async () => {
const res = await send("/api/notes", "POST", "{oops");
assert.equal(res.status, 400);
assert.equal((await res.json()).error, "Некорректный JSON");
});
test("PUT с пустым телом отвергается", async () => {
const note = await (await post({ title: "Для PUT" })).json();
const res = await send(`/api/notes/${note.id}`, "PUT", {});
assert.equal(res.status, 400);
});
$ npm test
✔ создание и чтение заметки (119.0147ms)
✔ пустой title даёт 400 (9.1285ms)
✔ обновление и удаление (37.3519ms)
✔ список: новые заметки первыми (70.2672ms)
✔ /health отвечает ok (6.9178ms)
✔ битый JSON даёт 400, а не 500 (8.1109ms)
✔ PUT с пустым телом отвергается (51.1139ms)
✔ parseNoteInput обрезает title и отбрасывает лишние поля (2.538ms)
✔ parseNoteInput отвергает плохие данные (1.7408ms)
✔ loadConfig читает окружение и проверяет порт (0.8117ms)
ℹ tests 10
ℹ pass 10
ℹ fail 0
6. ESLint и Prettier
ESLint находит ошибки (неиспользуемые переменные, опечатки в именах), Prettier единообразно форматирует код. Установите их как dev-зависимости:
npm install -D eslint @eslint/js globals prettier
Файл eslint.config.js (современный «плоский» формат конфигурации): рекомендованные правила плюс объявление глобальных переменных — Node.js для сервера и тестов, браузерных для клиента:
eslint.config.js
import js from "@eslint/js";
import globals from "globals";
export default [
js.configs.recommended,
{
files: ["src/**/*.js", "test/**/*.js"],
languageOptions: { globals: globals.node },
},
{
files: ["public/**/*.js"],
languageOptions: { globals: globals.browser },
},
];
Файл .prettierrc:
.prettierrc
{
"printWidth": 100,
"singleQuote": false,
"trailingComma": "all"
}
И скрипты в package.json — заодно там появились dev (перезапуск при правках через node --watch) и engines. Версии в блоке devDependencies проставит сам npm install:
package.json
{
"name": "notes",
"version": "1.0.0",
"private": true,
"type": "module",
"engines": {
"node": ">=22"
},
"scripts": {
"start": "node src/server.js",
"dev": "node --watch src/server.js",
"test": "node --test",
"lint": "eslint .",
"format": "prettier --write ."
},
"devDependencies": {
"@eslint/js": "^10.0.1",
"eslint": "^10.12.0",
"globals": "^17.13.0",
"prettier": "^3.9.10"
}
}
Проверка: npm run lint и npx prettier --check .. Первый же запуск ESLint на проекте из прошлого урока нашёл настоящую мелочь: в клиенте было catch (e) с неиспользуемой e, — исправляется на catch {. Мы это поправили в коде прошлого урока. Prettier при первом запуске npm run format может переформатировать index.html и style.css — это нормально, смысл не меняется.
7. README.md
README — лицо проекта. Это Markdown-файл, вот его скелет:
# notes
Заметки: REST API на node:http + JSON-файл, фронтенд на чистом JS.
## Запуск
npm start # http://localhost:3000
npm run dev # перезапуск при изменениях
## API
- GET /api/notes список (новые первыми)
- POST /api/notes создать {title, text?}
- GET /api/notes/:id одна заметка
- PUT /api/notes/:id изменить {title?, text?}
- DELETE /api/notes/:id удалить
- GET /health проверка работоспособности
## Настройки (переменные окружения)
PORT (3000), DATA_FILE (notes.json), MAX_BODY_BYTES (100000)
## Тесты и стиль
npm test
npm run lint
8. Dockerfile
У нашего проекта нет зависимостей для продакшена, поэтому образ получается очень простым: копируем код и запускаем. Данные хранятся на томе /data, а процесс работает не от root.
FROM node:22-alpine
WORKDIR /app
ENV NODE_ENV=production PORT=3000 DATA_FILE=/data/notes.json
COPY package.json ./
COPY src ./src
COPY public ./public
RUN mkdir /data && chown node:node /data
USER node
VOLUME /data
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s CMD ["node", "-e", "fetch('http://localhost:3000/health').then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"]
CMD ["node", "src/server.js"]
Файл .dockerignore (чтобы не тащить в образ лишнее):
node_modules
notes.json
.git
test
.env
Файл .gitignore:
node_modules
notes.json
.env
$ docker build -t notes .
$ docker run --rm -p 3000:3000 -v notes-data:/data notes
Образ мы описали по стандартным правилам Docker, но не собирали на этой машине, поэтому проверьте сборку у себя. Именованный том notes-data хранит заметки между перезапусками контейнера.
9. CI: проверка при каждом push
Файл .github/workflows/ci.yml. Закоммитьте package-lock.json, чтобы npm ci ставил ровно те версии, что у вас:
name: CI
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run lint
- run: npm test
Версии действий (@v4) со временем обновляются — сверяйтесь с документацией GitHub Actions. Теперь каждый pull request сам проверяет стиль и тесты.
10. Деплой
Подойдёт любой хостинг, умеющий запускать Docker-образ или процесс Node.js: VPS, платформы PaaS. Что важно знать:
- Порт и пути берутся из переменных окружения — это уже сделано в
config.js. - Данные лежат в файле, значит нужен постоянный том: без него заметки пропадут при пересоздании контейнера.
- Файловое хранилище рассчитано на один экземпляр сервера. Для нескольких копий и серьёзной нагрузки нужна база данных (например, PostgreSQL или SQLite) — а благодаря слою
store.jsзаменить придётся один файл. - Перед выходом в интернет поставьте перед приложением HTTPS (обратный прокси или средства платформы) и добавьте ограничение частоты запросов и авторизацию, если заметки не должны быть общими.
Что учить дальше
| Направление | С чего начать |
|---|---|
| TypeScript | Типы поверх знакомого JS: документация TypeScript Handbook; перепишите «Заметки» на TypeScript — компилятор сам найдёт ошибки вроде undefined в PUT |
| React | Курс «React» на этом сайте (/courses/react): компоненты, состояние, хуки; перепишите фронтенд «Заметок» на React и Vite |
| Node.js глубже | Express, Fastify или Hono, потоки (streams), worker threads, работа с базами данных (PostgreSQL), аутентификация (сессии, JWT), очереди задач |
| Тестирование | Vitest или Jest, моки, e2e-тесты в Playwright, покрытие кода, подход TDD |
| Системное проектирование | HTTP и REST, кеширование, базы данных и индексы, очереди, масштабирование, наблюдаемость (логи, метрики), основы безопасности |
| Инструменты и инфраструктура | Git на глубоком уровне, Docker, Linux и командная строка, CI/CD, облачные платформы |
| Профессия | Пет-проекты и открытый код, чтение чужих исходников, код-ревью, собеседования, английский язык |
Чек-лист всего курса
Отметьте, что вы уверенно можете объяснить и применить:
- Основы языка: переменные и типы, операторы, условия и циклы, функции и замыкания, объекты и массивы, строки, числа, даты, JSON.
- Браузер: DOM и события, делегирование, формы, fetch, localStorage, Web API.
- Продвинутый JavaScript: прототипы и классы, промисы и async/await, модули и сборка, итераторы, генераторы, Proxy, обработка ошибок, тестирование, безопасность.
- Node.js и экосистема: npm, файловая система, HTTP-серверы, REST API, фреймворки и инструменты.
- Профи: устройство V8, память и сборка мусора, event loop глубже, Web Vitals, алгоритмы, код-ревью, open source.
- Проект: полноценное приложение от хранилища и API до фронтенда, тестов, линтера, Docker и CI.
Прощание
Вы прошли весь путь: от console.log("Привет") до приложения с сервером, интерфейсом, тестами и контейнером. Главное, что остаётся после курса, — не синтаксис, а привычки: пробовать в консоли, читать чужой код, писать тесты, измерять, прежде чем оптимизировать, и просить ревью. JavaScript работает почти везде, а значит, вашему умению найдётся множество применений. Возвращайтесь к урокам, когда что-то забудете, и закрепляйте материал тестами по JavaScript на сайте. Удачи в программировании!
Лучший итог курса — публичный репозиторий с «Заметками», README и зелёным значком CI. Добавьте одну собственную возможность — это уже портфолио.
Доведите проект до финального вида: подключите конфигурацию, валидацию и обработку ошибок, добавьте тесты, настройте ESLint и Prettier (в идеале ноль замечаний), напишите README, соберите Docker-образ и выложите проект на GitHub с рабочим CI. Затем реализуйте одну свою возможность: теги и фильтр по ним, поиск по тексту, закрепление заметок или экспорт в JSON-файл. Сохраните ссылку на репозиторий — это ваш первый «дипломный» проект.
Оглавление курса
Модуль 1Старт10
- 1Что такое JavaScript и где он работает
- 2Инструменты: редактор и консоль браузера
- 3Первый скрипт: script, console.log и Node.js
- 4Переменные: let, const и var
- 5Типы данных
- 6Числа и объект Math
- 7Строки и шаблонные литералы
- 8Комментарии, стиль кода и точка с запятой
- 9Браузер и Node.js: чем отличаются среды
- 10История языка и стандарт ECMAScript
Модуль 2Операторы и управление потоком10
Модуль 3Функции10
Модуль 4Объекты и массивы10
Модуль 5Строки, числа, даты и данные10
Модуль 6DOM и события10
Модуль 7Браузерные API10
Модуль 8Прототипы и классы10
Модуль 9Асинхронность10
Модуль 10Модули и инструменты10
Модуль 11Продвинутые возможности10
Модуль 12Ошибки, тесты и безопасность10
Модуль 13Node.js10
Модуль 14Экосистема и фреймворки10
- 131TypeScript: типы в повседневной работе
- 132React: обзор
- 133Vue и Svelte: обзор
- 134Управление состоянием: обзор
- 135Мета-фреймворки: Next.js, Nuxt, SvelteKit
- 136Современные инструменты сборки
- 137Сквозные тесты: Playwright
- 138Паттерны проектирования в JavaScript
- 139Архитектура больших приложений
- 140Безопасность зависимостей
Модуль 15Профи10
- 141Движок V8 и JIT-компиляция
- 142Память и сборка мусора
- 143Event Loop глубже: микрозадачи и макрозадачи
- 144Производительность и Web Vitals
- 145Вопросы на собеседовании по JavaScript
- 146Алгоритмы и структуры данных на JavaScript
- 147Код-ревью
- 148Вклад в open source
- 149Дипломный проект: разработка
- 150Дипломный проект: защита и итоги
