في الدرسين السابقين أكملت أجسام دوال كُتبت لك. والآن تكتب دوالّك بنفسك. الدالة (function) قطعة من البرنامج لها اسم ويمكن إعادة استخدامها: تكتب الخطوات مرة واحدة وتنفّذها متى احتجت، بمدخلات مختلفة. يُنسّق Pocket المبالغ المالية في أماكن كثيرة؛ ودون الدوال ستنسخ (cents / 100).toFixed(2) في كل منها، ثم تُصلح كل نسخة حين يتغيّر التنسيق.
function formatMoney(cents) {\n const dollars = (cents / 100).toFixed(2);\n return `$${dollars}`;\n}\n\nconsole.log(formatMoney(1220));\nconsole.log(formatMoney(450));الأسطر الخمسة الأولى تصريح دالة (function declaration). إنها لا تنفّذ شيئًا؛ بل تُنشئ دالة اسمها formatMoney وتحفظ خطواتها. وcents معامل (parameter)، أي اسم لمُدخل ليست له قيمة بعد.
أما formatMoney(1220) فهو استدعاء (call). والقيمة بين القوسين، 1220، وسيط (argument). حين يصل المحرّك إلى الاستدعاء، يوقف السطر الحالي مؤقتًا، ويقفز إلى داخل الدالة وcents تشير إلى 1220، فينفّذ الجسم، ثم يعود حين يصل إلى return. بعدها يُستبدل تعبير الاستدعاء بالقيمة المُعادة، "$12.20"، فتطبعها console.log.
يمكن أن يكون للدالة عدّة معاملات تفصل بينها فواصل، وتُطابَق الوسائط معها حسب الموضع: الوسيط الأول يذهب إلى المعامل الأول، وهكذا.
\nلـ return وظيفتان: تحدّد النتيجة، وتُنهي الدالة في مكانها. أي سطر بعد return في الكتلة نفسها لا يُنفَّذ أبدًا. وإذا انتهت الدالة دون أن تصل إلى return، فإن قيمة الاستدعاء تكون undefined.
إذا استدعيت دالة بوسائط أقل من معاملاتها، تكون المعاملات الناقصة undefined. والمعامل الافتراضي (default parameter) يمنحها قيمة معقولة بدلًا من ذلك:
function formatMoney(cents, symbol = \"$\") {\n return `${symbol}${(cents / 100).toFixed(2)}`;\n}\n\nconsole.log(formatMoney(1220));\nconsole.log(formatMoney(1220, \"€\"));تُستخدم القيمة الافتراضية حين يكون الوسيط مفقودًا أو undefined، وحينها فقط. أما تمرير 0 أو "" أو null فيُعدّ وسيطًا حقيقيًا.
هناك طريقة ثانية أقصر لكتابة الدوال، هي الدالة السهمية (arrow function). إنها قيمة، لذلك تخزّنها في const:
const toCents = (dollars) => Math.round(dollars * 100);\nconst isBig = (cents) => cents >= 10000;\n\nconsole.log(toCents(12.2), isBig(toCents(120)));حين يكون الجسم تعبيرًا واحدًا، كما هنا، تحذف الأقواس المعقوفة وreturn: فقيمة التعبير تُعاد تلقائيًا. وحين تحتاج إلى عدّة تعليمات، استخدم الأقواس المعقوفة، وعندها تصبح return مطلوبة من جديد:
const budgetLeft = (budget, spent) => {\n const left = budget - spent;\n return left > 0 ? left : 0;\n};\nconsole.log(budgetLeft(2000, 2200));أيّ الأسلوبين تستخدم؟ كلاهما منتشر في الكود الحقيقي. والاختيار الافتراضي الشائع، الذي تتبعه هذه الدورة: التصريح للدوال المسمّاة في المستوى الأعلى، والدوال السهمية للدوال القصيرة التي تُمرَّر إلى دوال أخرى. وهناك فرق عملي واحد: تصريحات الدوال تُرفع (hoisting)، أي يمكنك استدعاؤها في سطر يسبق مكان كتابتها. أما الدالة السهمية المخزّنة في const فلا توجد إلا بعد أن يُنفَّذ سطرها.
الدالة في JavaScript قيمة مثل الرقم أو النص. يمكنك تخزينها، ويمكنك تمريرها إلى دالة أخرى بصفتها وسيطًا. وهذه الفكرة وراء جزء كبير من JavaScript الحديثة:
\nfunction applyToAll(amounts, transform) {\n const results = [];\n for (const amount of amounts) {\n results.push(transform(amount));\n }\n return results;\n}\n\nconst formatMoney = (cents) => `$${(cents / 100).toFixed(2)}`;\nconsole.log(applyToAll([450, 1220], formatMoney));\nconsole.log(applyToAll([450, 1220], (c) => c * 2));applyToAll لا تعرف ما تفعله transform ولا يهمّها ذلك؛ إنها تستدعيها مرة لكل عنصر وتجمع النتائج باستخدام push، التي تضيف عنصرًا إلى نهاية المصفوفة. والدالة التي تُمرَّر بهذه الطريقة تُسمّى callback (دالة استدعاء راجع). لاحظ أنك تمرّر formatMoney دون أقواس: فأنت تسلّم الدالة نفسها، لا تستدعيها. وللمصفوفات أداة مدمجة تفعل هذا بالضبط، اسمها map، وسيضعها القسم 3 موضع العمل.
لاحظ ما تشترك فيه كل الدوال المساعدة في هذا الدرس: إنها لا تستخدم إلا معاملاتها، وتُرجع نتيجة، ولا تغيّر شيئًا خارجها. الدالة من هذا النوع تُسمّى نقية (pure). أعطها الوسائط نفسها تُعِد الإجابة نفسها في كل مرة، فتستطيع اختبارها بسطر واحد، وإعادة استخدامها في أي مكان، والثقة بها دون أن تقرأ جسمها مجددًا.
\nليست كل دالة قادرة على أن تكون نقية. لا بدّ لشيء ما في النهاية أن يطبع على الشاشة أو يحفظ البيانات. والعادة التي تُبقي البرامج تحت السيطرة هي أن تُجري الحسابات في دوال صغيرة نقية، وأن تُبقي الطباعة والحفظ في أماكن قليلة ذات أسماء واضحة. ويتبع Pocket هذا الفصل حتى التطبيق النهائي.
\n\nالدوال تُنشئ داخلها عالمًا صغيرًا من الأسماء خاصًا بها. وعلاقة هذا العالم بالكود المحيط به تُسمّى النطاق (scope)، وهي موضوع الدرس التالي.
\n","toc":[{"id":"sec-1","text":"التصريح بدالة واستدعاؤها","level":2},{"id":"sec-2","text":"المعاملات الافتراضية","level":2},{"id":"sec-3","text":"الدوال السهمية","level":2},{"id":"sec-4","text":"الدوال قيم","level":2},{"id":"sec-5","text":"دوال صغيرة ونقية","level":2}],"takeaways":["الدالة تحزم خطوات تحت اسم واحد؛ والمعاملات (parameters) هي المدخلات التي تعلنها الدالة، أما الوسائط (arguments) فهي القيم التي تمرّرها حين تستدعيها.","return تُنهي الدالة وتُعيد قيمة؛ والدالة التي لا تحتوي على return تُعيد undefined.","الدوال السهمية ((x) => x * 2) صياغة أقصر؛ ومع الأقواس المعقوفة تحتاج إلى return صريحة.","المعاملات الافتراضية (symbol = "$") تُطبَّق حين يكون الوسيط مفقودًا أو undefined.","الدوال قيم، لذلك يمكنك تخزينها في متغيّرات وتمريرها إلى دوال أخرى."],"further":[{"title":"Functions (MDN guide)","url":"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Functions"},{"title":"Arrow function expressions (MDN)","url":"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions"},{"title":"Default parameters (MDN)","url":"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters"}],"quiz":[{"q":"ماذا يطبع هذا الكود؟
\nconst double = (n) => {\n n * 2;\n};\nconsole.log(double(4));undefined","why":"صحيح. الجسم المحاط بأقواس معقوفة دون return يُعيد undefined. اكتب (n) => n * 2 أو أضف return n * 2;."},{"text":"8","why":"الجسم يحسب 8 ثم يرميه. مع الأقواس المعقوفة، تحتاج الدالة السهمية إلى return صريحة."},{"text":"n * 2","why":"تحسب JavaScript التعبيرات؛ ولا تُعيد أبدًا نصّها المكتوب."}],"answer":0},{"q":"الدالة function formatMoney(cents, symbol = "$") { … } استُدعيت هكذا: formatMoney(450, undefined). ما قيمة symbol داخلها؟
undefined، لأنك مرّرتها صراحةً.","why":"القيم الافتراضية تُطبَّق على الوسائط المفقودة وعلى الوسائط التي قيمتها undefined، سواء مُرّرت أم لا."},{"text":""$"","why":"صحيح. تمرير undefined يُعامَل تمامًا مثل حذف الوسيط، فتُطبَّق القيمة الافتراضية."},{"text":"null","why":"لا شيء هنا يُنتج null. ثم إن تمرير null لا يُفعّل القيمة الافتراضية؛ وحدها undefined تفعل ذلك."}],"answer":1},{"q":"أيّ سطر يستدعي isBig قبل تعريفها دون أن يحدث خطأ؟
console.log(isBig(100)); const isBig = (c) => c > 50;","why":"أسماء const لا يمكن استخدامها قبل أن يُنفَّذ سطرها، لذلك يرمي هذا خطأ ReferenceError."},{"text":"console.log(isBig(100)); let isBig = function (c) { return c > 50; };","why":"قيمة الدالة مخزّنة في let، وهي غير متاحة قبل سطر التصريح بها."},{"text":"console.log(isBig(100)); function isBig(c) { return c > 50; }","why":"صحيح. تصريحات الدوال “تُرفع” (hoisted)، أي أن الدالة كاملة تكون متاحة من أعلى نطاقها."}],"answer":2},{"q":"لديك const amounts = [450, 1220]; وfunction toDollars(c) { return c / 100; }. ماذا يحتاج منك amounts.map(toDollars)؟
map تستدعي toDollars لكل عنصر وتجمع النتائج.","why":"صحيح. أنت تمرّر الدالة نفسها، دون أقواس، وmap تقرّر متى تستدعيها."},{"text":"amounts.map(toDollars()) مع الأقواس، كي تُنفَّذ الدالة.","why":"هذا يستدعي toDollars مرة واحدة فورًا دون أي وسيط، ويمرّر ناتجها، NaN، إلى map، التي ترمي خطأ حينها."},{"text":"حلقة تكرار حولها، لأن map لا تعمل إلا مع قيمة واحدة.","why":"map تمرّ على المصفوفة كلها بنفسها. وهذا هو الهدف من تمرير دالة إليها."}],"answer":0}],"exercise":{"kind":"web","mode":"js","starter":{"js":"// 1. Dollars (like 4.1) to whole cents (410)\nfunction toCents(dollars) {\n}\n\n// 2. Cents to a display string, with a symbol that defaults to \"$\"\nfunction formatMoney(cents) {\n}\n\n// 3. Replace null with an arrow function: true for 10000 cents or more\nconst isBig = null;\n\n// 4. Count the amounts for which test(amount) returns true\nfunction countWhere(amounts, test) {\n return 0;\n}\n\nconsole.log(formatMoney(toCents(12.2)));\n"},"solution":{"js":"function toCents(dollars) {\n return Math.round(dollars * 100);\n}\n\nfunction formatMoney(cents, symbol = \"$\") {\n return `${symbol}${(cents / 100).toFixed(2)}`;\n}\n\nconst isBig = (cents) => cents >= 10000;\n\nfunction countWhere(amounts, test) {\n let count = 0;\n for (const amount of amounts) {\n if (test(amount)) {\n count++;\n }\n }\n return count;\n}\n\nconsole.log(formatMoney(toCents(12.2)));\n"},"checks":[{"id":"to-cents","test":"return toCents(4.1) === 410 && toCents(12.2) === 1220 && toCents(0.07) === 7;\n"},{"id":"format","test":"return formatMoney(1220) === '$12.20' && formatMoney(5) === '$0.05';\n"},{"id":"format-symbol","test":"return formatMoney(1220, '€') === '€12.20' && formatMoney(450, undefined) === '$4.50';\n"},{"id":"is-big-arrow","test":"return typeof isBig === 'function' && !('prototype' in isBig) && isBig(10000) === true && isBig(9999) === false;\n"},{"id":"count-where","test":"const amounts = [450, 12000, 99, 10000];\nreturn countWhere(amounts, isBig) === 2 && countWhere(amounts, (c) => c < 100) === 1 && countWhere([], isBig) === 0;\n"}],"title":"الدوال المساعدة للمال في Pocket","prompt":"اكتب أربع دوال صغيرة سيستخدمها Pocket من الآن فصاعدًا:
\ntoCents(dollars) تُرجع المبلغ بالسنتات الصحيحة (4.1 تعطي 410).formatMoney(cents, symbol) تُرجع نصًا مثل "$12.20". والقيمة الافتراضية لـ symbol هي "$".isBig، وهي دالة سهمية تُرجع true لمبلغ 10000 سنت أو أكثر.countWhere(amounts, test) تُرجع عدد العناصر في amounts التي تجعل الـ callback test(amount) تُرجع قيمة truthy.Math.round، لأن 4.1 * 100 لا تساوي 410 بالضبط. وتذكّر return: دونها يعطي كل استدعاء undefined.","المعامل الافتراضي يُكتب في قائمة المعاملات: function formatMoney(cents, symbol = "$").","const isBig = (cents) => cents >= 10000; وفي countWhere، استدعِ الـ callback داخل حلقة: if (test(amount)) { count++; }."],"explanation":"كل دالة مساعدة تُرجع نتيجتها بدلًا من طباعتها، فيستطيع المُستدعون الجمع بينها: formatMoney(toCents(12.2)) تُدخل القيمة المُعادة من دالة مباشرةً في الدالة التالية. والقيمة الافتراضية symbol = "$" تُطبَّق كلما كان الوسيط مفقودًا أو undefined. وتستخدم isBig الصيغة القصيرة للدالة السهمية، حيث التعبير الوحيد بعد => هو القيمة المُعادة. أما countWhere فلا تحتاج أبدًا إلى معرفة ما يفحصه الاختبار؛ إنها تستدعي أي دالة أُعطيت لها، مرة لكل مبلغ. وتمرير isBig دون أقواس يسلّم الدالة نفسها، وهكذا بالضبط تعمل دوال المصفوفات في القسم 3.
toCents تُرجع سنتات صحيحة","format":"formatMoney تُرجع نصوصًا مثل “$12.20”","format-symbol":"formatMoney تستخدم رمزًا مخصّصًا، وقيمته الافتراضية “$”","is-big-arrow":"isBig دالة سهمية بحدّ 10000 سنت","count-where":"countWhere تعدّ العناصر التي تجتاز الـ callback"}},"words":646,"readMinutes":4}