الانتقال إلى المحتوى
المواد
  • 1 بدء الاستخدام
    1.1

    أول برنامج لك

    البرنامج هو قائمة من التعليمات للحاسوب. في JavaScript، كل تعليمة هي statement، والحاسوب يشغل الجمل من الأعلى إلى الأسفل.

    يطبع console.log(...) قيمة في وحدة التحكم، وهي منطقة النص أسفل الكود:

    console.log("Hello, world!");
    console.log(7 * 6);   // 42
    
    • يوضع النص داخل علامات التنصيص: "Hello" أو 'Hello'. الأرقام لا.
    • انهِ كل statement بفاصلة منقوطة ;. JavaScript غالباً ما يخمن أين ينقص أحدها، لكن كتابته أكثر وضوحاً.
    • JavaScript حساس لحالة الأحرف: console.log يعمل، بينما Console.Log لا يعمل.

    يمكن لطباعة console.log عدة قيم في وقت واحد. يضع مسافة واحدة بينها:

    console.log("Total:", 3 + 4);   // Total: 7
    console.log(1, 2, 3);           // 1 2 3
    
    1.2

    التعليقات ونمط الكود

    التعليق هو ملاحظة للناس. يتجاهله JavaScript عند تشغيل البرنامج.

    // A one-line comment starts with two slashes.
    console.log("This line runs");   // a comment can follow code
    
    /* A block comment
       can cover several lines. */
    console.log("So does this one");
    

    النمط الجيد يجعل الكود سهل القراءة:

    • قسّط الأسطر داخل { } بمسافتين أو أربع مسافات، وافعل ذلك بنفس الطريقة دائماً.
    • أعطِ المتغيرات أسماءً تعبر عن ما تحتويه: total، لا t.
    • تستخدم أسماء JavaScript نمط camelCase: firstName، scoreTotal.
    // Work out the area of a rectangle
    const width = 4;
    const height = 3;
    console.log(width * height);   // 12
    

    أخطاء شائعة

    • النص يحتاج إلى علامات اقتباس متطابقة: "Hi' يُعد خطأً.
    • console.log حروفه جميعاً صغيرة: Console.log وconsole.Log أخطاء.
    • كل ما يأتي بعد // في السطر يتم تجاهله، لذا فإن // console.log(x) يطبع شيئاً فارغاً.
  • 2 القيم والمتغيرات والأنواع
    2.1

    let و const

    المتغير هو صندوق مُسمّى يحتوي على قيمة. أنشئه باستخدام let أو const، ثم استخدم اسمه:

    let score = 10;
    score = score + 5;      // let: the value can change
    console.log(score);     // 15
    
    const name = "Mei";     // const: the name cannot be reassigned
    console.log(name);      // Mei
    
    • = يعني الإسناد: احسب الطرف الأيمن، ثمخزنه في الصندوق الموجود على اليسار.
    • استخدم const بشكل افتراضي. استخدم let فقط عندما يجب تغيير القيمة لاحقاً.
    • إعادة إسناد لـ const يُعد خطأً: name = "Tom" غير مسموح بها. يمكن تعديل محتويات كائن أو مصفوفة ثابتة (const) رغم ثباتها.
    2.2

    الأرقام والعمليات الحسابية

    تُستخدم هذه الأمثلة لنوع الأعداد للقيم الصحيحة والعشرية. BigInt هو نوع صحيح منفصل. المشغلات الحسابية هي:

    العملية المعنى المثال النتيجة
    + - جمع، طرح 7 - 2 5
    * / ضرب، قسمة 7 / 2 3.5
    % باقي القسمة 7 % 2 1
    ** أس (قوة) 2 ** 3 8
    console.log(7 / 2);              // 3.5
    console.log(Math.floor(7 / 2));  // 3   (whole-number division)
    console.log(7 % 2);              // 1   (odd numbers leave 1)
    console.log(2 + 3 * 4);          // 14  (* before +)
    console.log((2 + 3) * 4);        // 20
    

    Math يحتوي على دوال مفيدة:

    console.log(Math.round(2.5));    // 3
    console.log(Math.max(4, 9, 2));  // 9
    console.log(Math.sqrt(49));      // 7
    
    • Math.random() يعطي رقماً عشوائياً من 0 حتى (وليس بما فيه) 1. Math.floor(Math.random() * 6) + 1 يمثل رمي نرد من 1 إلى 6.
    • تُخزن الأعداد العشرية بصيغة ثنائية، لذا فإن 0.1 + 0.2 يطبع 0.30000000000000004. قم بتقريب النتيجة قبل عرضها: (0.1 + 0.2).toFixed(2) يساوي "0.30".
    2.3

    الأنواع والتحويل

    كل قيمة لها نوع. typeof يخبرك بنوعها:

    console.log(typeof 42);         // number
    console.log(typeof "42");       // string
    console.log(typeof true);       // boolean
    console.log(typeof undefined);  // undefined
    
    • متغير تم إنشاؤه باستخدام let x; وبدون قيمة هو undefined.
    • null يعني "لا قيمة"، ويتم تعيينه عمداً.

    يستخدم + مع نص الدمج بدلاً من الجمع، لذا يجب تحويل النص إلى رقم أولاً:

    console.log("5" + 1);           // 51  (joined)
    console.log(Number("5") + 1);   // 6   (added)
    console.log(parseInt("12px"));  // 12  (reads the number at the start)
    console.log(String(9) + "!");   // 9!
    
    • النص الذي ليس رقماً يعطي NaN ("ليس رقماً"): Number("abc") هو NaN.
    • - و * و / تحولان النص إلى رقم تلقائياً ("6" * 2 هي 12)، لكن لا تعتمد على ذلك: قم بالتحويل عمداً.

    أخطاء شائعة

    • = تقوم بالتعيين؛ ولا تقارن. المقارنة تستخدم === (الموضوع 4).
    • "5" + 1 هي "51". قم بتحويل الإدخال باستخدام Number(...) قبل إجراء عمليات حسابية عليها.
    • Math.round(2.5) هي 3، لكن Math.round(-2.5) هي -2: فهي تقرب النصف للأعلى، نحو الرقم الأكبر.
  • 3 النصوص
    3.1

    الأحرف والطول

    النص هو نص داخل علامات اقتباس. مع الأحرف البسيطة، كل حرف له موقع واحد، وهو الفهرس؛ أول فهرس هو 0. يحسب JavaScript وحدات رمز UTF-16: قد يأخذ رمز تعبري موقعين.

    const word = "Script";
    console.log(word.length);     // 6
    console.log(word[0]);         // S
    console.log(word[2]);         // r
    console.log(word.at(-1));     // t  (counts back from the end)
    console.log(word[word.length - 1]);   // t
    
    • آخر فهرس هو length - 1. word[6] هو undefined، وليس خطأ.
    • النصوص غير قابلة للتعديل: لا يمكن لـ word[0] = "s" تغيير النص وتنتج استثناء Type Error في الوضع الصارم. قم بإنشاء نص جديد بدلاً من ذلك.

    قم بدمج النصوص باستخدام +، والذي يسمى الإلصاق:

    const first = "Ada";
    const last = "Lovelace";
    console.log(first + " " + last);   // Ada Lovelace
    
    3.2

    طرق String

    الدالة هي دالة تنتمي إلى قيمة. استدعها بنقطة. دالة النص تُعيد قيمة جديدة وتترك الأصلية كما هي.

    const city = "  Hong Kong ";
    console.log(city.trim());                 // Hong Kong
    console.log(city.trim().toUpperCase());   // HONG KONG
    console.log(city.length);                 // 12  (the spaces are still there)
    
    الدالة المعنى المثال النتيجة
    .toUpperCase() / .toLowerCase() تغيير الحالة "Hi".toLowerCase() "hi"
    .trim() إزالة المسافات من الطرفين " hi ".trim() "hi"
    .includes(t) هل يحتوي على t؟ "cat".includes("a") true
    .indexOf(t) أول ظهور لـ t، أو -1 "cat".indexOf("t") 2
    .slice(a, b) أحرف من a حتى (بدون تضمين) b "Script".slice(0, 3) "Scr"
    .split(sep) تحويل إلى مصفوفة "a,b,c".split(",") ["a","b","c"]
    .replace(a, b) استبدال أول a بـ b "cat".replace("c", "b") "bat"
    const email = "[email protected]";
    const at = email.indexOf("@");
    console.log(email.slice(0, at));          // mei
    console.log(email.slice(at + 1));         // school.org
    console.log(email.split("@"));            // ["mei","school.org"]
    
    3.3

    النصوص القالبية

    النص القالبي هو نص يُكتب بين علامات التنصيص الخلفية (في معظم لوحات المفاتيح، المفتاح الموجود يسار 1). ضع أي تعبير داخل ${ } وسيتم وضع قيمته في النص:

    const name = "Mei";
    const age = 17;
    console.log(`${name} is ${age} years old.`);   // Mei is 17 years old.
    console.log(`Next year: ${age + 1}`);          // Next year: 18
    
    • يمكن لعلامات التنصيص الخلفية أيضًا احتواء عدة أسطر من النص.
    • هذا أسهل في القراءة من العديد من +: قارن "Hi " + name + "!" مع `Hi ${name}!`.
    const price = 4.5;
    console.log(`Two cost $${(price * 2).toFixed(2)}`);   // Two cost $9.00
    

    أخطاء شائعة

    • يعمل ${ } فقط داخل علامات التنصيص الخلفية. في "Hi ${name}"، يتم طباعة النص تمامًا كما كُتب.
    • لا تغير الدوال النص: city.trim() في سطر مستقل لا يفعل شيئًا. احفظ النتيجة: const clean = city.trim();.
    • يتوقف slice(a, b) قبل b، تمامًا مثلما يكون آخر فهرس هو length - 1.
  • 4 القرارات
    4.1

    القيم المنطقية والمقارنات

    القيمة المنطقية هي إما true أو false. المقارنة تُعطي قيمة منطقية:

    العملية المعنى المثال النتيجة
    === مساوٍ (نفس القيمة ونفس النوع) 5 === 5 true
    !== غير مساوٍ 5 !== 3 true
    < > أصغر من، أكبر من 2 > 7 false
    <= >= على الأكثر، على الأقل 7 >= 7 true
    console.log(5 === 5);     // true
    console.log(5 === "5");   // false  (a number is not a string)
    console.log(5 == "5");    // true   (== converts first: avoid it)
    
    • استخدم دائمًا === و !==. المحرّك القديم == يقوم بتحويل الأنواع أولاً ويعطي نتائج مفاجئة.

    لشروط القيم المنطقية، استخدم العمليات المنطقية أدناه. مع القيم الأخرى، تُرجع && و || أحد مؤثراتها؛ ولا تُرجعان بالضرورة قيمة منطقية:

    • && (و): تكون صحيحة فقط إذا كان كلا الجانبين صحيحين.
    • || (أو): تكون صحيحة إذا كان على الأقل أحد الجانبين صحيحاً.
    • ! (ليس): يحول true إلى false والعكس.
    const age = 15;
    console.log(age >= 13 && age <= 19);   // true   (a teenager)
    console.log(age < 5 || age > 65);      // false
    console.log(!(age > 18));              // true
    
    4.2

    if / else if / else

    يعمل جملة if كتلة من الأوامر عندما يكون شرطها صحيحًا (يُعامل كموجب). مع الشروط المنطقية، يعني ذلك أن القيمة true. يختبر else if شرطًا آخر؛ ويلتقط else كل ما تبقى:

    const mark = 72;
    if (mark >= 80) {
      console.log("A");
    } else if (mark >= 60) {
      console.log("B");
    } else {
      console.log("C");
    }
    // prints B
    
    • يتحقق JavaScript من الشروط من الأعلى وينفذ فقط الفرع الأول الصحيح.
    • يُكتب الشرط بين قوسين دائرية؛ ويُكتب الكود المراد تنفيذه بين أقواس معقوفة { }.

    لذلك فإن الترتيب مهم. ضع الاختبار الأكثر صرامة أولاً:

    const temp = 35;
    if (temp > 30) {
      console.log("hot");
    } else if (temp > 20) {
      console.log("warm");   // skipped: the first branch already ran
    }
    // prints hot
    
    4.3

    مفتاح

    يُقارن switch قيمة واحدة بعدة حالات ثابتة. وهو أنظف من سلسلة طويلة من else if عندما يكون كل اختبار "هل يساوي...؟":

    const day = "Sat";
    switch (day) {
      case "Sat":
      case "Sun":
        console.log("weekend");
        break;
      case "Fri":
        console.log("nearly there");
        break;
      default:
        console.log("school day");
    }
    // prints weekend
    
    • يقارن switch مع ===، لذا لا يطابق case 1: السلسلة النصية "1".
    • ينهي break الـ switch. وبدونه يتسرب الكود إلى الحالة التالية.
    • يعمل default عندما لا تطابق أي حالة، كنهاية else.
    • حالتان بدون كود بينهما تشاركان نفس الكود، كما تفعل "Sat" و"Sun" هنا.

    أخطاء شائعة

    • يقوم if (x = 5) بالتعيين بدلاً من المقارنة، مما يجعل الاختبار صحيحاً دائماً. اكتب if (x === 5).
    • يُعد if (age > 13 && < 19) خطأ: أعد كتابة المتغير، age > 13 && age < 19.
    • غياب break في switch يؤدي إلى تنفيذ الحالة التالية أيضاً.
  • 5 الحلقات
    5.1

    حلقات for

    الأجزاء الثلاثة لحلقة for، وترتيب تنفيذها

    تعيد الحلقة تنفيذ كتلة من الأوامر. تُعد حلقة for الأفضل عندما تعرف عدد مرات التكرار. تحتوي أقواسها على ثلاثة أجزاء مفصولة بفاصلة منقوطة:

    for (let i = 1; i <= 3; i++) {
      console.log(i);
    }
    // 1
    // 2
    // 3
    
    1. البداية: يعمل let i = 1 مرة واحدة، قبل بدء الحلقة.
    2. الشرط: يُتحقق من i <= 3 قبل كل مرور؛ تتوقف الحلقة عندما يصبح غير صحيح.
    3. الخطوة: يعمل i++ (إضافة 1 إلى i) بعد كل مرور.

    يمثل كل مرور عبر الحلقة تكراراً واحداً. غيّر الخطوة للعد بطرق أخرى:

    let line = "";
    for (let i = 10; i > 0; i -= 3) {
      line += i + " ";
    }
    console.log(line);   // 10 7 4 1
    

    يجعل نمط المجمع متغيراً قبل الحلقة ويحدثه في كل مرور:

    let total = 0;
    for (let n = 1; n <= 5; n++) {
      total += n;          // the same as total = total + n
    }
    console.log(total);    // 15
    
    5.2

    حلقات while

    تعيد حلقة while التنفيذ طالما كان شرطها صحيحاً. استخدمها عندما لا تعرف مسبقاً عدد المرات التي تحتاجها:

    let money = 100;
    let years = 0;
    while (money < 200) {
      money = money * 1.1;   // 10% interest each year
      years++;
    }
    console.log(years);      // 8
    
    • يُتحقق من الشرط قبل كل مرور، لذا قد لا يعمل الجسم أحياناً.
    • إذا بقي الشرط صحيحاً ولم يتم الوصول إلى break أو أي مخرج آخر، فستحصل على حلقة لا نهائية. (اضغط إيقاف إذا حدث ذلك.)
    5.3

    for...of، break & continue

    for...of يزور كل عنصر في مصفوفة (أو كل حرف في نص) بالتتابع، دون الحاجة لإدارة مؤشر:

    const fruits = ["apple", "kiwi", "plum"];
    for (const fruit of fruits) {
      console.log(fruit.toUpperCase());
    }
    // APPLE
    // KIWI
    // PLUM
    

    break يخرج من الحلقة فوراً؛ بينما continue يتخطى باقي هذه الدورة وينتقل إلى الدورة التالية:

    const marks = [55, 80, -1, 90];
    let sum = 0;
    for (const m of marks) {
      if (m < 0) {
        break;            // -1 means "end of the data"
      }
      if (m < 60) {
        continue;         // skip a fail, keep looping
      }
      sum += m;
    }
    console.log(sum);     // 80
    

    أخطاء شائعة

    • خطأ بمقدار واحد: i < 3 يعمل لـ 0، 1، 2؛ بينما i <= 3 يعمل مرة إضافية. عدّ عدد الدورات.
    • بدء المجموع داخل الحلقة: يجب أن يأتي let total = 0; قبل الحلقة، وإلا سيتم إعادة تعيينه في كل دورة.
    • حلقة while ستعمل إلى ما لا نهاية إذا بقي شرطها صحيحاً ولم يتم الوصول إلى نقطة خروج.
  • 6 الدوال
    6.1

    المعاملات والقيمة المرجعة

    الدالة هي قطعة كود قابلة لإعادة الاستخدام. تعطي إعلان الدالة اسماً يمكنك استخدامه لاستدعائها:

    function greet(name) {
      return `Hello, ${name}!`;
    }
    
    console.log(greet("Mei"));   // Hello, Mei!
    console.log(greet("Tom"));   // Hello, Tom!
    
    • name هو معامِل: متغير يستقبل قيمة عند استدعاء الدالة.
    • "Mei" هو الحُجْلة: القيمة الفعلية الممررة.
    • return يرسل قيمة عائدة إلى الكائن الذي استدعاها وينهي الدالة فوراً.

    الدالة العادية التي تصل إلى نهايتها دون إرجاع قيمة تُرجع undefined. لذا أرجع الإجابة، واترك الكائن الذي استدعاك يقرر طباعتها:

    function area(width, height) {
      return width * height;
    }
    
    const a = area(4, 3);
    console.log(a + 1);          // 13  (a returned value can be used again)
    
    6.2

    دالات السهم

    الدالة السهمية طريقة مختصرة لكتابة دالة. احفظها في const:

    const square = (n) => n * n;
    const add = (a, b) => a + b;
    
    console.log(square(5));      // 25
    console.log(add(2, 3));      // 5
    
    • مع تعبير واحد بعد =>، تُرجع قيمته تلقائياً دون كتابة return.
    • مع أقواس مجعدة تحتاج إلى return مجدداً:
    const grade = (mark) => {
      if (mark >= 50) {
        return "pass";
      }
      return "fail";
    };
    console.log(grade(64));      // pass
    

    غالباً ما تُمرر الدوال السهمية لدوال أخرى، كما سترى ذلك مع map وfilter في الموضوع 7.

    6.3

    نطاق المتغير

    نطاق المتغير هو جزء الكود الذي يمكنه رؤيته. المتغير المصنوع بـ let أو const داخل { } يكون متاحاً في ذلك الكتلة ونطاقاتها المتداخلة. يمكن للدالة المتداخلة الحفاظ على الوصول إليها حتى بعد عودة الدالة الخارجية:

    const level = "global";
    
    function show() {
      const inside = "local";
      console.log(level);        // global  (outer variables are visible)
      console.log(inside);       // local
    }
    
    show();
    console.log(typeof inside);  // undefined  (inside does not exist out here)
    
    • المتغير المصنوع داخل دالة هو متغير محلي؛ كل استدعاء يحصل على نسخة جديدة منه.
    • مرر القيم داخلًا كمعاملات واحصل على النتائج خارجًا عبر return، بدلاً من تغيير متغيرات خارجية من داخل الدالة.

    أخطاء شائعة

    • نسيان return: تعمل الدالة لحساب الإجابة، ثم تُرجع undefined.
    • الاستدعاء بدون أقواس: greet هو الدالة نفسها؛ greet("Mei") يقوم بتنفيذها.
    • الطباعة داخل الدالة و طباعة نتيجتها يطبع مرتين، أو يطبع undefined.
  • 7 المصفوفات
    7.1

    إنشاء وتعديل المصفوفات

    An array 数组 holds a list of values in order, inside square brackets. Each item is an element 元素, and the first index is 0:

    const scores = [72, 88, 95];
    console.log(scores[0]);        // 72
    console.log(scores.length);    // 3
    scores[1] = 90;                // change one element
    console.log(scores);           // [72,90,95]
    
    • const stops you giving scores a whole new array, but you can still change what is inside it.
    • Reading past the end gives undefined: scores[3] is undefined.

    Add and remove at the end with push and pop:

    const queue = ["Ann", "Ben"];
    queue.push("Cai");             // add to the end
    console.log(queue);            // ["Ann","Ben","Cai"]
    const last = queue.pop();      // remove from the end and return it
    console.log(last);             // Cai
    console.log(queue.length);     // 2
    

    An array can hold arrays. That makes a grid, read with two indexes, row first:

    const grid = [
      [1, 2, 3],
      [4, 5, 6],
    ];
    console.log(grid[1][2]);       // 6  (row 1, column 2)
    
    7.2

    map, filter & reduce

    English

    These methods take a function and apply it to the array elements. They return a new array (or value) without themselves replacing the original items. The function you pass in can still change the original array or its objects:

    • map makes a new array by changing every element.
    • filter keeps only the elements for which the function returns true.
    • reduce combines all the elements into one value, such as a total.
    const prices = [4, 10, 25];
    const withTax = prices.map((p) => p * 1.1);
    console.log(withTax.map((p) => p.toFixed(2)));   // ["4.40","11.00","27.50"]
    
    const cheap = prices.filter((p) => p < 20);
    console.log(cheap);                              // [4,10]
    
    const total = prices.reduce((sum, p) => sum + p, 0);
    console.log(total);                              // 39
    

    In reduce, sum is the accumulator. It starts at the last argument (0) and takes the function's result after each element.

    7.3

    البحث والفرز

    English
    sort() with no compare function sorts numbers as text
    Method Gives back Example with [5, 8, 2] Result
    .includes(x) true or false .includes(8) true
    .indexOf(x) the first index of x, or -1 .indexOf(2) 2
    .find(f) the first element where f is true .find((n) => n > 6) 8
    .findIndex(f) its index, or -1 .findIndex((n) => n > 6) 1

    sort puts the elements in order. With no function, it sorts them as text, so numbers come out in the wrong order:

    const nums = [10, 9, 100, 1];
    console.log([...nums].sort());                   // [1,10,100,9]   (as text!)
    console.log([...nums].sort((a, b) => a - b));    // [1,9,10,100]
    console.log([...nums].sort((a, b) => b - a));    // [100,10,9,1]
    
    • The compare function returns a negative number when a should come first, and a positive number when b should.
    • sort changes the array itself. [...nums] makes a copy first, so nums keeps its order.

    Common mistakes

    • The last element is arr[arr.length - 1], not arr[arr.length].
    • map and filter do not change the array: store their result.
    • nums.sort() on numbers sorts them as text. Pass (a, b) => a - b.
  • 8 الكائنات
    8.1

    الكائنات والخصائص

    يجمع الكائن القيم ذات الصلة تحت أسماء. كل زوج من الاسم والقيمة يُعدّ خاصية. يُسمّى الاسم المفتاح:

    const pupil = {
      name: "Mei",
      age: 17,
      form: "11A",
    };
    console.log(pupil.name);       // Mei
    console.log(pupil["form"]);    // 11A  (bracket form, with the key as a string)
    
    • اقرأ الخاصية بنقطة (pupil.age) أو بأقواس (pupil["age"]). استخدم الأقواس إذا كان المفتاح موجوداً في متغير: pupil[field].
    • المفتاح غير الموجود يُعيد undefined.

    غيّر خاصية، أو أضف واحدة جديدة، عن طريق إسناد قيمة إليها:

    const pupil = { name: "Mei", age: 17 };
    pupil.age = 18;                // change
    pupil.house = "Red";           // add
    console.log(pupil);            // {"name":"Mei","age":18,"house":"Red"}
    
    8.2

    مصفوفات الكائنات

    قائمة السجلات هي مصفوفة كائنات. ادمجها مع طرق المصفوفة من الموضوع 7:

    const pupils = [
      { name: "Mei", mark: 88 },
      { name: "Tom", mark: 64 },
      { name: "Sara", mark: 95 },
    ];
    
    const passed = pupils.filter((p) => p.mark >= 70);
    console.log(passed.map((p) => p.name));            // ["Mei","Sara"]
    
    const best = [...pupils].sort((a, b) => b.mark - a.mark)[0];
    console.log(`${best.name} has the top mark`);       // Sara has the top mark
    

    لحساب مجموع خاصية، استخدم reduce أو حلقة تكرار:

    const pupils = [{ mark: 88 }, { mark: 64 }, { mark: 95 }];
    let sum = 0;
    for (const p of pupils) {
      sum += p.mark;
    }
    console.log((sum / pupils.length).toFixed(1));      // 82.3
    
    8.3

    التكرار فوق كائن

    يُعطيك Object.keys مصفوفة بالمفاتيح، ويُعطيك Object.entries أزواج [key, value]، لتتمكن من التكرار عليها:

    const stock = { pens: 12, rulers: 0, books: 5 };
    
    console.log(Object.keys(stock));             // ["pens","rulers","books"]
    
    for (const [item, count] of Object.entries(stock)) {
      if (count === 0) {
        console.log(`${item}: sold out`);
      }
    }
    // rulers: sold out
    

    الكائن مناسب كمعداد: استخدم كل عنصر تحسبه كمفتاح.

    const words = ["red", "blue", "red", "red"];
    const counts = {};
    for (const w of words) {
      counts[w] = (counts[w] || 0) + 1;   // 0 the first time the key is seen
    }
    console.log(counts);                  // {"red":3,"blue":1}
    

    أخطاء شائعة

    • يبحث pupil.field عن مفتاح باسم field. عندما يكون المفتاح في متغير، اكتب pupil[field].
    • الفاصلة تكون بين الخصائص، وليس الفاصلة المنقوطة: { name: "Mei", age: 17 }.
    • لا يمكن for...of التكرار على كائن مباشرة. كرر على Object.keys(...) أو Object.entries(...).
  • 9 الأخطاء
    9.1

    قراءة رسائل الخطأ

    عندما لا يستطيع JavaScript الاستمرار، يتوقف ويعرض خطأ. الكلمة الأولى تسمى نوع الخطأ؛ والباقي يوضح ما حدث وأين. اقرأها ثم انظر إلى السطر الذي تشير إليه.

    SyntaxError: missing ) after argument list
    ReferenceError: totl is not defined
    TypeError: Cannot read properties of undefined (reading 'length')
    
    الخطأ معناه سبب شائع
    SyntaxError الكود غير مكتوب بشكل صحيح، لذلك لا شيء يعمل قوس أو علامة تنصيص مفقودة
    ReferenceError اسم غير موجود خطأ إملائي: totl بدلاً من total
    TypeError القيمة من نوع خاطئ لما قمت به استخدام .length على undefined

    قد يختلف النص الدقيق بين المتصفحات، لكن اسم الخطأ هو نفسه. يلتقط هذا البرنامج كل خطأ ليتمكن من طباعة اسمه:

    try {
      const total = 5;
      console.log(totl);
    } catch (e) {
      console.log(e.name);           // ReferenceError
    }
    
    try {
      const pupil = undefined;
      console.log(pupil.length);
    } catch (e) {
      console.log(e.name);           // TypeError
    }
    

    بعض الأخطاء لا تعطي أي رسالة خطأ على الإطلاق، بل تعطي إجابة خاطئة فقط: خطأ منطقي. لإيجاد واحد، اطبع القيم على طول المسار باستخدام console.log، وتحقق منها يدويًا.

    9.2

    try, catch & throw

    يوضع الكود الذي قد يفشل داخل كتلة try. إذا حدث خطأ هناك، يقفز JavaScript إلى catch بدلاً من التوقف، ويحتوي e على الخطأ:

    try {
      JSON.parse("{not valid}");
      console.log("parsed");         // skipped
    } catch (e) {
      console.log("Could not read the data");
    }
    console.log("The program carries on");
    

    يمكن لكودك الخاص رفع خطأ باستخدام throw. يسمح هذا للدالة برفض المدخلات السيئة بوضوح، بدلاً من إرجاع إجابة خاطئة:

    function average(list) {
      if (list.length === 0) {
        throw new Error("the list is empty");
      }
      return list.reduce((s, x) => s + x, 0) / list.length;
    }
    
    console.log(average([4, 6]));    // 5
    try {
      average([]);
    } catch (e) {
      console.log(`Error: ${e.message}`);   // Error: the list is empty
    }
    
    • new Error("…") يصنع خطأ يكون message فيه نصك.
    • استخدم try فقط حول الكود الذي قد يفشل حقًا، مثل قراءة البيانات. لا تستخدمه لإخفاء الأخطاء في كودك الخاص.

    أخطاء شائعة

    • تجاهل الرسالة. أول سطر فيها يحدد نوع الخطأ وما حدث؛ ابدأ من هناك.
    • كتلة catch لا تفعل شيئًا (catch (e) {}) تخفي المشكلة: على الأقل اطبع e.message.
    • throw "text" يعمل، لكن throw new Error("text") يسجل أيضًا أين حدث الخطأ.

تسجيل الدخول أو إنشاء حساب

IGCSE, A-Level & AP