Node.js — ফাইল, stream আর process: ব্রাউজারের বাইরে JavaScript

১ · Node.js কী — ব্রাউজার ছাড়া একই JavaScript

এতদিন আমাদের JavaScript চলেছে মূলত ব্রাউজারে — বোতামে সাড়া, form যাচাই, পাতা বদলানো। কিন্তু অনলাইন দোকানের অর্ডার কোথায় জমা হয়? প্রতিদিন রাতে বিক্রির হিসাব কে বানায়? এই কাজগুলো চলে সার্ভারে বা আপনার কম্পিউটারের terminal-এ, যেখানে কোনো পাতা নেই, কোনো বোতাম নেই। সেখানেও JavaScript চালানোর ব্যবস্থাটির নাম Node.js.

পর্ব ০৫-এ দেখেছেন, V8 হলো JavaScript কোডকে machine code বানিয়ে চালানোর engine. ২০০৯ সালে Ryan Dahl V8-কে ব্রাউজার থেকে আলাদা করে নিয়ে তার সাথে তিনটি জিনিস জুড়ে দেন। আজকের Node.js মোটামুটি এই তিন স্তরে তৈরি:

ব্রাউজার বনাম Node — কোন global কোথায়

শেষ সারিটি খুব গুরুত্বপূর্ণ। ব্রাউজারে অচেনা ওয়েবসাইটের কোড আপনার ফাইল ছুঁতে পারে না; কিন্তু Node-এ চালানো যেকোনো script বা npm package আপনার ফোল্ডার মুছে দিতে পারে, .env ফাইলের গোপন key পড়ে পাঠিয়ে দিতে পারে। তাই অচেনা package ইনস্টলের আগে ভাবুন — পর্ব ৪৩-এ supply-chain attack দেখেছেন, পর্ব ৪৬-এ npm-এর নিরাপদ ব্যবহার নিয়েও কথা হয়েছে।

চালানোর তিন উপায় — script, REPL আর watch mode

node --version            # কোন version আছে
node app.js               # একটি ফাইল চালানো
node                      # REPL — লাইন লিখুন, সাথে সাথে ফল (.exit বা Ctrl+D দিয়ে বের হোন)
node --watch app.js       # ফাইল বদলালেই আবার চালায় (Node 18.11 থেকে)
node --env-file=.env app.js   # .env ফাইল থেকে environment variable (Node 20.6 থেকে)

Core module আর node: prefix

Core module আনার আধুনিক রীতি হলো নামের আগে node: লেখা — require("node:fs") বা import fs from "node:fs". এতে পরিষ্কার বোঝা যায় এটি Node-এর নিজের module, npm-এর কোনো package নয়; কেউ npm-এ fs নামের নকল package ছাড়লেও বিভ্রান্তির সুযোগ থাকে না। কিছু নতুন module (যেমন node:test) শুধু prefix দিয়েই পাওয়া যায়। এই পর্বের runnable উদাহরণগুলো CommonJS (require) ধাঁচে লেখা, কারণ এই পাতার রানার ফাইলটিকে সেভাবে চালায়; import/export আর দুই ব্যবস্থার পার্থক্য পর্ব ৪৫-এ।

২ · process — প্রোগ্রামের পরিচয়পত্র: argv, env, exit code আর signal

প্রতিটি চলমান প্রোগ্রাম অপারেটিং সিস্টেমের চোখে একটি process. Node-এ সেই process-এর সব তথ্য আর নিয়ন্ত্রণ পাওয়া যায় process নামের global object-এ। সবচেয়ে বেশি লাগে এগুলো:

env আর .env — গোপন জিনিস কোডের বাইরে

ডেটাবেসের পাসওয়ার্ড, bKash বা কোনো পেমেন্ট সেবার API key, SMS gateway-এর token — এগুলো কোডে লিখে রাখা যায় না, কারণ কোড GitHub-এ যায়, সহকর্মীর ল্যাপটপে যায়। নিয়ম হলো: গোপন মান থাকবে environment variable-এ, আর কোড শুধু নাম ধরে পড়বে। নিজের কম্পিউটারে সুবিধার জন্য সেগুলো একটি .env ফাইলে লেখা হয়:

PORT=3000
DB_URL=postgres://shop:গোপন@localhost/shop
SMS_TOKEN=xxxxxxxxxxxxxxxx

Exit code — “সফল হলাম কি না” OS-কে জানানো

আপনার script যখন অন্য কোনো tool-এর অংশ — যেমন CI pipeline বা প্রতিদিন রাতের scheduled কাজ — তখন সেই tool আউটপুট পড়ে না, পড়ে exit code. ০ মানে সব ঠিক, অশূন্য মানে কিছু ভুল। Node নিজে থেকে uncaught exception বা handle না করা rejected promise-এ 1 দিয়ে বের হয়।

Signal আর graceful shutdown

Terminal-এ Ctrl+C চাপলে OS প্রোগ্রামকে SIGINT পাঠায়; Docker, Kubernetes বা সার্ভার বন্ধের সময় সাধারণত আসে SIGTERM. কেউ না শুনলে Node সাথে সাথে বেরিয়ে যায়। কিন্তু একটি সার্ভার হঠাৎ মরে গেলে চলমান অর্ডার অর্ধেক থেকে যায়। তাই সার্ভার এই signal শুনে graceful shutdown করে — নতুন কাজ নেওয়া বন্ধ, চলমান কাজ শেষ, সংযোগ বন্ধ, তারপর বিদায়। মেট্রো রেলের শেষ ট্রেনের মতো: “আর যাত্রী নেওয়া হবে না” ঘোষণা হয়, কিন্তু যারা উঠে গেছেন তাদের গন্তব্যে পৌঁছে দিয়ে তবেই ট্রেন ডিপোতে যায়।

const server = http.createServer(app).listen(3000);
let closing = false;

function shutdown(signal) {
  if (closing) return;            // দুবার Ctrl+C চাপলেও একবারই
  closing = true;
  console.log(`${signal} পেলাম — নতুন request নেওয়া বন্ধ`);
  server.close(async () => {      // চলমান request শেষ হলে এই callback
    await db.end();               // ডেটাবেস সংযোগ বন্ধ
    console.log("সব গুছিয়ে বিদায়");
  });                             // loop খালি হলে Node নিজেই বের হবে
  setTimeout(() => process.exit(1), 10_000).unref(); // ১০ সেকেন্ডের বেশি নয়
}
process.on("SIGINT", shutdown);
process.on("SIGTERM", shutdown);

৩ · path — Windows আর Linux-এ একই কোড

Windows-এ পথ লেখা হয় C:\shop\data\orders.csv, আর Linux বা macOS-এ /home/shop/data/orders.csv. বিভাজক চিহ্ন (path separator) আলাদা — \ বনাম /. আপনার ল্যাপটপ Windows, কিন্তু সার্ভার প্রায় সবসময় Linux. কোডে "data\\" + name লিখলে সার্ভারে গিয়ে ভাঙবে। সমাধান node:path module — যে OS-এ চলছে, সেই নিয়মে পথ বানায়:

একটি সূক্ষ্ম কিন্তু প্রচলিত বাগ: relative পথ ধরা হয় cwd থেকে, script-এর ফোল্ডার থেকে নয়। tools/report.js-এর ভেতরে readFile("orders.csv") লিখে প্রজেক্টের মূল ফোল্ডার থেকে node tools/report.js চালালে Node orders.csv খুঁজবে মূল ফোল্ডারে। Script-এর পাশের ফাইল চাইলে CommonJS-এ path.join(__dirname, "orders.csv"), আর ES module-এ import.meta.dirname (Node 20.11 থেকে) বা new URL("./orders.csv", import.meta.url). আর extname-এর .JPG খেয়াল করুন — extension তুলনার আগে .toLowerCase() করুন।

৪ · fs — ফাইল পড়া-লেখা: sync, callback আর promise

node:fs module-এ একই কাজের তিনটি রূপ আছে — ইতিহাসের তিনটি স্তর। একটি ফাইল পড়া তিনভাবে:

const fs = require("node:fs");
const fsp = require("node:fs/promises");

// ১. sync — ফাইল পড়া শেষ না হওয়া পর্যন্ত পুরো thread থেমে থাকে
const a = fs.readFileSync("config.json", "utf8");

// ২. callback — Node-এর পুরোনো রীতি, error-first callback
fs.readFile("config.json", "utf8", (err, b) => {
  if (err) return console.error(err.code);
  console.log(b.length);
});

// ৩. promise — আধুনিক রীতি, async/await-এর সাথে
const c = await fsp.readFile("config.json", "utf8");   // async function-এর ভেতরে

কেন সার্ভারে sync API বিপজ্জনক? নিচের টাইমলাইনে দুই জন গ্রাহক — রহিম একটি বড় রিপোর্ট চাইলেন (৪০ MB ফাইল পড়তে হবে), করিম শুধু একটি পণ্যের দাম। প্রথমে readFileSync, তারপর await readFile:

এবার একটি বাস্তব কাজ নিজে চালিয়ে দেখুন: একটি মুদি দোকানের আজকের অর্ডার CSV ফাইলে লেখা, আবার পড়ে মোট বিক্রি হিসাব করা, একটি JSON রিপোর্ট লেখা, তারপর ফোল্ডারে কী আছে দেখা। শেষে ইচ্ছা করে একটি না-থাকা ফাইল পড়ে দেখা হয়েছে ভুল কেমন আসে:

const fs = require("node:fs/promises");
const path = require("node:path");

async function main() {
  const dir = path.join("shop", "today");
  await fs.mkdir(dir, { recursive: true });            // আগে থাকলেও ভুল নয়
  const csv = "item,qty,price\nচাল,2,75\nডাল,1,140\nতেল,3,190\n";
  await fs.writeFile(path.join(dir, "orders.csv"), csv, "utf8");
  const text = await fs.readFile(path.join(dir, "orders.csv"), "utf8");
  const rows = text.trim().split("\n").slice(1).map((line) => {
    const [item, qty, price] = line.split(",");
    return { item, total: Number(qty) * Number(price) };
  });
  const grand = rows.reduce((sum, r) => sum + r.total, 0);
  const report = { orders: rows.length, grand, top: rows.toSorted((a, b) => b.total - a.total)[0].item };
  await fs.writeFile(path.join(dir, "report.json"), JSON.stringify(report, null, 2));
  console.log(report);
  const entries = await fs.readdir(dir, { withFileTypes: true });
  for (const e of entries.sort((a, b) => (a.name < b.name ? -1 : 1))) {
    const { size } = await fs.stat(path.join(dir, e.name));
    console.log(e.isFile() ? "ফাইল" : "ফোল্ডার", path.join(dir, e.name), size, "bytes");
  }
  await fs.readFile(path.join(dir, "missing.csv")).catch((err) => console.log("ধরা পড়ল:", err.code));
}
main();

আরও কয়েকটি দরকারি কাজ

• JSON পড়া-লেখা: JSON.parse(await readFile(p, "utf8")) আর writeFile(p, JSON.stringify(obj, null, 2)). ভাঙা JSON-এ SyntaxError আসে — পর্ব ১৯ মনে করুন।
• Log যোগ করা: appendFile("app.log", line + "\n") ফাইলের শেষে যোগ করে, আগের লেখা মোছে না। অনেক লাইন লিখতে হলে প্রতিবার ফাইল খোলার বদলে একটি write stream খোলা রাখা ভালো (অংশ ৬)।
• নিরাপদে overwrite: গুরুত্বপূর্ণ ফাইল সরাসরি লিখতে গিয়ে মাঝপথে বিদ্যুৎ গেলে (লোডশেডিং!) ফাইল অর্ধেক থেকে যায়। প্রচলিত কৌশল: আগে report.json.tmp-এ লিখুন, তারপর rename করে আসল নাম দিন — একই ডিস্কে rename সাধারণত এক ধাপে হয়।
• ফাইলের খবর: stat(p) দেয় size, mtime (শেষ বদলের সময়), isFile(), isDirectory(). শুধু “আছে কি না” দেখতে আগে stat করে তারপর খোলা ঠিক নয় — মাঝখানে অন্য কেউ ফাইল মুছে দিতে পারে; সরাসরি খুলুন আর ENOENT ধরুন।
• ফাইল নজরে রাখা: fs.watch ফাইল বা ফোল্ডার বদলালে খবর দেয়, কিন্তু OS-ভেদে আচরণ আলাদা: একটি সেভে দুবার event আসতে পারে, ফাইলের নাম কখনো null আসে, ফোল্ডারের ভেতরের ফোল্ডার নজরে রাখা (recursive) Linux-এ Node 20-এর আশেপাশে এসেছে। তাই বাস্তব tool সাধারণত event গুলো কিছু ms জমিয়ে (debounce, পর্ব ৩৬) একবার কাজ করে, বা chokidar-এর মতো package ব্যবহার করে।

Error code — ভুলের নাম ধরে সিদ্ধান্ত

ফাইলের কাজে ভুল হলে Node একটি Error দেয়, যার code property-তে OS-এর দেওয়া ছোট নাম থাকে। এগুলো C আর Unix-এর ঐতিহ্য থেকে আসা errno code. বার্তা (err.message) OS বা version-ভেদে বদলাতে পারে, কিন্তু code স্থির — তাই সিদ্ধান্ত নিন code দেখে:

async function loadSettings(file) {
  try {
    return JSON.parse(await fs.readFile(file, "utf8"));
  } catch (err) {
    if (err.code === "ENOENT") return { currency: "BDT", lang: "bn" }; // প্রথমবার
    throw err;   // EACCES, ভাঙা JSON ইত্যাদি — চেপে রাখবেন না
  }
}

৫ · Buffer — bytes আর অক্ষর এক জিনিস নয়

ডিস্ক আর নেটওয়ার্ক অক্ষর চেনে না, চেনে শুধু bytes — ০ থেকে ২৫৫-এর সংখ্যা। “টাকা” লেখাটি ফাইলে কীভাবে থাকবে, তা ঠিক করে একটি character encoding; আজকের ওয়েবে প্রায় সর্বত্র UTF-8. Node-এ কাঁচা bytes ধরে রাখার জন্য আছে Buffer — আসলে Uint8Array-এরই একটি subclass, সাথে কিছু সুবিধাজনক method.

পর্ব ০৯-এ দেখেছেন, JavaScript string ভেতরে UTF-16-এ থাকে, আর length গোনে code unit. বাংলা অক্ষরগুলো Unicode-এর U+0980–U+09FF পরিসরে, তাই প্রতিটি একটি code unit — কিন্তু UTF-8-এ প্রতিটি ৩ bytes. নিচে “টাকা” string থেকে Buffer-এ যাওয়ার পথ ধাপে ধাপে দেখুন:

const buf = Buffer.from("টাকা", "utf8");
buf.length;                       // 12  (bytes)
"টাকা".length;                    // 4   (UTF-16 code unit)
buf.toString("hex");              // 'e0a69fe0a6bee0a695e0a6be'
Buffer.from("4Kaf4Ka+4KaV4Ka+", "base64").toString();  // 'টাকা'
Buffer.alloc(10);                 // ১০টি শূন্য byte — নিরাপদ
// new Buffer(10)  ← পুরোনো, deprecated; কখনো ব্যবহার করবেন না

৬ · Stream — পুরোটা নয়, টুকরো টুকরো

৪ GB-র একটি access log থেকে জানতে চান কতগুলো request-এ 404 এসেছে। readFile দিয়ে পুরো ফাইল মেমরিতে তুললে সার্ভারের RAM ফুরিয়ে যেতে পারে; তা ছাড়া একটি string-এর সর্বোচ্চ দৈর্ঘ্যেরও সীমা আছে। অথচ কাজটার জন্য একসাথে একটি লাইনই যথেষ্ট। এই চিন্তা থেকেই stream: ডেটা আসে ছোট ছোট chunk-এ (fs.createReadStream-এ ডিফল্ট ৬৪ KiB), একটি প্রসেস হলে পরেরটা।

প্রতিটি stream আসলে পর্ব ৩২-এ দেখা EventEmitter — "data" event-এ একটি chunk আসে, "end"-এ শেষ, "error"-এ ভুল। কিন্তু নিজে event ধরে stream জোড়া দেওয়া ঝামেলার, আর একটি জিনিস ভুলে গেলেই বিপদ: backpressure.

Backpressure — ধীর গন্তব্যের জন্য উৎসকে থামানো

ডিস্ক থেকে পড়া খুব দ্রুত, কিন্তু ধীর নেটওয়ার্কে মোবাইল গ্রাহকের কাছে পাঠানো ধীর। উৎস যদি না থেমে পড়তেই থাকে, পাঠাতে না পারা chunk জমতে থাকে মেমরিতে — ১ GB ফাইল হলে প্রায় ১ GB. Backpressure হলো গন্তব্যের “আমি ভরে গেছি, একটু থামো” সংকেত। প্রতিটি writable-এর একটি সীমা থাকে — highWaterMark; জমা ডেটা সেটি ছাড়ালে write() false ফেরত দেয়, উৎস থামে, আর জমা খালি হলে "drain" event-এ আবার চলে:

pipeline — জোড়া দিন, error সামলান, পরিষ্কার করুন

পুরোনো কোডে দেখবেন a.pipe(b).pipe(c). pipe backpressure সামলায়, কিন্তু error সামলায় না: মাঝের কোনো stream-এ error হলে বাকিগুলো বন্ধ হয় না, ফাইল খোলা থেকে যায়, আর error event কেউ না শুনলে পুরো process ক্র্যাশ করতে পারে। এর সমাধান node:stream/promises-এর pipeline: সব stream জোড়ে, যেকোনো একটিতে error হলে সবগুলো ধ্বংস (destroy) করে, আর একটি Promise ফেরত দেয় — যা শেষে fulfilled বা error-সহ rejected.

const fs = require("node:fs");
const zlib = require("node:zlib");
const { pipeline } = require("node:stream/promises");

async function compress(src) {
  await pipeline(
    fs.createReadStream(src),          // Readable
    zlib.createGzip(),                 // Transform
    fs.createWriteStream(src + ".gz")  // Writable
  );
  console.log("সংকোচন শেষ:", src + ".gz");
}
compress("access.log").catch((err) => {
  console.error("ব্যর্থ:", err.code ?? err.message);
  process.exitCode = 1;
});

বড় log ফাইল লাইন ধরে — readline

Chunk-এর সীমানা লাইনের সীমানা মানে না — একটি লাইন দুই chunk-এ ভাগ হয়ে যেতে পারে। লাইন ধরে পড়ার কাজটি node:readline করে দেয়। নিচে HTTP status code গোনার একটি log analyzer:

const fs = require("node:fs");
const readline = require("node:readline");

async function countStatus(file) {
  const rl = readline.createInterface({ input: fs.createReadStream(file), crlfDelay: Infinity });
  const counts = new Map();
  for await (const line of rl) {
    // 103.4.1.9 - - [19/Oct/2026:10:15:02 +0600] "GET /cart HTTP/1.1" 200 512
    const status = line.split(" ")[8];
    if (status) counts.set(status, (counts.get(status) ?? 0) + 1);
  }
  return counts;   // Map(3) { '200' => 9120, '404' => 311, '500' => 7 }
}

এবার নিজে চালান। এই উদাহরণে ইনপুট আসছে process.stdin থেকে (পাতার রানার কয়েকটি log লাইন stdin হিসেবে পাঠায়), একটি নিজের বানানো Transform লাইন ভাগ করে status গোনে আর সমস্যার লাইনগুলো বড় হাতের অক্ষরে সামনে পাঠায়, আর একটি Writable সেগুলো ছাপে। কোন status থেকে “সমস্যা” ধরা হবে, তা আসে argv, তারপর env, না পেলে ডিফল্ট ৪০০:

const { Transform, Writable } = require("node:stream");
const { pipeline } = require("node:stream/promises");

const min = Number(process.argv[2] ?? process.env.MIN_STATUS ?? 400);
const counts = {};
let rest = "";                     // দুই chunk-এ ভাগ হওয়া লাইনের টুকরো
function keep(line) {
  const status = line.split(" ")[2];
  if (!status) return false;
  counts[status] = (counts[status] ?? 0) + 1;
  return Number(status) >= min;
}
const problemsOnly = new Transform({
  readableObjectMode: true,
  transform(chunk, _enc, done) {
    const lines = (rest + chunk).split("\n");
    rest = lines.pop();                         // শেষ লাইন হয়তো অসম্পূর্ণ
    for (const line of lines) if (keep(line)) this.push(line.toUpperCase());
    done();
  },
  flush(done) { if (keep(rest)) this.push(rest.toUpperCase()); done(); },
});
const printer = new Writable({ objectMode: true, write(line, _enc, done) { console.log("  →", line); done(); } });
process.stdin.setEncoding("utf8");              // বাংলা অক্ষর chunk-এর সীমানায় ভাঙবে না
pipeline(process.stdin, problemsOnly, printer)
  .then(() => console.log("argv:", process.argv.slice(2), "min:", min, counts))
  .catch((err) => { console.error("pipeline ব্যর্থ:", err.message); process.exitCode = 1; });

৭ · child_process আর os — অন্য প্রোগ্রাম চালানো, নিরাপদে

কখনো Node থেকে অন্য প্রোগ্রাম চালাতে হয় — git দিয়ে শেষ commit জানা, ffmpeg দিয়ে ভিডিও ছোট করা, ImageMagick দিয়ে ছবির আকার বদলানো। এর জন্য node:child_process. চারটি প্রধান function:

const { execFile } = require("node:child_process");
const { promisify } = require("node:util");
const run = promisify(execFile);

async function lastCommit(branch) {
  if (!/^[\w./-]+$/.test(branch)) throw new Error("অবৈধ branch নাম");
  const { stdout } = await run("git", ["log", "-1", "--format=%h %s", branch]);
  return stdout.trim();   // যেমন: 'a1b2c3d বাংলা ইনভয়েস যোগ'
}

os — যে যন্ত্রে চলছে তার খবর

node:os জানায় প্রোগ্রাম কোন যন্ত্রে চলছে: os.platform() ("win32", "linux", "darwin"), os.availableParallelism() (কতগুলো কাজ একসাথে চালানো উচিত — worker pool-এর আকার ঠিক করতে), os.totalmem()/os.freemem(), os.homedir(), os.tmpdir() (অস্থায়ী ফাইলের নিরাপদ জায়গা), আর os.EOL (লাইন-শেষ: Windows-এ \r\n, বাকিদের \n). সাধারণ নিয়ম: OS অনুমান করে কোড না লিখে এই module থেকে জেনে নিন।

৮ · নিজের CLI tool — দৈনিক বিক্রির রিপোর্ট

এতক্ষণের সব টুকরো জুড়ে একটি ছোট CLI (command-line interface) tool বানানো যাক: sales-report orders.csv -o report.json. একটি ভালো CLI-এর চারটি গুণ — সাহায্য দেখায় (--help), argument ভুল হলে পরিষ্কার বার্তা দেয়, ভুল stderr-এ লেখে, আর ঠিক exit code দেয়।

#!/usr/bin/env node
const { parseArgs } = require("node:util");
const fs = require("node:fs/promises");

const { values, positionals } = parseArgs({
  allowPositionals: true,
  options: {
    out:  { type: "string",  short: "o", default: "report.json" },
    help: { type: "boolean", short: "h" },
  },
});
if (values.help || positionals.length !== 1) {
  console.log("ব্যবহার: sales-report <orders.csv> [-o report.json]");
  process.exit(values.help ? 0 : 2);        // 2 = ভুল ব্যবহার (প্রচলিত রীতি)
}
buildReport(positionals[0], values.out).catch((err) => {
  console.error(`ভুল: ${err.code === "ENOENT" ? "ফাইল পাওয়া যায়নি" : err.message}`);
  process.exitCode = 1;
});

এবার tool-টিকে কমান্ড হিসেবে ইনস্টলযোগ্য করতে package.json-এ একটি "bin" ঘর যোগ করুন — { "bin": { "sales-report": "./bin/sales-report.js" } }. তারপর প্রজেক্ট ফোল্ডারে npm link (নিজের যন্ত্রে পরীক্ষা) বা npm-এ প্রকাশ করে npm install -g/npx sales-report. Windows-এ shebang কাজ করে না, কিন্তু npm ইনস্টলের সময় নিজেই একটি ছোট .cmd wrapper বানিয়ে দেয়। npm আর package.json-এর বিস্তারিত পর্ব ৪৬-এ।

আরও একটি ছোট tool: ছবির ফোল্ডারের নাম বদলানো (ধারণা)

কক্সবাজার ভ্রমণের ৩০০টি ছবি — নাম IMG_4821.JPG, IMG_4822.jpeg… চান coxs-bazar-001.jpg. পরিকল্পনা: readdir → extname(name).toLowerCase() দিয়ে শুধু .jpg/.jpeg বাছাই → নাম ধরে সাজানো → String(i + 1).padStart(3, "0") দিয়ে নম্বর → rename(path.join(dir, old), path.join(dir, neu)). দুটি পেশাদার অভ্যাস যোগ করুন: --dry-run option, যা শুধু “কী হবে” ছাপে, কিছু বদলায় না; আর নতুন নামের ফাইল আগে থেকে থাকলে থেমে যাওয়া — নইলে একটি rename আরেকটি ছবি মুছে দিতে পারে।

util — inspect আর বাকি সাহায্যকারী

console.log object ছাপার সময় ভেতরে util.inspect ব্যবহার করে — সেজন্যই তৃতীয় স্তরের পরের object [Object] দেখায়। পুরোটা দেখতে util.inspect(obj, { depth: null }) বা console.dir(obj, { depth: null }). util.promisify আগেই দেখেছেন; util.types.isPromise(x)-এর মতো type-যাচাইও এখানে।

Event loop খালি রাখুন — CPU-ভারী কাজ অন্য thread-এ

Async API ফাইল আর নেটওয়ার্কের অপেক্ষা সরিয়ে দেয়, কিন্তু হিসাব সরায় না। ৫ লাখ সারির CSV-র পরিসংখ্যান, ছবির আকার বদলানো, বড় JSON parse — এগুলো CPU-bound, চলে main thread-এই, আর চলার সময় সব request আটকে থাকে (blocking). সমাধান পর্ব ৪২-এ দেখা ধারণার Node-রূপ: worker_threads দিয়ে আলাদা thread-এ পাঠানো, বা কাজটা আলাদা process/queue-তে সরানো। নিয়মটা মনে রাখার সহজ উপায়: একটি request handler কয়েক মিলিসেকেন্ডের বেশি একটানা হিসাব করলে সেটি সন্দেহজনক।

Node-এর version, আর Deno ও Bun

Node বছরে দুটি major version প্রকাশ করে আসছে। এতদিনের নিয়মে জোড় সংখ্যার version (18, 20, 22, 24…) অক্টোবরের দিকে LTS হয় আর মোট প্রায় ৩০ মাস নিরাপত্তা আপডেট পায়; বিজোড় version (21, 23…) কয়েক মাসের “Current” থাকে, LTS হয় না। Production-এ সবসময় সমর্থন চলছে এমন একটি LTS নিন। এই পাতার রানার Node 20 ব্যবহার করে — উদাহরণ শেখার জন্য যথেষ্ট, কিন্তু Node 20-এর সমর্থন ২০২৬ সালের এপ্রিলে শেষ হয়েছে, তাই নতুন প্রজেক্টে নতুন LTS নিন। Release-এর নিয়ম মাঝে মাঝে বদলায়, তাই সিদ্ধান্তের আগে nodejs.org-এর release পাতা দেখে নিন।

Node একমাত্র server-side JavaScript runtime নয়। Deno (Node-এর স্রষ্টা Ryan Dahl-এর দ্বিতীয় প্রচেষ্টা, ১.০ এসেছিল ২০২০ সালে) ডিফল্টে ফাইল বা নেটওয়ার্কে প্রবেশাধিকার দেয় না — --allow-read-এর মতো অনুমতি চাইতে হয় — আর TypeScript সরাসরি চালায়। Bun (১.০ ২০২৩ সালে) V8-এর বদলে Safari-র JavaScriptCore engine ব্যবহার করে, Zig ভাষায় লেখা, আর runtime, package manager, bundler ও test runner এক সাথে দেয়। দুটিই এখন বেশিরভাগ Node API আর npm package চালাতে পারে। তবে ecosystem, hosting আর চাকরির বাজারে Node-ই এখনো প্রধান — তাই এখানে যা শিখলেন, তা তিন জায়গাতেই কাজে লাগবে।

৯ · AI-এর যুগে — Node কোডে AI-এর পরিচিত ভুল

“একটি Express route লিখে দাও যা ফাইল পড়ে” — AI কয়েক সেকেন্ডে কোড দেয়, আর বেশিরভাগ সময় তা চলেও। কিন্তু “চলে” আর “একশো জন একসাথে ব্যবহার করলে, Windows-এ, বড় ফাইলে, খারাপ ইনপুটে চলে” — এক কথা নয়। AI-এর লেখা Node কোডে এই ভুলগুলো বারবার দেখা যায়:

AI-এর Node কোড হাতে পেলে — যাচাইয়ের চেকলিস্ট

• “Sync” লিখে খুঁজেছি — request বা event-এর পথে কোনো sync ফাইল/crypto কাজ নেই
• সব পথ path.join/resolve দিয়ে; হাতে লেখা / বা \ নেই; ব্যবহারকারীর নাম দিয়ে ফোল্ডারের বাইরে যাওয়া যায় না
• exec বা shell: true-এ কোনো বাইরের ইনপুট ঢুকছে না
• প্রতিটি stream-এর শিকল pipeline দিয়ে, error-এর জন্য catch আছে
• বড় হতে পারে এমন ফাইল পুরোটা মেমরিতে তোলা হচ্ছে না
• বাংলা লেখার bytes আর length গুলিয়ে ফেলা হয়নি (Content-Length, slice, chunk-এর সীমানা)
• Windows আর Linux দুই জায়গায় অন্তত একবার চালিয়ে দেখেছি (বা CI-তে)