كتابة اختبارات القبول لكود Ember في Discourse

الاختبارات الآلية طريقة رائعة لحماية الكود الخاص بك من الانحدارات (Regressions) المستقبلية. الكثير من الأشخاص على دراية بكيفية القيام بذلك في قاعدة أكوادنا المكتوبة بلغة Rails باستخدام rspec، ولكن الجانب الخاص بـ JavaScript قد يكون غامضًا بعض الشيء للبعض.

لحسن الحظ، أصبح الأمر سهلاً جدًا هذه الأيام لإضافة اختبارات أساسية إلى كود Ember الخاص بك!

للاختبارات الخاصة بالمكونات (Component tests)، راجع اختبارات المكونات.

اختبارات القبول (Acceptance Tests)

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

إليك كيف يمكننا كتابة اختبار قبول يزور مسار /admin/snack الخاص بنا ويتأكد من أنه تم عرض الوجبة الخفيفة (snack):

test/javascripts/acceptance/snack-test.js

import { acceptance } from "helpers/qunit-helpers";
acceptance("Snack");

test("Visit Page", function (assert) {
  visit("/admin/snack");
  andThen(() => {
    assert.ok(exists(".fancy-snack-title"), "the snack title is present");
  });
});

دالة test() في هذه الحالة تكاد تكون مكتوبة بلغة إنجليزية مفهومة! الأمر الأول يقول: قم بزيارة الرابط /admin/snack. بعد ذلك، هناك دالة andThen(). هذه الدالة ضرورية للتأكد من اكتمال جميع العمليات الخلفية قبل استمرار الاختبارات. بما أن كود JavaScript وEmber غير متزامن (asynchronous)، نحتاج إلى التأكد من أن Ember قد أنجز كل ما يلزمه قبل تنفيذ تأكيداتنا. أخيرًا، تختبر ما إذا كان العنصر .fancy-snack-title موجودًا.

ومع ذلك، إذا قمت بتشغيل هذا الاختبار عن طريق زيارة /qunit?module=Acceptance%3A%20Snack، ستجد أن الاختبار سيفشل بسبب خطأ AJAX.

إذا تذكرت، يتضمن كودنا جزءًا في Rails وجزءًا في JavaScript، حيث يقوم الأخير بتنفيذ طلب AJAX للحصول على بياناته. اختبار القبول شغّل الجانب الخاص بـ JavaScript، لكنه لم يكن يعرف ماذا يفعل للحصول على بياناته من Rails.

لإصلاح هذا، نحتاج إلى إضافة استجابة وهمية باستخدام مكتبة pretender الرائعة. افتح الملف test/javascripts/helpers/create-pretender.js وابحث عن السطر الذي يقول:

this.get("/admin/plugins", () => response({ plugins: [] }));

مباشرة تحته، أضف سطرًا لإرجاع كائن وجبة خفيفة وهمي ليتعامل معه اختبار القبول:

this.get("/admin/snack.json", () => {
  return response({ name: "snack name", description: "snack description" });
});

يمكنك قراءة الكود أعلاه على النحو التالي: “لأي طلب إلى /admin/snack.json، استجب باستخدام دالة response التالية.”

إذا قمت بتحديث الرابط /qunit?module=Acceptance%3A%20Snack، ينبغي أن يسترجع اختبار القبول بياناته عبر مكتبة pretender وينجح الاختبار.

الخطوة التالية

ربما ترغب في تجربة بناء ميزة صغيرة وإضافة اختبارات للتأكد من أنها تعمل. يمكنك حتى محاولة استخدام التطوير الموجه بالاختبار (TDD) من خلال إنشاء اختباراتك قبل كتابة أي كود على الواجهة الأمامية (Front end). اعتمادًا على ما تعمل عليه وتفضيلاتك الشخصية، قد تجد أن هذه طريقة أكثر متعة للتعامل مع الأمر. حظًا موفقًا واستمتع بالبرمجة :slight_smile:


هذا المستند مسيطر على إصداراته - اقترح التغييرات على github.

15 إعجابًا

My prior experience in writing qunit tests was based on the other howto

i.e. “acceptance” was simply

acceptance("Purple Tentacle", { loggedIn: true });

I have seen in other plugins where the test code contained “fake” JSON to test against. I wasn’t sure if that would be as good as testing against “real” data, so I wanted to avoid doing it that way.

The six tests passed, but I got a couple of rather angry looking “unhandled request” errors.

After finding an example of some “setup” code, I tried it and it solved the errors.

It works, but I’m not really sure why, nor why it’s needed for some but not for the majority of plugins I’ve seen that have qunit tests.

3 إعجابات

For a long time we weren’t great with testing plugins, so not many people followed our example and added tests.

You are right to add a response using pretender to handle AJAX calls.

4 إعجابات

ملاحظة فقط بأن المسار /qunit لم يعد مستخدماً. إنه /tests الآن. استغرق الأمر مني بعض الوقت لفهم ذلك :slight_smile:

إعجاب واحد (1)