الـ functions: parameters و return والـ arrow functions والـ scope

أهلًا بيك. أي backend، مهما كان كبير، هو functions بتنادي functions. الـ function آلة ليها اسم: بتديها قيم، اسمها parameters، وبترجعلك نتيجة بـ return. أول function: vat، بتحسب الضريبة: السعر في zero point one four. نشغّل.

function vat(price) {
  return price * 0.14;
}

console.log(vat(100));
console.log(vat(250));

$ node main.js
14.000000000000002
35

خمسة وتلاتين تمام. بس بص على الأولى: أربعتاشر، وبعدها أصفار كتير، وفي الآخر اتنين! ده مش bug في الـ function، ده الـ floating point: الكمبيوتر بيخزن الكسور بتقريب. وعلشان كده في أي backend فيه فلوس، بنحسب بالقروش كأرقام صحيحة، مش بالجنيه بكسور. وهنرجعلها في درس الـ payments. والمهم هنا: كتبنا الحساب مرة واستخدمناه مرتين، ولو النسبة اتغيرت بتغيّرها في مكان واحد. function بأكتر من parameter. total بتاخد السعر والكمية. والكمية ليها قيمة افتراضية: one، يعني لو ما اتبعتتش. وهنجرّب أربع مرات: عادي، ومن غير كمية، وبـ string، ومن غير أي حاجة. نشغّل.

function total(price, qty = 1) {
  return price * qty;
}

console.log(total(100, 3));
console.log(total(100));
console.log(total("100"));
console.log(total());

$ node main.js
300
100
100
NaN

تلتمية. مِيّة، لأن الكمية بقت one لوحدها. والـ string اتحوّل لرقم في الضرب، فطلع مِيّة. ومن غير حاجة خالص: NaN، لأن price بقت undefined. JavaScript مش بتزعّق لو بعتّ parameters ناقصة. وده سبب إن الـ backend لازم يعمل validation على كل حاجة جاية من برة، وده درس كامل قدام. نفس الـ function ممكن تتكتب بتلات أشكال. function عادية. function متخزنة في const. و arrow function، بالـ arrow ده: equals و greater than. ولو هي سطر واحد، النتيجة بترجع لوحدها من غير return. وتحت: function من غير return خالص، بتطبع بس. نشغّل.

// نفس الـ function بأشكال مختلفة
function square1(n) {
  return n * n;
}
const square2 = function (n) {
  return n * n;
};
const square3 = (n) => n * n;

console.log(square1(4), square2(4), square3(4));

// function من غير return بترجّع undefined
const log = (msg) => {
  console.log(`[log] ${msg}`);
};
console.log(log("started"));

$ node main.js
16 16 16
[log] started
undefined

التلاتة طلعوا ستاشر. والـ log طبعت الرسالة، وبعدين console dot log اللي برة طبعت undefined، لأن الـ function ما رجّعتش حاجة. افتكر الحتة دي: لو نسيت return، النتيجة undefined، ودي من أشهر الـ bugs. الـ scope، يعني مين شايف مين. counter برة الـ function، فالـ function شايفاه وبتغيّره. بس local جُوّه الـ function، فبرة مش موجود. وتحت: early return. أول ما return تشتغل، الـ function بتخلص، وأي سطر بعدها ما بيتنفّش. نشغّل.

let counter = 0;

function hit() {
  counter++;
  const local = counter * 10;
  return local;
}

console.log(hit(), hit(), counter);
console.log(typeof local);

function early(age) {
  if (age < 18) return "ممنوع";
  return "مسموح";
  console.log("السطر ده عمره ما هيشتغل");
}
console.log(early(15), early(30));

$ node main.js
10 20 2
undefined
ممنوع مسموح

عشرة وعشرين، و counter بقى اتنين. و typeof local برة: undefined، مش موجود. و early: ممنوع ومسموح، والسطر اللي بعد آخر return ما اشتغلش. الـ early return ده هنستخدمه في كل validation: لو الحاجة غلط، ارجع فورًا، والباقي يفضل نضيف من غير if جُوّه if. التحدي: حارس على الباب. function اسمها isAllowed، بتاخد الـ method والـ path والـ role. أي حاجة بتبدأ بـ slash admin ممنوعة لغير الـ admin. والـ guest مسموحله GET بس. وبعدين تلف على الـ requests وتطبع النتيجة. الشروط وحالات الاختبار في الكومنت.

الحل. arrow function بـ role افتراضي guest. أول سطر: لو بيبدأ بـ slash admin والـ role مش admin، return false. التاني: لو مش GET والـ role بـ guest، return false. غير كده true. ومن غير ولا if جُوّه if. نشغّل.

// كل request جاي بـ method و path
const requests = [
  { method: "GET", path: "/courses" },
  { method: "POST", path: "/courses" },
  { method: "GET", path: "/admin" },
  { method: "DELETE", path: "/courses/7" },
];

const isAllowed = (method, path, role = "guest") => {
  if (path.startsWith("/admin") && role !== "admin") return false;
  if (method !== "GET" && role === "guest") return false;
  return true;
};

for (const r of requests) {
  console.log(`${r.method} ${r.path} → ${isAllowed(r.method, r.path)}`);
}

$ node main.js
GET /courses → true
POST /courses → false
GET /admin → false
DELETE /courses/7 → false

الأربعة زي الاختبار. وده بالزبط شكل الـ authorization اللي هنبنيه بعدين في Express. الدرس الجاي: الـ arrays والـ objects، والطرق اللي بنلف بيها عليهم.