Error-এর ছবি: throw, catch, আর call stack-এর খুলে যাওয়া

Sadia-র একটা bakery আছে, বড় বড় order নেয়। প্রতি সন্ধ্যায় ওর staff পরের দিনের quantity একটা sheet-এ টাইপ করে, আর ছোট একটা program সব যোগ করে oven-এর হিসাব দেয়। গত মঙ্গলবার কেউ 10-এর জায়গায় 1o লিখে ফেলেছিল, শূন্যের বদলে ইংরেজি o। Program কোনো আপত্তি করেনি। Total দেখিয়েছে NaN, oven-এর হিসাবে কাজের কিছুই ছিল না, আর সকালের আগে কেউ টেরই পায়নি।

Sadia-র ভাগ্নে তাড়াতাড়ি একটা সমাধান করে দিল: এখন program প্রথম ভুল entry পেলেই থেমে যায়। এটা আরও খারাপ। একটা typo এখন বাকি সব entry ঢেকে দেয়, ঠিকগুলোও। Sadia আসলে চায় মাঝামাঝি কিছু। ভুল entry-র নাম জোরে বলা হোক, আর sheet-এর বাকিটা তবুও গোনা হোক। Error ঠিক এই কাজের জন্যই, আর এই module সেটাই গুছিয়ে শেখাবে।

Value ভুল হলেও JavaScript প্রায়ই চলতেই থাকে

JavaScript-এর অনেক কাজ ভুল value পেলে থামে না। একটা অদ্ভুত value দিয়ে দেয়, তারপর এগিয়ে যায়। Number("1o") হলো NaN, আর NaN-এর সাথে যা-ই যোগ করো, NaN। Module 2-এ এটা দেখেছ।

const sheet = ["12", "1o", "7"];
let total = 0;
for (const entry of sheet) total += Number(entry);
console.log(total);
console.log(Number("1o"));

NaN
NaN

Program শেষ পর্যন্ত চলেছে আর print করেছে NaN। কোন entry-তে সমস্যা, কিছুই বলেনি। চুপচাপ ভুল উত্তর সবচেয়ে দামি bug, কারণ সে ছড়ায়। এখানে ছড়াতে ছড়াতে oven পর্যন্ত পৌঁছে গেছে।

throw function-টা থামিয়ে দেয়

ওষুধ হলো, যে জায়গাটা ভুলটা বোঝে, সেখানেই ভুল value-টা ফিরিয়ে দেওয়া। throw statement ঠিক এটাই করে। সে চলতি function-টা সাথে সাথে থামিয়ে দেয়, আর সমস্যাটা ওপরের দিকে পাঠায়। Throw করো একটা Error object, যেটা বানাও new Error(message) দিয়ে, যেখানে message বলে কী গোলমাল হয়েছে।

function readQty(text) {
  if (!/^\d+$/.test(text)) throw new Error("not a number: " + text);
  return Number(text);
}
console.log(readQty("12"));
console.log(readQty("1o"));
console.log(readQty("7"));

12
Error: not a number: 1o

প্রথম call 12 return করে। দ্বিতীয়টা throw করে, আর কেউ ধরছে না বলে Node পুরো program থামিয়ে দেয়, বলে Error: not a number: 1o। তৃতীয় লাইন কখনো চলেই না। এটাই ভাগ্নের সমাধান: জোরে বলে ঠিকই, কিন্তু সবকিছু শেষ করে দেয়।

/^\d+$/ pattern-টার মানে "শুরু থেকে শেষ পর্যন্ত শুধু digit"। Module 16-এ এটা আবার আসবে। আপাতত এটাকে পড়ো "পুরোটা কি digit?" হিসেবে।

try আর catch সমস্যাটা হাতে নেয়

try block বলে, "এটা চালাও, আর কিছু throw হলে program থামিয়ো না"। ঠিক পরের catch block বলে, তখন বদলে কী করতে হবে। Throw হওয়া Error-টা catch-এ আসে একটা parameter হয়ে, সাধারণত নাম দেওয়া হয় err।

function readQty(text) {
  if (!/^\d+$/.test(text)) throw new Error("not a number: " + text);
  return Number(text);
}
const sheet = ["12", "1o", "7"];
let total = 0;
for (const entry of sheet) {
  try {
    total += readQty(entry);
  } catch (err) {
    console.log("skipped " + entry + " (" + err.message + ")");
  }
}
console.log("total " + total);

skipped 1o (not a number: 1o)
total 19

Sadia এটাই চেয়েছিল। ভুল entry-র নাম বলা হলো, কারণসহ। ঠিক entry-গুলো তবুও গোনা হলো। try কোথায় বসেছে, খেয়াল করো: loop-এর ভেতরে। একটা throw শুধু loop-এর ওই একটা পালা শেষ করে, পরের entry নতুন করে শুরু হয়। একই try পুরো loop-এর চারপাশে বসালে প্রথম ভুল entry-তেই loop শেষ হয়ে যেত।

কিছু throw না হলে catch পুরোটাই বাদ যায়। কিছু throw হলে try block-এর বাকিটা বাদ যায়। উদাহরণে 1o-এর জন্য total += readQty(entry) কিছুই যোগ করে না, কারণ readQty কখনো return-ই করেনি।

Throw call stack বেয়ে নামে

আসল program-এ throw খুব কমই catch-এর ঠিক পাশে থাকে। একটা function আরেকটাকে call করে, সেটা আরেকটাকে, আর সবচেয়ে ভেতরেরটা সমস্যা খুঁজে পায়। Module 5 এটাকে এঁকেছিল call stack হিসেবে: প্রতিটা call ওপরে একটা frame বসায়, প্রতিটা return একটা সরায়।

Throw-ও এই stack-টাই ব্যবহার করে, ওপর থেকে নিচে। readQty throw করলে ওর নিজের frame শেষ হয়। ওর caller যদি call-টা try দিয়ে না মোড়ে, caller-এর frame-ও শেষ, এভাবে নিচের দিকে। এটাকে বলে unwinding, মানে stack খুলে যাওয়া। এটা থামে প্রথম সেই frame-এ, যে call-টা করেছিল একটা try-এর ভেতরে। ওই frame-এর catch চলে, আর program ওখান থেকে এগোয়।

function readQty(text) {
  if (!/^\d+$/.test(text)) throw new Error("not a number: " + text);
  return Number(text);
}
function addLine(text) {
  const qty = readQty(text);
  console.log("added " + qty);
  return qty;
}
function importSheet(sheet) {
  let sum = 0;
  for (const text of sheet) sum += addLine(text);
  return sum;
}
try {
  console.log(importSheet(["12", "1o", "7"]));
} catch (err) {
  console.log("import failed: " + err.message);
}

added 12
import failed: not a number: 1o

added 12 print হয়, তারপর দ্বিতীয় লাইন readQty-এর ভেতরে throw করে। addLine আর print করে না, importSheet কোনো যোগফল return করে না, আর চলে top-level-এর catch। এখানে একটা throw পুরো দুটো function-এর কাজ বাতিল করে দিল। এটা ঠিক কি না, program-এর ওপর নির্ভর করে। Sadia-র sheet-এর জন্য ঠিক না, ওখানে try থাকা উচিত loop-এর ভেতরে। কিন্তু এমন config file, যেটা হয় পুরো ঠিক, নয়তো একদমই ব্যবহার হবে না, তার জন্য এটাই ঠিক।

নিচের widget ওই program-এর throw-টা আবার চালিয়ে দেখায়, একটা আসল run থেকে বানানো। প্রতিটা function শুরু হলে ওর frame বসে। তারপর throw ওগুলোকে একটা একটা করে সরায়। Widget খুলে যাওয়াটা return-এর মতো করে দেখায়, কিন্তু এখানে কোনো frame কোনো value return করে না। Error পার হয়ে যাওয়ার সময় প্রতিটা শুধু শেষ হয়ে যায়।

দুবার ধাপে ধাপে দেখো। প্রথমবার দেখো stack চারটা frame পর্যন্ত বাড়ছে। দ্বিতীয়বার দেখো খুলে যাওয়াটা: readQty-এর নিচের কেউ কোনো value পায় না, আর একদম নিচের frame-টাই সেই জায়গা যেখান থেকে program এগোয়।

একটা Error-এর সাথে থাকে name, message আর stack

Error একটা object, আর ওর তিনটা property রোজ কাজে লাগে। name বলে কোন ধরনের error, যেমন Error বা TypeError। message হলো তুমি যে বাক্যটা দিয়েছিলে। stack একটা text, যেটা Node ভরে দেয় Error তৈরির সময়: name আর message, তারপর প্রতিটা frame-এর জন্য এক লাইন, ওপরের frame আগে।

JavaScript নিজেও Error throw করে। undefined-এর কোনো property পড়তে গেলে throw হয় একটা TypeError, Module 8 যেমন দেখিয়েছিল। ওগুলো ধরো একদম নিজেরগুলোর মতোই।

function firstLetter(user) {
  return user.name[0];
}
try {
  firstLetter({});
} catch (err) {
  console.log(err.name);
  console.log(err.message);
  console.log(err instanceof TypeError, err instanceof Error);
}

TypeError
Cannot read properties of undefined (reading '0')
true true

{}-এর কোনো name নেই, তাই user.name হলো undefined, আর ওর [0] পড়তে গেলে throw হয়। তুমি কোথাও throw লেখোনি, তবু catch একটা পুরো Error পেয়েছে। instanceof বলে দেয় ওটা কোন ধরনের: TypeError একই সাথে একটা Error-ও। Lesson 02 প্রতিটা built-in ধরন আর প্রতিটার জন্য Node-এর আসল message-এর তালিকা দেবে।

String না, Error throw করো

JavaScript যেকোনো value throw করতে দেয়: throw "too big" চলে। এটা কোরো না। String-এর কোনো name, message বা stack নেই, তাই catch বুঝতে পারে না কী হয়েছে বা কোথায়। যে code err.message পড়ে, সে পায় undefined। নিচের প্রথম ভুলটা এটাই দেখায়। সবসময় throw করো new Error(...), বা ওর কোনো ধরন।

throw new Error("what went wrong");   // stop this function, hand the Error upward
try {                                  // run this block...
  risky();                             // ...if it throws, jump to catch
} catch (err) {                        // err is the thrown Error
  err.name; err.message; err.stack;    // its kind, its sentence, its frames
}
// the rest of the program goes on here

const input = require("fs").readFileSync(0, "utf8");
const tokens = input.split(/\s+/).filter(Boolean);

function parseItem(text) {
  const parts = text.split(":");
  if (parts.length !== 2) throw new Error("expected name:price in " + text);
  const price = Number(parts[1]);
  if (!Number.isInteger(price) || price <= 0) throw new Error("bad price in " + text);
  return { name: parts[0], price };
}

let refused = 0;
for (const text of tokens) {
  try {
    const item = parseItem(text);
    console.log(item.name.padEnd(8) + String(item.price).padStart(5));
  } catch (err) {
    refused++;
    console.log("refused: " + err.message);
  }
}
console.log(refused + " refused");

tea        20
refused: bad price in cake:x2
bun        15
refused: expected name:price in samosa
refused: bad price in naan:-5
lassi      60
3 refused

function cityOf(order) {
  return order.customer.city.toUpperCase();
}
function label(order) {
  return order.id + " to " + cityOf(order);
}
function printLabels(orders) {
  for (const o of orders) console.log(label(o));
}
try {
  printLabels([{ id: 7, customer: { city: "Khulna" } }, { id: 8, customer: {} }]);
} catch (err) {
  console.log(err.name + ": " + err.message);
  const frames = err.stack.split("\n").filter((l) => l.includes("main.js"));
  for (const f of frames) console.log(f.trim().replace(/\(.*main\.js/, "(main.js"));
}

7 to KHULNA
TypeError: Cannot read properties of undefined (reading 'toUpperCase')
at cityOf (main.js:2:30)
at label (main.js:5:30)
at printLabels (main.js:8:39)
at Object.<anonymous> (main.js:11:3)

try {
  console.log(Number("12"));
}
console.log("done");

function checkQty(qty) {
  if (qty > 500) throw "too big";
  return qty;
}
try {
  checkQty(900);
} catch (err) {
  console.log("problem: " + err.message);
  console.log(typeof err);
}

problem: undefined
string

try {
  const total = Number("12") + Number("7");
} catch (err) {
  console.log(err.message);
}
console.log(total);

ReferenceError: total is not defined

function check(n) {
  console.log("check " + n);
  if (n > 2) throw new Error("too big: " + n);
  console.log("ok " + n);
}
try {
  check(1);
  check(3);
  check(2);
} catch (err) {
  console.log(err.message);
}
console.log("done");

6
12
007
1e2
0
ten
500

ok 12
ok 7
bad 1e2: not a number
bad 0: out of range
bad ten: not a number
ok 500
total 519 from 3 good

const input = require("fs").readFileSync(0, "utf8");
const tokens = input.split(/\s+/).filter(Boolean);
let at = 0;
const next = () => tokens[at++];
const nextInt = () => Number(next());
const out = [];

// your code: read with next() and nextInt(), push every line of output to out

console.log(out.join("\n"));

3
4
main catch
load catch
parse pass
readQty pass
2
main pass
boom pass
3
app catch
api pass
db pass

load catches, 2 frames unwound
uncaught, 2 frames unwound
app catches, 2 frames unwound

const input = require("fs").readFileSync(0, "utf8");
const tokens = input.split(/\s+/).filter(Boolean);
let at = 0;
const next = () => tokens[at++];
const nextInt = () => Number(next());
const out = [];

// your code: read with next() and nextInt(), push every line of output to out

console.log(out.join("\n"));

5
7 + 5
9 / 0
3 x 4
ten * 2
-9 / 2

const input = require("fs").readFileSync(0, "utf8");
const tokens = input.split(/\s+/).filter(Boolean);
let at = 0;
const next = () => tokens[at++];
const nextInt = () => Number(next());
const out = [];

// your code: read with next() and nextInt(), push every line of output to out

console.log(out.join("\n"));

12
error RangeError: division by zero
error Error: unknown operator x
error TypeError: not a number: ten
-4

এরপর: error সামলানোর প্রতিটা অংশ, একটা একটা করে, finally, built-in ধরনগুলো আর তোমার নিজেরগুলো সহ।