Встроенные модули Node.js — fs, потоки и http

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику

Встроенные модули Node.js

Express и Fastify — надстройки над встроенным модулем http и циклом событий. Один раз собрав сервер на http.createServer, вы понимаете, откуда берутся req, res, потоковое тело и почему важен res.end().

Практика с Express — Первая программа на Node.js, Express — middleware, маршруты и ошибки. Модули CJS/ESM — Node.js - серверный JavaScript. Справочник API — Справочник по Node.

Минимальный HTTP-сервер

Код ITЗагрузка примера кода…

node server.js
curl http://127.0.0.1:3000/

Разбор:

createServer регистрирует callback на каждый запрос.
Без res.end() ответ не завершится — клиент будет ждать.
server.listen блокирует процесс до Ctrl+C — нормально для сервера.

Маршрутизация вручную:

createServer((req, res) => {
  if (req.method === 'GET' && req.url === '/health') {
    res.writeHead(200, { 'Content-Type': 'application/json' });
    res.end(JSON.stringify({ status: 'ok' }));
    return;
  }
  res.writeHead(404);
  res.end('Not found');
});

Именно этот шаг разобран пошагово в Первая программа на Node.js перед Express.

req и res как потоки

req (IncomingMessage) — readable: тело читается событиями data / end или через helpers.
res (ServerResponse) — writable — writeHead, write, end.

Прокси без буферизации всего файла:

Код ITЗагрузка примера кода…

.pipe() связывает поток чтения и записи — основа стриминга в Node.

Файловая система (`fs`)

Предпочитайте асинхронный API:

import { readFile, writeFile } from 'node:fs/promises';

try {
  const data = await readFile('config.json', 'utf8');
  const config = JSON.parse(data);
  await writeFile('backup.json', JSON.stringify(config, null, 2));
} catch (err) {
  console.error(err);
}

API	Когда
`fs/promises` + `async/await`	Обычный код
callback `fs.readFile(path, cb)`	Legacy
`readFileSync`	Только старт приложения, CLI

path — кроссплатформенные пути:

import path from 'node:path';

const full = path.join(__dirname, 'data', 'file.txt');

В ESM вместо __dirname:

import { fileURLToPath } from 'node:url';
import { dirname } from 'node:path';

const __dirname = dirname(fileURLToPath(import.meta.url));

Наблюдение за файлами

import { watch } from 'node:fs';

const watcher = watch('./src', (event, filename) => {
  console.log(event, filename);
});
process.on('SIGINT', () => watcher.close());

Для dev-сервера чаще node --watch или nodemon — CLI Node.js — запуск, отладка и деплой.

Buffer

Строки UTF-16 в JS и байты на диске/в сети — разные представления.

const buf = Buffer.from('тест', 'utf8');
console.log(buf.toString('utf8'));

Для больших бинарников — потоки, не readFile целиком.

Потоки (`stream`)

readFile загружает весь файл в память. Для логов и копирования:

import { createReadStream, createWriteStream } from 'node:fs';
import { pipeline } from 'node:stream/promises';

await pipeline(
  createReadStream('input.txt', 'utf8'),
  createWriteStream('output.txt', 'utf8'),
);

Типы — Readable, Writable, Duplex, Transform (например zlib.createGzip()).

Дочерние процессы

import { exec, spawn } from 'node:child_process';

exec('git --version', (err, stdout) => {
  if (err) throw err;
  console.log(stdout.trim());
});

const ls = spawn('ls', ['-la']);
ls.stdout.on('data', (chunk) => process.stdout.write(chunk));

Не передавайте пользовательский ввод в exec — риск command injection. Для CPU-нагрузки в JS — worker_threads (см. Node.js - серверный JavaScript).

Обработка ошибок

process.on('unhandledRejection', (reason) => {
  console.error('Unhandled rejection:', reason);
});

process.on('uncaughtException', (err) => {
  console.error(err);
  process.exit(1);
});

В async-маршрутах Express используйте try/catch или asyncHandler — Express — middleware, маршруты и ошибки.

Node.js и база данных

Запрос из браузера обычно идёт по цепочке HTTP → Express → service → pool (pg) → PostgreSQL. Пока драйвер ждёт ответ БД, event loop обслуживает другие соединения — поэтому пул и асинхронные вызовы важны с первого дня.

На уровне драйвера — параметризованные запросы $1, $2. Выше — Prisma, Drizzle, TypeORM. Практикум REST + PostgreSQL остаётся в связке Первая программа на Node.js → Express — middleware, маршруты и ошибки; углублённый разбор слоёв — в Node.js - серверный JavaScript (блок с PostgreSQL) и справочнике Справочник по Node.

Связанные материалы

Тема	Материал
Express, middleware	Express — middleware, маршруты и ошибки
npm и зависимости	npm — команды, зависимости и lock-файлы
A–Z API	Справочник по Node

Основа по протоколу

Методы, заголовки, коды ответа — HTTP как основа веб-интеграций.

Встроенные модули Node.js — fs, потоки и http