البرنامج التعليمي لإطار عمل الياسمين: اختبار الوحدة مع مثال

ما هو ياسمين جي إس؟

الياسمين هو مصدر مفتوح والأكثر شعبية Javaإطار عمل اختبار مكتبة البرامج النصية لاختبار أي نوع من Javaتطبيق النص. تتبع ياسمين إجراءات التطوير الموجه بالسلوك (BDD) لضمان أن كل سطر من Javaتم اختبار بيان البرنامج النصي بشكل صحيح.

ما هو إطار الياسمين المستخدم؟

يُعدّ الاختبار عنصرًا أساسيًا لأي تطبيق. بالنسبة لاختبار الوحدات في Node.js، يُطلق على إطار العمل المتاح للاختبار اسم Jasmine. في أوائل عام 2000، كان هناك إطار عمل للاختبار Javaسيناريو تطبيقات تسمى JsUnit. Later تم ترقية هذا الإطار وهو يُعرف الآن باسم Jasmine.

الياسمين يساعد في الآلي وحدة التجاربوهو أمر أصبح ممارسة أساسية عند تطويرping ونشر تطبيقات الويب الحديثة.

في هذا البرنامج التعليمي لـ Jasmine، ستتعلم كيفية إعداد بيئتك باستخدام Jasmine وكيفية تشغيل اختبارات Jasmine لأول تطبيق Node.js.

ياسمين لاختبار تطبيقات Node.js

ياسمين هو التنمية المدفوعة بالسلوك (BDD) إطار الاختبار ل Javaالنص. إنه يفعل لست الاعتماد على المتصفحات، DOM، أو أي Javaإطار عمل برمجي. لذا، فهو مناسب للمواقع الإلكترونية. Node.js المشاريع، أو أي مكان آخر Javaيمكن تشغيل البرنامج النصي. لبدء استخدام Jasmine، تحتاج أولاً إلى تنزيل وتثبيت وحدات Jasmine اللازمة.

كيفية إعداد بيئة اختبار الياسمين

في الخطوة التالية من هذا الدرس التعليمي حول Jasmine Node.js، ستحتاج إلى تهيئة بيئتك وفحص ملف إعدادات Jasmine. توضح الخطوات التالية كيفية إعداد Jasmine في بيئتك.

الخطوة 1) تثبيت وحدات NPM
تحتاج إلى قم بتثبيت NPM وحدة jasmine لاستخدام إطار عمل Jasmine من داخل تطبيق Node. لتثبيت وحدة jasmine-node، نفّذ الأمر التالي.

npm install jasmine-node

ملاحظة الإصدار (2026): لا يزال الأمر التاريخي المذكور أعلاه يعمل، ولكن ياسمين-نود الوحدة في وضع الصيانة وتتضمن Jasmine 1.3، لذا احتفظ بها فقط للمشاريع القديمة. أما مشروع Node.js الجديد فيقوم بتثبيت الإصدار المُصان. واجهة سطر الأوامر جاسمين كاعتمادية تطويرية، ويتم استدعاؤها من خلال npx:

npm install --save-dev jasmine
npx jasmine init

ياسمين 6.x وهو الخط الرئيسي الحالي ويدعم Node.js 20 و 22 و 24، و Node.js 24 هو إصدار الدعم طويل الأمد النشط في عام 2026.

الخطوة 2) تهيئة بيئة الياسمين
تهيئة المشروع – عند القيام بذلك، يقوم Jasmine بإنشاء مجلد spec وملف json للتكوين. يُستخدم مجلد spec لتخزين جميع ملفات الاختبار الخاصة بك. وبذلك، سيعرف Jasmine مكان جميع اختباراتك، ومن ثم يمكنه تنفيذها وفقًا لذلك. JSON يُستخدم هذا الملف لتخزين معلومات التكوين الخاصة بـ Jasmine.

لتهيئة بيئة Jasmine، قم بتشغيل الأمر التالي

jasmine init

الخطوة 3) فحص ملف التكوين الخاص بك.
سيتم تخزين ملف التكوين في مجلد المواصفات/الدعم باسم jasmine.json. يقوم هذا الملف بتعداد الملفات المصدر وملفات المواصفات التي ترغب في تضمينها في برنامج Jasmine.

تُظهر لقطة الشاشة أدناه مثالاً نموذجياً لملف jasmine.json الخاص بـ Jasmine.

1. لاحظ أن دليل المواصفات محدد هنا. كما ذكرنا سابقًا، عند تشغيل jasmine، فإنه يبحث عن جميع الاختبارات في هذا الدليل.
2. الشيء التالي الذي يجب ملاحظته هو المعلمة spec_files - يشير هذا إلى أنه مهما كانت ملفات الاختبار التي يتم إنشاؤها، فيجب إلحاقها بالكلمة الأساسية "المواصفات".

ملاحظة حول التكوين: في Jasmine 6.x، يقبل الملف نفسه أيضًا المساعدين، والتي يتم تحميلها مرة واحدة قبل كل مواصفة، و الحياة الفطرية كتلة تحتوي على خيارات مثل العشوائية وإيقاف SpecOnExpectationFailure. نمط spec_files الافتراضي هو **/*[sS]pec.?(m)jsويمكن تمرير ملف مختلف باستخدام –config أو ال مسار إعدادات الياسمين المتغير.

بعد ذلك، في هذا البرنامج التعليمي لإطار عمل Jasmine، سنتعلم كيفية استخدام Jasmine لاختبار تطبيقات Node.js.

كيفية استخدام Jasmine لاختبار تطبيقات Node.js

من أجل استخدام اختبار وحدة Jasmine لتطبيقات Node.js، يجب اتباع سلسلة من الخطوات.

في المثال التالي، سنُعرّف وحدةً برمجيةً تجمع عددين، وسنختبرها. ثم سنُعرّف ملفًا برمجيًا منفصلًا يحتوي على كود الاختبار، ونستخدم مكتبة Jasmine لاختبار دالة الجمع.

الخطوة 1) قم بتحديد الكود الذي نحتاج إلى اختباره. سنقوم بتعريف دالة ستقوم بإضافة رقمين وإرجاع النتيجة. سيتم كتابة هذا الكود في ملف يسمى "Add.js".

تُظهر لقطة الشاشة أدناه وحدة Add.js النهائية، ويتم تكرار نفس الكود كنص أسفلها.

var exports=module.exports={};
exports.AddNumber=function(a,b)
{
return a+b;
};

Code تفسير

1. يتم استخدام الكلمة الأساسية "exports" للتأكد من إمكانية الوصول فعليًا إلى الوظيفة المحددة في هذا الملف بواسطة ملفات أخرى.
2. نقوم بعد ذلك بتعريف دالة تسمى "AddNumber". تم تعريف هذه الوظيفة لتأخذ معلمتين، a وb. تتم إضافة الوظيفة إلى الوحدة "الصادرات" لجعل الوظيفة كوظيفة عامة يمكن الوصول إليها بواسطة وحدات التطبيق الأخرى.
3. نحن أخيرًا نجعل وظيفتنا تُرجع القيمة المضافة للمعلمات.

الخطوة 2) بعد ذلك، نحتاج إلى تعريف كود اختبار Jasmine الخاص بنا، والذي سيُستخدم لاختبار دالة "Add" في ملف Add.js. يجب وضع الكود أدناه في ملف يُسمى add-spec.js.

ملاحظاتيجب إضافة كلمة "spec" إلى ملف الاختبار حتى يتمكن برنامج Jasmine من اكتشافها.

تُظهر لقطة الشاشة أدناه نفس ملف المواصفات مفتوحًا في محرر نصوص.

var app=require("../Add.js");
describe("Addition",function(){
it("The function should add 2 numbers",function() {
var value=app.AddNumber(5,6);
expect(value).toBe(11);
});
});

Code تفسير

1. نحتاج أولاً إلى تضمين ملف Add.js الخاص بنا حتى نتمكن من اختبار وظيفة "AddNumber" في هذا الملف.
2. نقوم الآن بإنشاء وحدة الاختبار الخاصة بنا. الجزء الأول من وحدة الاختبار هو وصف الطريقة التي تعطي اسمًا للاختبار الخاص بنا. في هذه الحالة، اسم اختبارنا هو "الإضافة".
3. الجزء التالي هو تقديم وصف لاختبارنا باستخدام الطريقة "it".
4. نستدعي الآن دالة AddNumber ونرسل إليها المعاملين 5 و6. سيتم تمرير هذه القيم إلى دالة AddNumber في ملف Add.js. ثم تُخزَّن القيمة المُعادة في متغير يُسمى value.
5. الخطوة الأخيرة هي إجراء المقارنة أو الاختبار الفعلي. بما أننا نتوقع أن تكون القيمة المُعادة من دالة AddNumber هي 11، فإننا نُحدد ذلك باستخدام الدالة expect(value).toBe(القيمة المتوقعة).

الناتج

1. من أجل إجراء الاختبار، يحتاج المرء إلى تشغيل الأمر ياسمين.
2. تُظهر لقطة الشاشة أدناه أنه بعد تشغيل أمر Jasmine، سيكتشف وجود اختبار باسم add-spec.js ويُنفّذه وفقًا لذلك. وفي حال وجود أي أخطاء في الاختبار، سيتم عرضها.

يستخدم مثال الإضافة مُطابقًا واحدًا، ومع ذلك، توفر مكتبة Jasmine مجموعة كاملة من المُطابقات. يسرد الجدول أدناه المُطابقات التي تُغطي تقريبًا كل تأكيد ستكتبه.

أكثر أنواع الياسمين التي ستستخدمها

المطابق هو المقارنة التي تلي expect(). استخدم .not قبل أي مطابق لعكسه، كما في expect(value).not.toBe(11).

هناك عادتان تحافظان على وضوح الأخطاء. استخدم toBe فقط مع القيم الأولية والمراجع المتطابقة، لأن كائنين لهما نفس المحتوى لا يمكن مساواتهما أبدًا. استخدم toEqual مع البنى، وأضف toHaveBeenCalledWith عندما تكون الوسائط بنفس أهمية الاستدعاء نفسه.

الإعداد والتفكيك والجواسيس في ياسمين

تحتاج الأجنحة الحقيقية إلى حالة مشتركة ونسخ احتياطية للمتعاونين البطيئين. يوفر Jasmine كليهما دون أي حزمة إضافية.

• قبل كل شيء وبعد كل شيء يتم تشغيلها قبل وبعد كل مواصفات داخل كتلة الوصف، وهو المكان الطبيعي لإعادة بناء التركيبات.
• قبل كل شيء وبعد كل شيء قم بتشغيلها مرة واحدة للكتلة بأكملها، لذا احتفظ بها للأعمال المكلفة مثل فتح اتصال.
• spyOn(object, 'method') يستبدل طريقة حقيقية بـ tracking double; أضف .and.returnValue() للتحكم في الإجابة.
• jasmine.createSpy('name') يقوم بإنشاء نسخة مزدوجة مستقلة لدالة رد نداء ليس لها كائن لربطها به.
• المواصفات غير المتزامنة قد يتم تعريفها على أنها غير متزامنة ويتم انتظارها، وقد تعيد وعدًا، أو قد تقبل رد نداء تم الانتهاء منه والذي يجب استدعاؤه مرة واحدة بالضبط.

تُعاد تهيئة أدوات التجسس بين الاختبارات، لذا لا تُسرّب مجموعة الاختبارات أي دالة وهمية إلى الاختبار التالي. هذا العزل هو ما يجعل الاختبار الفاشل يُشير إلى عيب واحد بدلاً من سلسلة من العيوب، وهو نفس المبدأ الموصوف في... وحدة التجارب الأساسيات.

ياسمين ضد موكا ضد جيست

يُعدّ نظام Jasmine أحد ثلاثة أنظمة سائدة Javaاختبار البرامج النصية، وعادةً ما يعتمد الاختيار على مقدار الأسلاك التي ترغب في امتلاكها.

اختيار موكا عندما ترغب في تجميع مجموعة التأكيدات والمحاكاة الخاصة بك، و دعابة عندما تكون عمليات التشغيل المتوازية والتغطية واللقطات أكثر أهمية من التحكم في التكوين، يظل برنامج Jasmine الخيار الأخف وزنًا والأكثر اكتمالًا، ولهذا السبب يبقى شائعًا في اختبار الأتمتة الأجنحة.

الأسئلة الشائعة