الـ classes والـ errors: throw و try/catch و stack trace

أهلًا بيك. الـ class قالب بتعمل منه objects كتير بنفس الشكل. constructor بيتنادي مع new، وبيجهّز الـ object. this معناها الـ object نفسه. وأي field قبله hash، يعني private: محدش برة الـ class يقدر يقراه أو يغيّره. و get balance بتخلي الرصيد يتقري بس، من غير ما يتعدّل. نشغّل.

class Account {
  #balance = 0; // private: محدش يلمسه من برة

  constructor(owner) {
    this.owner = owner;
  }

  deposit(amount) {
    this.#balance += amount;
    return this.#balance;
  }

  get balance() {
    return this.#balance;
  }
}

const acc = new Account("مُنى");
acc.deposit(100);
acc.deposit(50);
console.log(acc.owner, acc.balance);
console.log(acc);

$ node main.js
مُنى 150
Account { owner: 'مُنى' }

مُنى ورصيدها مِيّة وخمسين. ولما طبعنا الـ object كله، الرصيد ما بانش أصلًا، لأنه private. يعني الطريقة الوحيدة إن الرصيد يتغيّر هي deposit. والفكرة دي مهمة جدًّا في الـ backend: البيانات الحساسة ما تتغيّرش غير من الطريق اللي إنتَ عامله. دلوقتي الأخطاء. لما function تلاقي حاجة غلط، بترمي error بـ throw. والـ throw بيوقف كل حاجة، لحد ما حد يمسكه بـ try و catch. جُوّه try بنسحب تلاتين، وبعدين خمسمية. و catch بتمسك الخطأ. و finally بتشتغل في كل الأحوال، سواء حصل خطأ أو لا، ومناسبة إنك تقفل connection مسلًا. نشغّل.

function withdraw(balance, amount) {
  if (amount <= 0) throw new Error("المبلغ لازم يكون موجب");
  if (amount > balance) throw new Error("الرصيد مش كفاية");
  return balance - amount;
}

try {
  console.log(withdraw(100, 30));
  console.log(withdraw(100, 500));
  console.log("السطر ده مش هيوصل");
} catch (err) {
  console.log("اتمسك:", err.message);
} finally {
  console.log("finally: بتشتغل في كل الأحوال");
}

$ node main.js
70
اتمسك: الرصيد مش كفاية
finally: بتشتغل في كل الأحوال

سبعين. وبعدين withdraw رمت، فالسطر اللي بعدها ما اتنفّش، وراحت على catch على طول: الرصيد مش كفاية. و finally اشتغلت في الآخر. من غير try، الـ throw ده كان هيوقّع البرنامج كله. في الـ backend مش كفاية تعرف إن فيه خطأ، لازم تعرف نوعه علشان ترد بالـ status الصح. AppError بتاخد كل حاجة من Error بـ extends، وبتزود status. و super بتنادي constructor الأب. و NotFoundError بتاخد من AppError، والـ status بتاعها four oh four. و instanceof بتسأل: الخطأ ده من النوع ده؟ نشغّل.

class AppError extends Error {
  constructor(message, status) {
    super(message);
    this.name = "AppError";
    this.status = status;
  }
}

class NotFoundError extends AppError {
  constructor(what) {
    super(`${what} مش موجود`, 404);
    this.name = "NotFoundError";
  }
}

function findCourse(id) {
  if (id !== 1) throw new NotFoundError("الكورس");
  return { id, title: "Node" };
}

try {
  findCourse(5);
} catch (err) {
  console.log(err instanceof NotFoundError, err instanceof AppError, err instanceof Error);
  console.log(err.name, err.status, err.message);
}

$ node main.js
true true true
NotFoundError 404 الكورس مش موجود

التلاتة true: الخطأ NotFoundError، وفي نفس الوقت AppError، وفي نفس الوقت Error، زي شجرة عيلة. والاسم والـ status والرسالة. وده بالزبط الأساس اللي هنبني عليه error handler كامل في Express: أي خطأ ليه status، يترد بيه، وأي خطأ مالوش يبقى five hundred. آخر حاجة: الـ stack trace. برنامج بيقرا port من config، بس الـ config undefined. والخطأ هيحصل جُوّه function، جُوّه function، جُوّه function. نشغّل.

function readConfig() {
  const config = undefined;
  return config.port;
}
function startServer() {
  return readConfig();
}

startServer();

$ node main.js

/home/you/my-backend/main.js:3
  return config.port;
                ^

TypeError: Cannot read properties of undefined (reading 'port')
    at readConfig (/home/you/my-backend/main.js:3:17)
    at startServer (/home/you/my-backend/main.js:6:10)
    at Object.<anonymous> (/home/you/my-backend/main.js:9:1)
    at Module._compile (node:internal/modules/cjs/loader:1812:14)
    at Object..js (node:internal/modules/cjs/loader:1943:10)
    at Module.load (node:internal/modules/cjs/loader:1533:32)
    at Module._load (node:internal/modules/cjs/loader:1335:12)
    at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)
    at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)
    at node:internal/main/run_main_module:33:47

Node.js v24.14.1

بص من فوق لتحت. TypeError: Cannot read properties of undefined، reading port. يعني بتقرا port من حاجة undefined. أول سطر at: readConfig، main dot js السطر تلاتة. ده المكان اللي الخطأ حصل فيه. اللي تحته: startServer، اللي نادت readConfig. وتحته الملف نفسه، السطر تسعة. يعني الـ stack trace هو الطريق بالعكس: من مكان الخطأ، لحد أول حاجة بدأت. وأي سطر فيه node colon internal ده جُوّه Node نفسه، عدّيه. التحدي: حساب بنكي ما يتغشّش. ValidationError بـ status four hundred. Account بـ رصيد private. deposit و withdraw بيرموا لو المبلغ مش رقم موجب، أو لو مش كفاية. والـ code اللي برة هو اللي يمسك ويطبع. والعمليات الغلط ما تغيّرش الرصيد. كل التفاصيل في الكومنت.

الحل. ValidationError بـ status four hundred. في Account: check private، بتتأكد إن المبلغ رقم وموجب، وبيستخدمها deposit و withdraw. و withdraw بتفحص الرصيد كمان. وبرة: attempt بتلف أي عملية بـ try وتطبع الـ status والرسالة. نشغّل.

class ValidationError extends Error {
  constructor(message) {
    super(message);
    this.name = "ValidationError";
    this.status = 400;
  }
}

class Account {
  #balance = 0;

  #check(amount) {
    if (typeof amount !== "number" || amount <= 0) throw new ValidationError("مبلغ غلط");
  }
  deposit(amount) {
    this.#check(amount);
    this.#balance += amount;
  }
  withdraw(amount) {
    this.#check(amount);
    if (amount > this.#balance) throw new ValidationError("الرصيد مش كفاية");
    this.#balance -= amount;
  }
  get balance() {
    return this.#balance;
  }
}

function attempt(fn) {
  try {
    fn();
  } catch (err) {
    console.log(err.status, err.message);
  }
}

const acc = new Account();
attempt(() => acc.deposit(200));
attempt(() => acc.withdraw(50));
attempt(() => acc.withdraw(500));
attempt(() => acc.deposit("10"));
console.log(`الرصيد: ${acc.balance}`);

$ node main.js
400 الرصيد مش كفاية
400 مبلغ غلط
الرصيد: 150

الرصيد مش كفاية، ومبلغ غلط مع الـ string، والرصيد مِيّة وخمسين بالزبط، زي ما اتطلب. الدرس الجاي آخر درس في تحت الصفر: git، علشان كل شغلك بعد كده يتحفَظ صح.