Mocks و Fakes

Mocks and Fakes

مفهوم ~19 دقيقة

Mocks و Fakes

عندما تعتمد دالة على API أو قاعدة بيانات أو وقت النظام، يصبح الاختبار أصعب. الحل هو تعريف interface للتبعية، ثم تمرير fake في الاختبار. TypeScript يضمن أن fake يطابق العقد نفسه الذي يستخدمه الكود الحقيقي.

لا تبنِ mock ضخماً إذا كان fake صغير يكفي. fake هو تنفيذ بسيط predictable. مثلاً UserStore يرجع مستخدماً ثابتاً. هذا أسهل من محاكاة مكتبة كاملة.

مثال عملي

index.ts

interface UserStore {
  findName(id: number): string | undefined;
}

function greeting(store: UserStore, id: number): string {
  const name = store.findName(id);
  return name ? `Hello ${name}` : "Unknown user";
}

const fakeStore: UserStore = {
  findName: () => "Sara",
};

console.log(greeting(fakeStore, 1));

Output:

الدالة لا تعرف هل store حقيقي أو fake. تعرف فقط العقد.

أدوات الاختبار — Test Runners

Vitest هو runner الاختبار الكانوني في 2026 لمشاريع TypeScript. سريع، يدعم ESM، ويعمل مباشرة مع TypeScript بدون إعداد:

npm install -D vitest

اكتب ملفات *.test.ts وشغّلها:

npx vitest

مثال اختبار كامل مع mock:

index.ts

import { describe, it, expect, vi } from "vitest";

function upper(s: string): string {
  return s.toUpperCase();
}

describe("upper", () => {
  it("uppercases a string", () => {
    expect(upper("hi")).toBe("HI");
  });
});

Output:

node:test (Node.js ≥ 20 builtin) هو البديل بدون dependencies:

import { describe, it } from "node:test";
import assert from "node:assert/strict";

describe("upper", () => {
  it("uppercases", () => assert.equal(upper("hi"), "HI"));
});

استخدم node:test عندما تريد صفر dependencies. استخدم Vitest في مشاريع كبيرة تستفيد من watch mode والتقارير المتقدمة.

التصميم للاختبار

مرر التبعيات بدلاً من إنشائها داخل الدالة عندما يكون ذلك مناسباً. هذا يقلل coupling.

تحدي — Challenge

interface Store {
  name(): string;
}

function greeting(store: Store): string {
  return `Hello ${store.name()}`;
}

const fakeStore: Store = { name: () => "Sara" };

// اطبع greeting — Print greeting