# مرجع واجهة ⁦node:test⁩

استورد واجهة تسجيل الاختبارات المتوافقة مع ⁦Node⁩ باستخدام ⁦`node:test`⁩:

```javascript
import test, { describe, it } from "node:test";

test("addition", (t) => {
  t.assert.strictEqual(1 + 1, 2);
});

describe("math", () => {
  it("multiplies", (t) => {
    t.assert.strictEqual(2 * 3, 6);
  });
});
```

## الواجهة المتاحة

| المجال | العناصر |
|---|---|
| الاختبارات والمجموعات | ⁦`test` / `it`⁩ و⁦`describe` / `suite`⁩، إضافةً إلى ⁦`.skip`⁩ و⁦`.todo`⁩ و⁦`.only`⁩ |
| الخطافات | ⁦`before`⁩ و⁦`after`⁩ و⁦`beforeEach`⁩ و⁦`afterEach`⁩ |
| سياق الاختبار | ⁦`t.assert`⁩ و⁦`t.test`⁩ والخطافات و⁦`t.diagnostic`⁩ و⁦`t.plan`⁩ و⁦`t.skip`⁩ و⁦`t.todo`⁩ و⁦`t.mock`⁩ و⁦`t.signal`⁩ |
| المحاكاة | ⁦`mock.fn`⁩ و⁦`mock.method`⁩ ومحاكاة الخصائص والموصّلات والمؤقتات الزائفة وإعادة الضبط والاستعادة |
| تأكيدات الوحدة | `test.assert` |

لم تُنفَّذ تأكيدات اللقطات، ولا ⁦`mock.module()`⁩، ولا نقطة الدخول البرمجية ⁦`run()`⁩.

## تشغيل الاختبارات

شغّل ملفات ⁦`node:test`⁩ باستخدام ⁦`elide test`⁩، الذي يقبل أيضًا ملفًا صريحًا:

```bash
elide test ./math.test.mjs
```

يسجّل ⁦`elide run`⁩ الاختبارات دون تشغيلها، ويطبع أمر ⁦`elide test`⁩
الذي ينبغي استخدامه بدلًا منه.

## انظر أيضًا

- [واجهة الاختبار في ⁦Node.js⁩](https://nodejs.org/api/test.html)

<!-- api-reference:start c3c2a6313f8a -->
## Reference

**Status:** Partial · Not measured · since 1.1.0

### Exports

| Export | Kind | Status | Notes |
| --- | --- | --- | --- |
| `test()` | function | Full | Define and run a test case |
| `it()` | function | Full | Alias for test() |
| `describe()` | function | Full | Group tests into a suite |
| `suite()` | function | Full | Alias for describe() |
| `before()` | function | Full | Register a function to run before all tests in the current suite |
| `after()` | function | Full | Register a function to run after all tests in the current suite |
| `beforeEach()` | function | Full | Register a function to run before each test in the current suite |
| `afterEach()` | function | Full | Register a function to run after each test in the current suite |
| `mock` | property | Full | The mock object for creating spies and mocking timers |

### Not implemented

`expectFailure`, `getTestContext`.
<!-- api-reference:end -->
