كيفية تشغيل مجموعات اختبارات QUnit الأساسية والإضافات والسمة لـ Discourse

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

تشغيل الاختبارات في المتصفح

النواة / الإضافات: انتقل إلى المسار /tests في بيئة التطوير الخاصة بك

القوالب: انتقل إلى المسار /theme-qunit في بيئة التطوير (أو الإنتاج) الخاصة بك، ثم اختر القالب

بشكل عام، عند العمل على اختبارات النواة، يجب أن تختار “core” من القائمة المنسدلة “Target”، وعندما تعمل على إضافات، يجب أن تختار الإضافة المحددة.

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

تشغيل الاختبارات عبر واجهة سطر الأوامر

النواة

من الدليل الجذري لـ Discourse، استخدم bin/qunit (تأكد من تشغيل pnpm install منذ آخر مرة استوردت فيها التغييرات من المصدر الرئيسي). إنها تغلف أداة Ember Exam للعمليات العشوائية والتشغيل المتوازي، وتشغل افتراضياً مقابل خادم Rails التشغيلي وأصول JavaScript الموجودة. شغّل bin/qunit --help للحصول على القائمة الكاملة للخيارات.

فيما يلي بعض الأمثلة المفيدة:

# Run a single test file, or every test in a directory:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components

# Run the entire core suite across 5 headless Chrome instances in parallel:
bin/qunit --parallel 5

# Run all tests whose "module: test name" contains a substring (case-insensitive):
bin/qunit --filter "Integration | Component | bookmark"

# Slash-wrap the value to match with a regular expression, e.g. for alternation:
bin/qunit --filter "/bookmark|reaction/i"

# Spin up an isolated server and run in a visible browser for easier debugging:
bin/qunit --standalone --no-headless

:information_source: يتم تمرير --filter إلى QUnit: تتطابق القيمة العادية كسلسلة فرعية غير حساسة لحالة الأحرف، بينما تتطابق القيمة المحاطة بشرطات مائلة مثل /foo/i كتعبير منتظم. قم بتضمين العلم i لمطابقة التعبيرات المنتظمة غير الحساسة لحالة الأحرف.

الإضافات

من الدليل الجذري لـ Discourse:

bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Run one file
bin/qunit plugins/chat/test/javascripts/unit # Run a directory
bin/rake "plugin:qunit" # Run all plugin qunit tests
bin/rake "plugin:qunit[discourse-chat-integration]" # Run a single plugin's qunit tests

القوالب

من الدليل الجذري لـ Discourse:

bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"

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

20 إعجابًا