9. الأخطاء والاستثناءات

لا تمتلك JavaScript نظامًا متطورًا للغاية لمعالجة الاستثناءات. ومع ذلك، فهي توفر عبارة [throw]، التي تسمح لك بالإشارة إلى وجود خطأ، بالإضافة إلى بنية try/catch/finally، التي تسمح لك بالتقاط تلك الأخطاء.

9.1. نص برمجي [excep-01]

في البرنامج النصي التالي، سنعرض التاريخ الحالي بالتنسيق [ساعات:دقائق:ثوانٍ:مللي ثانية]. للقيام بذلك، سنستخدم مكتبة JavaScript تسمى [moment.js]. نقوم بتثبيتها، كالمعتاد، باستخدام أداة [npm]:

فيما يلي كود البرنامج النصي:


'use strict';
 
// package moment
import moment from 'moment';
 
...

لفهم كيفية كتابة سطر [import] في السطر 4، يمكننا النظر إلى تعريف الوحدة النمطية [moment]:

في [1-2]، ننتقل إلى تعريف الوحدة النمطية؛
في [3]، لدينا ملف TypeScript، وليس ملف JavaScript. في وقت التشغيل، يتم ترجمة ملف TypeScript هذا إلى ملف JavaScript قبل استخدامه؛
في [4]، نبحث عن عبارات [export] (Ctrl-F)؛
في [5]، يقوم البيان بتصدير الكائن [moment]. يمكن استيراد هذا في ES6 على النحو التالي:


import moment from 'moment';

يمكنك استخدام أي اسم لاستيراد كائن [moment]، على سبيل المثال:


import m from 'moment';

لنعد إلى كود البرنامج النصي:


'use strict';
 
// package moment
import moment from 'moment';
 
// try / catch / finally principle
for (let i = 0; i < 10; i++) {
  // date - current time
  const now = Date.now();
  // format time to get milliseconds
  const time = moment(now).format("HH:mm:ss:SSS");
  // milliseconds
  const milli = Number(time.substr(time.length - 3));
  // display
  console.log("--------------------itération n° ", i, "à", time);
  try {
    // number varies according to time of day
    const nbre = milli % 2;
    if (nbre === 0) {
      // launch an error msg
      throw "erreur";
    }
    // if we've arrived here, there's been no mistake
    console.log("pas d'erreur");
  } catch (error) {
    // if we get here, it's because there's been a mistake
    console.log("erreur1=", error);
  } finally {
    // executed in all cases error or not
    console.log("finally")
  }
}

تعليقات

السطر 4: استيراد مكتبة [moment]؛
يتم تكرار البرنامج النصي 10 مرات (السطر 7). في كل تكرار للدورة، يتم استرداد الوقت الحالي بالتنسيق [ساعات:دقائق:ثوانٍ:مللي ثانية] (الأسطر 8–13)؛
إذا كان عدد الميلي ثانية زوجيًا، يتم عرض رسالة خطأ (الأسطر 19–22)؛
الهدف هنا هو فهم كيفية عمل try / catch / finally

التنفيذ


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-01.js"
--------------------itération n° 0 à 17:57:04:440
erreur1= erreur
finally
--------------------itération n° 1 à 17:57:04:447
pas d'erreur
finally
--------------------itération n° 2 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 3 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 4 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 5 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 6 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 7 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 8 à 17:57:04:449
pas d'erreur
finally
--------------------itération n° 9 à 17:57:04:449
pas d'erreur
finally

يمكننا أن نرى أن جملة [finally] يتم تنفيذها دائمًا، سواء كان هناك خطأ أم لا.

9.2. نص برمجي [excep-02]

يوضح هذا البرنامج النصي أن عبارة [throw] يمكنها إلقاء أي نوع من البيانات وأن هذه البيانات يتم التقاطها بالكامل بواسطة جملة [catch].


'use strict';
 
// you can "throw" just about anything to signal an error
let i = 0;
console.log("--------------------essai n° ", i);
// launch a string
try {
  throw "msg d'erreur";
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// launch a table
i++;
console.log("--------------------essai n° ", i);
try {
  throw [1, 2, 3]
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// launch a literal object
i++;
console.log("--------------------essai n° ", i);
try {
  throw { nom: "hercule", pays: "grèce antique" }
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lancer un type Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lancer un type Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // there has been an error - the message is in [error.message]
  console.log("erreur.message=[", error.message, "], type(error)=", typeof (error));
}

تعليقات

السطران 35 و 44: [Error] هي فئة JavaScript يقبل منشئها رسالة خطأ كمعلمة أولى اختيارية. يمكن استرداد هذه الرسالة من الخاصية [Error.message] (السطر 47)؛
هناك فئات أخرى إلى جانب [Error] يمكنها الإشارة إلى وجود خطأ: [EvalError، InternalError، RangeError، ReferenceError، SyntaxError، TypeError، URIError)؛

التنفيذ


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-02.js"
--------------------essai n° 0
erreur=[ msg d'erreur ], type= string
--------------------essai n° 1
erreur=[ [ 1, 2, 3 ] ], type= object
--------------------essai n° 2
erreur=[ { nom: 'hercule', pays: 'grèce antique' } ], type= object
--------------------essai n° 3
erreur=[ Error: erreur de connexion au réseau
at Object.<anonymous> (c:\Data\st-2019\dev\es6\javascript\exceptions\excep-02.js:35:9)
at Object.<anonymous> (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:251206)
at c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:245054
at Generator.next (<anonymous>)
at bl (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:245412)
at kl (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:247659)
at Object.u (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:287740)
at Object.o (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:287137)
at Object.<anonymous> (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:284879)
at Object.apply (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:199341) ], type= object
--------------------essai n° 4
erreur.message=[ erreur de connexion au réseau ], type(error)= object

9.3. نص برمجي [excep-03]

يوضح هذا البرنامج النصي أنه، داخل [catch]، يمكنك التمييز بين نوع مثيل [Error] الذي تم اعتراضه بواسطة [catch]:


'use strict';
 
// package moment
import moment from 'moment';
 
// differentiate the Error instance received in a [catch]
for (let i = 0; i < 10; i++) {
  // date - current time
  const now = Date.now();
  // format time to get milliseconds
  const time = moment(now).format("HH:mm:ss:SSS");
  // milliseconds
  const milli = Number(time.substr(time.length - 3));
  console.log("--------------------itération n° ", i);
  try {
    // nbre [0, 1, 2]
    const nbre = milli % 3;
    switch (nbre) {
      case 0:
        throw new ReferenceError("erreur 1");
      case 1:
        throw new RangeError("erreur 2");
      default:
        throw new EvalError("erreur 3");
    }
  } catch (error) {
    // there has been a mistake
    if (error instanceof ReferenceError) {
      console.log("ReferenceError :", error.message);
    } else {
      if (error instanceof RangeError) {
        console.log("RangeError :", error.message);
      }
      else {
        if (error instanceof EvalError) {
          console.log("EvalError :", error.message);
        }
      }
    }
  }
}

التنفيذ


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-03.js"
--------------------itération n° 0
ReferenceError : erreur 1
--------------------itération n° 1
RangeError : erreur 2
--------------------itération n° 2
RangeError : erreur 2
--------------------itération n° 3
RangeError : erreur 2
--------------------itération n° 4
RangeError : erreur 2
--------------------itération n° 5
RangeError : erreur 2
--------------------itération n° 6
EvalError : erreur 3
--------------------itération n° 7
EvalError : erreur 3
--------------------itération n° 8
EvalError : erreur 3
--------------------itération n° 9
EvalError : erreur 3