الاختبار

يشغّل الأمر elide test ملفات node:test المكتوبة بلغتي JavaScript و TypeScript واختبارات JUnit.

elide test

يجعل الاختبار الفاشل رمز الخروج غير صفري.

JavaScript و TypeScript

تستخدم الاختبارات واجهة node:test ولا تحتاج إلى ملف بيان. يُعدّ الملف اختبارًا إذا طابق *.test.* أو *.spec.* أو *_test.* أو *_spec.*، أو كان داخل test أو tests أو __tests__. الامتدادات: .js و .mjs و .cjs و .ts و .mts و .cts.

يتخطى الاكتشاف المجلدات المخفية ومجلدات التبعيات ومخرجات البناء. ويتوقف عند أي مشروع متداخل (مجلد يحتوي على elide.pkl أو package.json أو pom.xml أو requirements.txt)، لذا لا يجد جذر مساحة العمل اختبارات الأعضاء. حدّد مسارًا لتشغيلها.

import test from "node:test";
import assert from "node:assert";

test("adds two values", () => {
  assert.equal(1 + 1, 2);
});

اختبارات JVM

تعمل اختبارات JVM على JUnit Platform وتحتاج إلى elide.pkl. المجلد src/test هو مجموعة مصادر الاختبار الافتراضية؛ وتحلّ محله أي مجموعة مصادر مصرّح بها من النوع test (مجموعات المصادر).

• تحصل مجموعات الاختبار على testPackages إضافة إلى تبعيات المجموعة الرئيسية.
• تُضاف مكتبات JUnit المضمّنة افتراضيًا. يزيل jvm.features.testing = false واجهات JUnit البرمجية اللازمة للتصريف وبيئة التشغيل المضمّنة معًا؛ وعندها يحتاج تشغيل اختبارات JVM إلى مشغّل JUnit لسطر الأوامر (junit-platform-console) في testPackages، وإلا فشل بخطأ. ولا تتأثر عمليات التشغيل التي لا تتضمن اختبارات JVM.
• تعمل processors على مصادر الاختبار.
• تحصل JVM الاختبار على jvm.flags و jvm.defs (بصيغة -D).
• توضع تبعيات modules لمجموعتي الاختبار والرئيسية على --module-path مع --add-modules=ALL-MODULE-PATH.
• تتقدم إعدادات التوازي في ملف junit-platform.properties الموجود على مسار أصناف الاختبار على --concurrency.

اختيار الاختبارات

تحصر المسارات أو المجلدات أو أنماط glob اختبارات JavaScript و ⁦TypeScript:⁩

elide test src/api
elide test src/api/client.test.ts

مع وسائط المسارات تُتخطى اختبارات JVM ويُطبع Path filtering unsupported for JVM tests: <paths>. ويطابق -t أسماء الاختبارات في كلا المشغّلين:

elide test -t 'parses .+ headers'

تقبل اختبارات JVM محدِّدات JUnit وتعبيرات الوسوم:

elide test --select=class:com.example.ParserTest
elide test --select=method:com.example.ParserTest#parsesHeaders
elide test --select=package:com.example.parser   # the package and its subpackages
elide test com.example.parser                     # a dotted bare token is a package selector
elide test --include-tag=fast --include-tag=unit  # fast OR unit
elide test --exclude-tag=slow --exclude-tag=flaky # neither slow nor flaky
elide build test --select=class:com.example.ParserTest

التعبير --include-tag='slow & !flaky' تعبير واحد. وتُطبَّق مرشحات الوسوم بعد المحدِّدات.

المخرجات والتقارير

يذهب التقدم إلى stderr، والحصيلة النهائية إلى ⁦stdout:⁩

elide test > summary.txt
elide test 2> progress.txt

تُكتب التقارير في .dev/reports/tests/<language>/<source-set>/. ويفعّلها testing.reports في elide.pkl دون خيار:

import "elide:Testing.pkl" as Testing

testing {
  reports { Testing.xmlReport() }
}

مخرجات TAP

يجعل --reporter=tap مخرجات stdout تدفق TAP 13 خالصًا:

TAP version 13
# start 1: suite A > t1
# out 1: printed from inside a test
ok 1 - suite A > t1
# start 2: broken
not ok 2 - broken
  ---
  message: "expected 1 to equal 2"
  severity: "ERR_ASSERTION"
  ...
1..2

• يفتح # start <id> اختبارًا؛ وأسطر مخرجاته بالصيغة # out <id>: <text>. أما # out: <text> فلا ينتمي إلى أي اختبار.
• تُرقَّم نقاط الاختبار 1..N بترتيب انتهائها. اربط النقاط بالاختبارات عبر سطر # start، لا عبر الرقم.
• لا تظهر كتلة YAML إلا مع حالات الفشل التي تحمل تفاصيل؛ و severity هو رمز خطأ المشغّل إن وُجد.
• لا يُغلَّف ⁦stderr:⁩ الأمر elide test --reporter=tap 2>&1 لا ينتج TAP صالحًا.
• في ⁦JVM:⁩ لا تُنسب المخرجات إلى اختبارها إلا ما دام اختبار واحد بالضبط قيد التشغيل. ومع --concurrency أكبر من 1 أو ملف junit-platform.properties في المشروع، تبقى غير منسوبة.
• في ⁦JavaScript:⁩ يُغلَّف console.log داخل اختبار، أو في المستوى الأعلى بعد استيراد node:test. أما المخرجات قبل ذلك الاستيراد فتُطبع كما هي. وتنتمي مخرجات الخطّاف إلى الاختبار الذي يحيط به؛ ويُغلَّف t.diagnostic بصيغة # out.

التغطية

elide test --coverage
elide run --coverage

تذهب تغطية JVM إلى .dev/reports/coverage/jvm/<task>/ بصيغة HTML أو XML أو CSV؛ أما تغطية JavaScript و TypeScript فبصيغة LCOV، في .dev/reports/coverage/js/lcov.info للاختبارات و .dev/reports/coverage/js/run/lcov.info لعمليات التشغيل. وتطبع وحدة التحكم ملخصًا واحدًا مجمّعًا. تجمع الكتلة coverage في المستوى الأعلى التغطية دون الخيار:

import "elide:Coverage.pkl" as Coverage

coverage {
  enabled = true
  scope = "tests"
  jvm {
    excludes { "org.example.generated.*" }
    reports {
      Coverage.xmlReport()
      Coverage.htmlReport()
    }
  }
  js {
    paths { "src" }
  }
}

مع التغطية، يبدأ elide run عملية JVM منفصلة.

الخيارات

الصياغة: تصحيح الأخطاء. يفشل الخيار المجهول أو القيمة الناقصة قبل تشغيل أي شيء (مهام البناء).

القيود

• لا يوجد اكتشاف لاختبارات Python؛ شغّل unittest أو pytest بدلًا من ذلك (اختبارات Python).
• تحتاج اختبارات JVM إلى ملف بيان.
• غير مُنفَّذ: لقطات node:test، و mock.module، ووضع المراقبة، و run() البرمجي، و node:test/reporters.

الواجهة المدعومة: واجهة اختبارات Node.

أمثلة

• اختبارات TypeScript
• اختبارات Kotlin
• تصفية الاختبارات باستخدام CEL
• JUnit XML في CI

ابدأ من قالب:

elide init --template java        # Java app with a JUnit test
elide init --template ktjvm       # Kotlin app with a test