آموزش رایگان Node.js در ویندوز؛ از نصب تا ساخت API

import { createServer } from 'node:http';
import { AppError, makeStore } from './model.mjs';

const BODY_LIMIT = 8192;
function readJson(req) {
  const type = (req.headers['content-type'] ?? '').split(';')[0].trim().toLowerCase();
  if (type !== 'application/json' ||
      (req.headers['content-encoding'] && req.headers['content-encoding'] !== 'identity')) {
    req.resume();
    return Promise.reject(new AppError(415, 'JSON_REQUIRED'));
  }
  return new Promise((resolve, reject) => {
    const chunks = [];
    let size = 0;
    let settled = false;
    const fail = error => { if (!settled) { settled = true; reject(error); } };
    req.on('data', chunk => {
      if (settled) return;
      size += chunk.length;
      if (size > BODY_LIMIT) {
        chunks.length = 0;
        fail(new AppError(413, 'BODY_TOO_LARGE'));
      } else chunks.push(chunk);
    });
    req.on('error', () => fail(new AppError(400, 'BODY_INTERRUPTED')));
    req.on('aborted', () => fail(new AppError(400, 'BODY_INTERRUPTED')));
    req.on('end', () => {
      if (settled) return;
      try {
        const text = new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks));
        const value = JSON.parse(text);
        settled = true;
        resolve(value);
      } catch { fail(new AppError(400, 'INVALID_JSON')); }
    });
  });
}

function json(res, status, body, headers = {}) {
  const data = JSON.stringify(body);
  res.writeHead(status, {
    'Content-Type': 'application/json; charset=utf-8',
    'Content-Length': Buffer.byteLength(data),
    'Cache-Control': 'no-store',
    'X-Content-Type-Options': 'nosniff',
    ...headers
  });
  res.end(data);
}

export function makeServer() {
  const store = makeStore();
  return createServer({ requestTimeout: 15000, headersTimeout: 10000, maxHeaderSize: 8192 },
    async (req, res) => {
      try {
        const path = new URL(req.url, 'http://127.0.0.1').pathname;
        const match = /^\/tasks\/([0-9a-f-]{36})$/.exec(path);
        const allow = path === '/health' ? 'GET' : path === '/tasks' ? 'GET, POST' : match ? 'GET, PATCH' : '';
        if (!allow) throw new AppError(404, 'ROUTE_NOT_FOUND');
        if (!allow.split(', ').includes(req.method)) {
          req.resume();
          return json(res, 405, { error: 'METHOD_NOT_ALLOWED' }, { Allow: allow, Connection: 'close' });
        }
        if (path === '/health') return json(res, 200, { ok: true });
        if (path === '/tasks' && req.method === 'GET') return json(res, 200, { tasks: store.list() });
        if (path === '/tasks') {
          const task = store.create(await readJson(req));
          return json(res, 201, { task }, { Location: `/tasks/${task.id}` });
        }
        if (req.method === 'GET') return json(res, 200, { task: store.get(match[1]) });
        const task = store.update(match[1], await readJson(req));
        return json(res, 200, { task });
      } catch (error) {
        if (res.destroyed || res.writableEnded) return;
        const known = error instanceof AppError;
        json(res, known ? error.status : 500,
          { error: known ? error.message : 'INTERNAL_ERROR' }, { Connection: 'close' });
      }
    });
}

import { makeServer } from './app.mjs';

const raw = process.env.PORT ?? '3000';
if (!/^\d{1,5}$/.test(raw) || Number(raw) < 1 || Number(raw) > 65535) {
  console.error('PORT must be an integer from 1 to 65535');
  process.exitCode = 1;
} else {
  const server = makeServer();
  server.on('error', error => {
    console.error(`Cannot start: ${error.code ?? 'UNKNOWN'}`);
    process.exitCode = 1;
  });
  server.listen(Number(raw), '127.0.0.1', () => {
    console.log(`Task API: http://127.0.0.1:${Number(raw)}/health`);
  });
  let stopping = false;
  const stop = () => {
    if (stopping) return;
    stopping = true;
    server.close();
    const deadline = setTimeout(() => server.closeAllConnections(), 3000);
    deadline.unref();
  };
  process.on('SIGINT', stop);
  process.on('SIGTERM', stop);
}

node --check model.mjs
node --check app.mjs
node --check server.mjs
npm.cmd start