Mock, MSW আর test data — flaky test কমানো

১ · কী নকল করবেন, কী আসল রাখবেন

মডিউল ১১-এর আগের পর্বগুলোতে “বাজারঘর”-এর জন্য নানা স্তরের test লেখা হয়েছে: unit test (পর্ব ৭৩), component test (পর্ব ৭৪), test database-সহ API test (পর্ব ৭৫) আর Playwright দিয়ে পুরো পথ (পর্ব ৭৬)। প্রতিটিতে একটি প্রশ্ন বারবার এসেছে: এই test-এ কোন অংশ আসল, আর কোন অংশ নকল? এই পর্ব সেই প্রশ্নের উত্তর গুছিয়ে দেয়, তারপর test-এর সবচেয়ে বিরক্তিকর সমস্যায় যায়: flaky test, অর্থাৎ যে test কোড না বদলালেও কখনো পাস করে, কখনো ফেল।

সফটওয়্যারে চুলা আর হাঁড়ি হলো আপনার নিজের কোড, নিজের database আর নিজের schema. আড়ত হলো বাইরের সেবা: payment gateway, SMS gateway, email পাঠানোর সেবা, কুরিয়ারের API. এদের বদলে যা বসান, তার সাধারণ নাম test double. Software Engineering কোর্সের test double পর্বে dummy, stub, spy, mock আর fake-এর পার্থক্য বিস্তারিত আছে; এখানে আমরা দৈনন্দিন কথার মতো “mock” বলব, কিন্তু কোনটি আসলে কী করছে তা খেয়াল রাখব।

সিদ্ধান্তের জন্য চারটি প্রশ্ন যথেষ্ট। নিচের টেবিলে বাজারঘরের সাধারণ নির্ভরতাগুলো সেই প্রশ্ন ধরে সাজানো।

২ · Over-mocking — সবুজ test, ভাঙা production

Over-mocking মানে এত বেশি নকল করা যে test আর আসল কোডের আচরণ যাচাই করে না, শুধু যাচাই করে “আমি যা ভেবেছিলাম, কোড তা-ই ডেকেছে”। সবচেয়ে সাধারণ রূপ: নিজের repository বা ORM client mock করা। নিচের ঘটনাটি ল্যাবে সত্যিই ঘটানো হয়েছে।

বাজারঘরে একটি migration এসেছে: orders টেবিলের column total_paisa-এর নাম বদলে amount_paisa. Migration লেখা হলো, কিন্তু repository-র SQL বদলানো হলো না। Service-এর test repository-কে vi.fn() দিয়ে নকল করে:

test('নিজের repository mock করে: সবুজ', () => {
  const repo = { insert: vi.fn() };
  expect(placeOrder(repo, 'BG-9001', 1, 84000).status).toBe('PLACED');
  expect(repo.insert).toHaveBeenCalledWith({ ref: 'BG-9001', customerId: 1, totalPaisa: 84000 });
});

test('আসল (in-memory) database-এ: লাল', () => {
  const db = new DatabaseSync(':memory:');
  db.exec('CREATE TABLE orders (ref TEXT PRIMARY KEY, customer_id INTEGER, amount_paisa INTEGER NOT NULL)');
  expect(placeOrder(makeOrderRepo(db), 'BG-9001', 1, 84000).status).toBe('PLACED');
});

এখানে দ্বিতীয় test-এ Node-এর built-in node:sqlite ব্যবহার করা হয়েছে, শুধু দেখানোর জন্য যে ছোট একটি আসল database-ও ভুলটি সাথে সাথে ধরে। বাজারঘরের আসল কাজে এটি হবে পর্ব ৭৫-এর PostgreSQL test database. সত্যিকারের run, Node 24.15.0 আর Vitest 5.1.0:

$ npx vitest run tests/overmock.test.ts --reporter=verbose
 ✓ tests/overmock.test.ts > নিজের repository mock করে: সবুজ 2ms
 × tests/overmock.test.ts > আসল (in-memory) database-এ: লাল 10ms
   → table orders has no column named total_paisa

 FAIL  tests/overmock.test.ts > আসল (in-memory) database-এ: লাল
Error: table orders has no column named total_paisa
 ❯ Object.insert src/orders.ts:7:10
 ❯ placeOrder src/orders.ts:16:8
 ❯ tests/overmock.test.ts:14:10
Serialized Error: { code: 'ERR_SQLITE_ERROR', errcode: 1, errstr: 'SQL logic error' }

 Test Files  1 failed (1)
      Tests  1 failed | 1 passed (2)

প্রথম test একা থাকলে CI সবুজ, deploy হতো, আর প্রথম order-এই server 500 দিত। Mock-টি সেই প্রশ্নই করেনি, যার উত্তর জরুরি: SQL কি schema-র সাথে মেলে? একইভাবে mock-করা database duplicate-এর unique constraint (পর্ব ৪৩), N+1 query (পর্ব ৪২) বা rollback কিছুই দেখে না।

তাহলে vi.fn() কখন ঠিক? যখন সত্যিই “ডাকা হলো কি না” জানতে চান, আর ডাকা জিনিসটি সীমানার বাইরে, যেমন dependency injection দিয়ে আসা SMS client (পর্ব ২৯)। তবে HTTP স্তরে MSW দিয়ে নকল করা প্রায়ই ভালো, কারণ তাতে আপনার আসল HTTP client, header আর JSON তৈরিও test-এ চলে।

৩ · MSW — network-এর সীমানায় নকল

Mock Service Worker (MSW) একটি open-source library, যা Artem Zakharchenko-র হাতে শুরু হয় ২০১০-এর দশকের শেষ দিকে। এর মূল ভাবনা: আপনার কোড যেভাবে আছে সেভাবেই fetch ডাকুক; অনুরোধটি বাইরে যাওয়ার ঠিক আগে MSW ধরে ফেলবে, আর আপনার লেখা handler উত্তর দেবে। Browser-এ এটি একটি service worker দিয়ে কাজ করে, নামও সেখান থেকে। Node-এ (Vitest বা Jest-এ) এটি Node-এর HTTP আর fetch-এর স্তরে অনুরোধ ধরে; সেখানে কোনো service worker নেই।

ল্যাবের গঠন খুব ছোট। Handler এক জায়গায়, তারপর দুটি পাতলা ফাইল: একটি Node-এর জন্য, একটি browser-এর জন্য।

import { http, HttpResponse } from 'msw/http';

// একই handler: Vitest, browser-এর dev আর Storybook — তিন জায়গায়
export const handlers = [
  http.get('*/api/products', () =>
    HttpResponse.json([
      { id: 1, name: 'মিনিকেট চাল ৫ কেজি', pricePaisa: 42000 },
      { id: 2, name: 'মসুর ডাল ১ কেজি', pricePaisa: 13490 },
    ]),
  ),
  http.post('https://sms.example.test/v1/send', async ({ request }) => {
    const body = (await request.json()) as { to: string };
    return HttpResponse.json({ id: 'sms_test_1', to: body.to, status: 'queued' }, { status: 202 });
  }),
];

// src/mocks/node.ts
import { setupServer } from 'msw/node';
import { handlers } from './handlers';
export const server = setupServer(...handlers);

// vitest.setup.ts (vitest.config.ts-এ setupFiles দিয়ে যুক্ত)
import '@testing-library/jest-dom/vitest';
import { afterAll, afterEach, beforeAll } from 'vitest';
import { cleanup } from '@testing-library/react';
import { server } from './src/mocks/node';

beforeAll(() => server.listen({ onUnhandledFrame: 'error' }));
afterEach(() => { server.resetHandlers(); cleanup(); });
afterAll(() => server.close());

তিনটি জিনিস লক্ষ করুন। */api/products-এর তারকা চিহ্ন যেকোনো origin মেলায়, তাই jsdom বা dev server, একই handler চলে। server.resetHandlers() প্রতিটি test-এর পরে সেই test-এর যোগ করা handler সরায়। আর onUnhandledFrame: 'error': handler না থাকলে test ব্যর্থ হয়, আসল network-এ যায় না।

শেষেরটি পরীক্ষা করা হলো। কেউ coupon API-র handler লিখতে ভুলে গেছেন, আর test সেই API ডাকে:

$ npx vitest run tests/unhandled.test.ts --reporter=verbose
stderr | tests/unhandled.test.ts > coupon যাচাই
[MSW] Error: intercepted a request without a matching request handler:

  • GET https://api.bazarghar.test/api/coupons/EID10

If you still wish to intercept this unhandled request, please create a request handler for it.

 × tests/unhandled.test.ts > coupon যাচাই 24ms
   → fetch failed
TypeError: fetch failed
Caused by: InternalError: [MSW] Cannot bypass a request when using the "error" strategy for the "onUnhandledFrame" option.

এবার একই test, কিন্তু setup ফাইলে MSW 2-এর পুরোনো নাম onUnhandledRequest: 'error', যা AI আর পুরোনো blog প্রায়ই লেখে। সত্যিকারের run:

stderr | tests/unhandled.test.ts > coupon যাচাই
[MSW] Warning: intercepted a request without a matching request handler:
  • GET https://api.bazarghar.test/api/coupons/EID10
 × coupon যাচাই 35ms
TypeError: fetch failed
Caused by: Error: getaddrinfo ENOTFOUND api.bazarghar.test

“Error” হয়ে গেছে “Warning”, আর অনুরোধটি সত্যিই network-এ বেরিয়ে গেছে: DNS-এ ঠিকানাটি খোঁজা হয়েছে (ENOTFOUND). MSW 3 পুরোনো option-টি নীরবে উপেক্ষা করে ডিফল্ট “warn”-এ ফিরেছে; ঠিকানাটি আসল সেবার হলে test সেখানে অনুরোধ পাঠাত। TypeScript এটি ধরে: tsc-তে error TS2353: … 'onUnhandledRequest' does not exist in type …. তাই test-এর setup ফাইলও type-check-এর আওতায় রাখুন।

একটি অনুরোধ MSW-এর ভেতরে কোন পথে যায়, ধাপে ধাপে দেখুন। উদাহরণ পর্ব ৭৪-এর ধাঁচের একটি component test: ProductList mount হয়ে fetch করে।

DOM: <p>লোড হচ্ছে…</p>
useEffect → fetch(
  new URL('/api/products', location.origin))

ধরা হলো: GET …/api/products
DNS নেই, TCP নেই, আসল server নেই
এখন handler-এর তালিকায় খোঁজা

১. server.use(...) দিয়ে যোগ করা  → এই test-এ নেই
২. handlers[0] GET */api/products → মিলল
   (না মিললে → onUnhandledFrame: 'error')

200 OK  content-type: application/json
[{"id":1,"name":"মিনিকেট চাল ৫ কেজি","pricePaisa":42000},
 {"id":2,"name":"মসুর ডাল ১ কেজি","pricePaisa":13490}]

setItems, setState('ok') → re-render
<li>মিনিকেট চাল ৫ কেজি — ৳420.00</li>
<li>মসুর ডাল ১ কেজি — ৳134.90</li>
✓ সফল: দুটি পণ্য দেখায় 122ms

MSW-এর ভেতরের কাজ বোঝার জন্য নিচে একটি ছোট শিক্ষার মডেল। এটি আসল MSW নয়; শুধু ধারণাটি দেখায়: handler-এর একটি টেবিল, use দিয়ে সাময়িক handler সামনে বসানো, resetHandlers দিয়ে সরানো, আর একটি নকল ঘড়ি, যাতে “৫ সেকেন্ড দেরি” পরীক্ষা করতে সত্যিই ৫ সেকেন্ড অপেক্ষা করতে না হয়।

// শিক্ষার মডেল: MSW-এর মতো handler-এর টেবিল আর নকল ঘড়ি (আসল MSW নয়)
const base = [
  { method: "GET", path: "/api/products", reply: () => ({ status: 200, body: "[চাল, ডাল]" }) },
];
let overrides = [];
const use = (h) => overrides.unshift(h);          // server.use-এর মতো: আগে খোঁজা হয়
const resetHandlers = () => { overrides = []; };

let clock = 0;                                     // নকল ঘড়ি, মিলিসেকেন্ডে
function fakeFetch(method, path, timeoutMs = 1000) {
  const h = [...overrides, ...base].find((x) => x.method === method && x.path === path);
  if (!h) return `ERROR unhandled ${method} ${path} (onUnhandledFrame: "error")`;
  const r = h.reply();
  const waited = r.delayMs ?? 0;
  if (waited > timeoutMs) { clock += timeoutMs; return `TIMEOUT after ${timeoutMs}ms`; }
  clock += waited;
  return r.networkError ? "TypeError: Failed to fetch" : `${r.status} ${r.body ?? ""} (+${waited}ms)`;
}

console.log("১ সফল  :", fakeFetch("GET", "/api/products"));
use({ method: "GET", path: "/api/products", reply: () => ({ status: 500, body: "" }) });
console.log("২ error:", fakeFetch("GET", "/api/products"));
resetHandlers();
use({ method: "GET", path: "/api/products", reply: () => ({ status: 200, body: "[চাল]", delayMs: 300 }) });
console.log("৩ ধীর  :", fakeFetch("GET", "/api/products"));
use({ method: "GET", path: "/api/products", reply: () => ({ delayMs: 5000 }) });
console.log("৪ আটকে :", fakeFetch("GET", "/api/products"));
use({ method: "GET", path: "/api/products", reply: () => ({ networkError: true }) });
console.log("৫ নেট  :", fakeFetch("GET", "/api/products"));
resetHandlers();
console.log("৬ ভুলে :", fakeFetch("GET", "/api/coupons/EID10"));
console.log("নকল ঘড়ি মোট এগোল:", clock, "ms; আসল সময় প্রায় শূন্য");

৪ · Error, ধীর উত্তর আর একই handler তিন জায়গায়

বেশিরভাগ বাগ লুকিয়ে থাকে সুখী পথের বাইরে: server 500 দিল, উত্তর আসতে দেরি হলো, বা network-ই নেই। আসল server-কে এমন আচরণ করানো কঠিন; MSW-এ এটি এক লাইন। নিচের component test-গুলো পর্ব ৭৪-এর Testing Library-র ধাঁচে লেখা, প্রতিটি test শুধু নিজের প্রয়োজনের handler server.use দিয়ে সামনে বসায়:

import { http, HttpResponse } from 'msw/http';
import { delay } from 'msw/utils/delay';

test('server 500 দিলে বার্তা দেখায়', async () => {
  server.use(http.get('*/api/products', () => new HttpResponse(null, { status: 500 })));
  render(<ProductList />);
  expect(await screen.findByRole('alert')).toHaveTextContent('পণ্য আনা যায়নি');
});

test('ধীর উত্তর: আগে লোড, পরে তালিকা', async () => {
  server.use(http.get('*/api/products', async () => {
    await delay(300);
    return HttpResponse.json([{ id: 9, name: 'চিনি ১ কেজি', pricePaisa: 13000 }]);
  }));
  render(<ProductList />);
  expect(screen.getByText('লোড হচ্ছে…')).toBeInTheDocument();
  expect(await screen.findByText(/চিনি/)).toBeInTheDocument();
});

test('network ভেঙে গেলে', async () => {
  server.use(http.get('*/api/products', () => HttpResponse.error()));
  render(<ProductList />);
  expect(await screen.findByRole('alert')).toBeInTheDocument();
});

$ npx vitest run tests/product-list.test.tsx --reporter=verbose
 RUN  v5.1.0 ~/bazarghar
 ✓ tests/product-list.test.tsx > সফল: দুটি পণ্য দেখায় 122ms
 ✓ tests/product-list.test.tsx > server 500 দিলে বার্তা দেখায় 14ms
 ✓ tests/product-list.test.tsx > ধীর উত্তর: আগে লোড, পরে তালিকা 321ms
 ✓ tests/product-list.test.tsx > network ভেঙে গেলে 15ms
 Test Files  1 passed (1)
      Tests  4 passed (4)
   Duration  1.30s (environment 45%, tests 40%, setup 13%, transform 1%, import 1%)

ধীর test-টি ৩২১ ms নিয়েছে, কারণ delay(300) আসল সময় অপেক্ষা করে। “৩০ সেকেন্ড পরে timeout” পরীক্ষায় আসল ৩০ সেকেন্ড অপেক্ষা চলবে না; তখন নকল ঘড়ি (অংশ ৮)। সংখ্যা ছাড়া delay() docs অনুযায়ী browser-এ ১০০ থেকে ৪০০ ms-এর একটি এলোমেলো “বাস্তবসম্মত” দেরি দেয়, আর Node-এ সেই দেরি প্রায় শূন্য করে দেওয়া হয়; তাই test-এ নির্দিষ্ট সংখ্যাই নিরাপদ।

একই handler browser-এ। Backend তৈরি হওয়ার আগেই frontend-এর কাজ শুরু করতে বা একটি error-এর পাতা হাতে দেখতে একই handlers.ts browser-এ চালানো যায়। প্রথমে npx msw init public --save worker script (mockServiceWorker.js) public folder-এ রাখে। তারপর app চালুর আগে worker শুরু:

import { createRoot } from 'react-dom/client';
import { ProductList } from './ProductList';

async function enableMocking() {
  if (!import.meta.env.DEV || import.meta.env.VITE_MOCKS !== 'on') return;
  const { worker } = await import('./mocks/browser');   // setupWorker(...handlers)
  await worker.start({ onUnhandledFrame: 'bypass' });   // dev-এ বাকি অনুরোধ আসল পথে
}
enableMocking().then(() => createRoot(document.getElementById('root')!).render(<ProductList />));

Vite dev server 127.0.0.1:47781-এ চালিয়ে Edge-এ Playwright দিয়ে পাতাটি খোলা হলো; browser-এর console আর পাতার লেখা, সত্যিকারের run (একটি ফাঁকা favicon-এর 404 আর React DevTools-এর বার্তা বাদ):

[console] [MSW] Mocking enabled.
[console] Worker script URL: http://127.0.0.1:47781/mockServiceWorker.js
[request] GET /api/products
[console] [MSW] 01:55:29 GET /api/products (200 OK)
[page] মিনিকেট চাল ৫ কেজি — ৳420.00 | মসুর ডাল ১ কেজি — ৳134.90

অনুরোধটি সত্যিই browser থেকে বেরিয়েছে, service worker মাঝপথে ধরে উত্তর দিয়েছে। দুটি সতর্কতা। (১) import.meta.env.DEV দিয়ে পাহারা, যাতে production build-এ worker না যায়। (২) Dev-এ 'bypass', যাতে font, ছবি বা আসল API স্বাভাবিক পথে যায়; test-এ নীতি সবসময় 'error'. MSW 3-এ msw/vite নামে একটি Vite plugin-ও আছে; এই ল্যাবে চিরাচরিত setupWorker পথটি চালানো হয়েছে।

Storybook-এ। Storybook-এ component আলাদা করে দেখার সময়ও একই handler কাজে লাগে, সম্প্রদায়ের msw-storybook-addon-এর মাধ্যমে (লেখার সময় npm-এ 3.0.3), যেমন “error অবস্থা” নামের story-তে 500. এই ল্যাবে Storybook চালানো হয়নি; addon আর MSW-এর version মিলিয়ে নেবেন।

৫ · Test data — factory, builder আর object mother

প্রতিটি test-এর কিছু ডেটা লাগে: একজন গ্রাহক, একটি order, কয়েকটি item. হাতে লেখা বড় object প্রতিটি test-এ কপি করলে দুটি সমস্যা হয়। (১) কোন ঘরটি এই test-এর জন্য জরুরি, পড়ে বোঝা যায় না। (২) Model-এ একটি নতুন বাধ্যতামূলক field এলে পঞ্চাশটি ফাইল বদলাতে হয়। সমাধানের তিনটি পরিচিত ধরন আছে।

বাস্তবে তিনটি মিশিয়ে চলে: নিচে factory, তার ওপর কয়েকটি নাম দেওয়া ছোট object mother ফাংশন, যারা factory-ই ডাকে। নিচের block-এ বাজারঘরের factory-র একটি ছোট রূপ। খেয়াল করুন, totalPaisa কখনো হাতে দেওয়া হয় না, item থেকে হিসাব হয়; নইলে test-এ এমন order তৈরি হতে পারে, যা বাস্তবে কখনো ঘটে না।

// Factory + override: test শুধু সেটুকু বলে, যা তার কাছে জরুরি
let nextId = 0;
const reset = () => { nextId = 0; };

function buildItem(over = {}) {
  nextId += 1;
  return { sku: `SKU-${nextId}`, qty: 1, pricePaisa: 10000, ...over };
}
function buildCustomer(over = {}) {
  nextId += 1;
  return { id: nextId, name: "নমুনা গ্রাহক", city: "ঢাকা", vip: false, ...over };
}
function buildOrder(over = {}) {
  const customer = over.customer ?? buildCustomer();
  const items = over.items ?? [buildItem()];
  const totalPaisa = items.reduce((s, i) => s + i.qty * i.pricePaisa, 0);
  return { ref: `BG-${9000 + customer.id}`, status: "PENDING", customer, items, totalPaisa,
    ...over.fields };
}

reset();
const plain = buildOrder();
console.log("ডিফল্ট:", plain.ref, plain.items.length, "টি item, মোট", plain.totalPaisa);

reset();
const big = buildOrder({
  customer: buildCustomer({ vip: true }),
  items: [buildItem({ qty: 2, pricePaisa: 42000 }), buildItem({ pricePaisa: 13490 })],
});
console.log("override:", big.ref, "vip =", big.customer.vip, "মোট", big.totalPaisa);
console.log("items:", big.items.map((i) => `${i.sku}x${i.qty}`).join(", "));

reset();
const paid = buildOrder({ fields: { status: "PAID" } });
console.log("শুধু অবস্থা বদল:", paid.ref, paid.status, paid.totalPaisa);

দ্বিতীয় অংশের factory-কল ধাপে ধাপে, কোন মুহূর্তে কোন id আর কোন মোট তৈরি হয়:

1reset();2const big = buildOrder({3  customer: buildCustomer({ vip: true }),4  items: [5    buildItem({ qty: 2, pricePaisa: 42000 }),6    buildItem({ pricePaisa: 13490 }),7  ],8});

প্রতিটি test-এ ন্যূনতম ডেটা। “VIP-এর ছাড়” পরীক্ষায় শুধু vip: true আর দাম বলুন; নাম, ফোন, শহর লিখলে পাঠক ভাববেন সেগুলোও জরুরি। API test-এও (পর্ব ৭৫) database-এ শুধু এই test-এর দেখা সারিগুলো রাখুন।

৬ · Seed দেওয়া এলোমেলো ডেটা আর বাংলা নাম-ঠিকানা

Factory-র ডিফল্ট মান স্থির রাখা যায় (“নমুনা গ্রাহক”), আবার এলোমেলোও করা যায়। এলোমেলো ডেটার লাভ: এমন কোণ ধরা পড়ে, যা আপনি ভাবেননি, যেমন খুব লম্বা নাম বা যুক্তাক্ষরের ঠিকানা। বিপদ: আজ পাস, কাল ফেল, আর কেন তা জানেন না। মাঝের পথ হলো pseudo-random number generator (PRNG) আর তার seed. PRNG আসলে একটি হিসাবের সূত্র; একই seed দিলে সবসময় একই ক্রমে একই “এলোমেলো” সংখ্যা দেয়।

নিচের block-এ একটি পরিচিত ছোট PRNG, mulberry32, একজন বাংলা নামের নকল গ্রাহক বানায়। একই seed দুবার, তারপর দুটি ভিন্ন “ঘড়ির” seed, যা seed না দিলে সাধারণত যা ঘটে তার নকল।

// seed দেওয়া এলোমেলো সংখ্যা: mulberry32 (ছোট, পরিচিত PRNG)
function mulberry32(seed) {
  return function () {
    seed = (seed + 0x6d2b79f5) | 0;
    let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);
    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
  };
}
const FIRST = ["রহিম", "করিম", "সুমাইয়া", "তানিয়া", "নাদিয়া", "আরিফ"];
const LAST = ["উদ্দিন", "হক", "আক্তার", "ইসলাম", "চৌধুরী"];
const AREA = ["মিরপুর, ঢাকা", "আগ্রাবাদ, চট্টগ্রাম", "জিন্দাবাজার, সিলেট", "সাহেববাজার, রাজশাহী"];

function customer(rand) {
  const pick = (list) => list[Math.floor(rand() * list.length)];
  const phone = "0170000" + String(Math.floor(rand() * 10000)).padStart(4, "0");
  return `${pick(FIRST)} ${pick(LAST)} | ${phone} | ${pick(AREA)}`;
}

console.log("seed 77, প্রথম run :", customer(mulberry32(77)));
console.log("seed 77, দ্বিতীয় run:", customer(mulberry32(77)));

// "seed ছাড়া" মানে সাধারণত seed আসে ঘড়ি থেকে; এখানে দুটি নকল ঘড়ির মান
const clockRuns = [1762190731042, 1762190755918];
for (const ms of clockRuns) {
  console.log(`ঘড়ির seed ${ms}:`, customer(mulberry32(ms % 2 ** 32)));
}

আসল faker-এ। @faker-js/faker (লেখার সময় 10.6.0) একই কাজ বড় পরিসরে করে, আর faker.seed(77) দিয়ে নির্ধারিত হয়। এতে bn_BD locale আছে, fakerBN_BD নামে import করা যায়। কিন্তু ল্যাবে খুলে দেখা গেল, 10.6.0-এ bn_BD নিজে দেয় শুধু তারিখের মাস আর বারের বাংলা নাম, আর জায়গার নাম: ৪৮০টি উপজেলা বা শহর (location.city), ৬৪টি জেলা (location.county), ৮টি বিভাগ (location.state), দেশের নাম। মানুষের নাম, রাস্তা আর ফোন নম্বর সেখানে নেই, তাই faker ইংরেজি locale-এ ফিরে যায়। Seed 77-এ সরাসরি fakerBN_BD, সত্যিকারের run:

person.fullName()        → Mr. Omar Bogisich
location.streetAddress() → 3547 Old Military Road
location.city()          → টংগিবাড়ী
phone.number()           → 740.741.0207

অর্থাৎ শহর বাংলা, বাকি সব আমেরিকান। সমাধান: নামের তালিকা নিজে দিন, কিন্তু বাছাইয়ের কাজ faker-এর seed দেওয়া helpers.arrayElement-এ রাখুন, যাতে seed-এর নিয়ন্ত্রণ এক জায়গায় থাকে:

import { fakerBN_BD as faker } from '@faker-js/faker';

// bn_BD-তে নাম নেই (লেখার সময়), তাই নিজের ছোট তালিকা
const FIRST = ['রহিম', 'করিম', 'সুমাইয়া', 'তানিয়া', 'নাদিয়া', 'আরিফ'];
const LAST = ['উদ্দিন', 'হক', 'আক্তার', 'ইসলাম', 'চৌধুরী'];

export function buildCustomer(over: Partial<Customer> = {}): Customer {
  seq += 1;
  return {
    id: seq,
    name: `${faker.helpers.arrayElement(FIRST)} ${faker.helpers.arrayElement(LAST)}`,
    phone: `0170000${faker.string.numeric(4)}`,          // স্পষ্ট নকল সংখ্যা
    city: faker.location.city(),
    district: faker.location.county(),
    ...over,
  };
}
export const resetFactories = (s: number) => { seq = 0; faker.seed(s); };

$ npx vitest run tests/factory.test.ts --reporter=verbose
stdout | tests/factory.test.ts > একই seed, একই গ্রাহক
{
  id: 1,
  name: 'আরিফ ইসলাম',
  phone: '01700007107',
  city: 'তারাকান্দা',
  district: 'বরগুনা'
}
stdout | tests/factory.test.ts > override: শুধু যা দরকার তা বলা
BG-9001 করিম আক্তার [ { sku: 'XNR53S', qty: 2, pricePaisa: 42000 } ] 84000
 ✓ tests/factory.test.ts > একই seed, একই গ্রাহক 2ms
 ✓ tests/factory.test.ts > override: শুধু যা দরকার তা বলা 1ms

দুটি জিনিস লক্ষ করুন। উপজেলা তারাকান্দা (ময়মনসিংহে) আর জেলা বরগুনা: faker অংশগুলো আলাদা আলাদা বাছে, তাই একসাথে বাস্তব ঠিকানা হয় না; জেলাভিত্তিক নিয়ম test করলে জোড়া নিজের তালিকা থেকে দিন। আর faker-এর নতুন version-এ তালিকা বদলালে একই seed ভিন্ন ফল দিতে পারে, তাই version lock-এ রাখুন, আর expect এলোমেলো মানে নয়, নিয়মে লিখুন (“মোট = item-এর যোগফল”)। বাংলা সংখ্যা আর তারিখ পর্ব ৫৯-এ।

৭ · Flaky test-এর সাত কারণ — প্রতিটি নিজের হাতে ঘটানো

“মাঝে মাঝে ফেল” ভাগ্যের ব্যাপার নয়; প্রায় সবসময় একটি লুকানো নির্ভরতা থাকে: ঘড়ি, এলোমেলো সংখ্যা, ক্রম, সময়ের প্রতিযোগিতা, network, বা অন্য একটি test. ল্যাবের tests/flaky/ folder-এ সাতটির প্রতিটি সত্যিই ঘটানো হয়েছে।

(ক) সময় আর time zone

একটি order-এর সময় 2026-11-02T20:30:00Z. UTC-তে তখন ২ নভেম্বর রাত সাড়ে আটটা, কিন্তু ঢাকায় (Asia/Dhaka, UTC+6) ৩ নভেম্বর রাত আড়াইটা। ফাংশনটি toLocaleDateString('en-CA') দিয়ে দিন বের করে, কোনো zone না বলে, তাই যে মেশিনে চলে সেই মেশিনের zone ধরে। একই test দুটি TZ-তে, সত্যিকারের run:

$ TZ=Asia/Dhaka npx vitest run tests/flaky/time.test.ts --reporter=verbose
 ✓ ফ্লেকি: মেশিনের zone-এ দিন 13ms
 ✓ ঠিক: Asia/Dhaka স্পষ্ট 0ms
 ✓ ঘড়ি স্থির: delivery আগামীকাল 1ms
   Start at  01:45:39

$ TZ=UTC npx vitest run tests/flaky/time.test.ts --reporter=verbose
 × ফ্লেকি: মেশিনের zone-এ দিন 16ms
   → expected '2026-11-02' to be '2026-11-03' // Object.is equality
 ✓ ঠিক: Asia/Dhaka স্পষ্ট 1ms
 ✓ ঘড়ি স্থির: delivery আগামীকাল 1ms
   Start at  19:45:40

ঢাকার developer-এর ল্যাপটপে সবুজ, UTC-তে চলা CI server-এ লাল (“Start at” লাইনেও ছয় ঘণ্টার পার্থক্য দেখুন)। সমাধান: কোডে { timeZone: 'Asia/Dhaka' } স্পষ্ট, আর “আজ”, “আগামীকাল”-এর হিসাবে test-এ ঘড়ি স্থির (অংশ ৮)।

(খ) Seed ছাড়া এলোমেলো ডেটা

দামের নিয়ম: ৳১০০০-এর বেশি হলে ৫% ছাড়। Test লিখেছেন এমন একজন, যিনি ভেবেছিলেন এলোমেলো ছোট দামে ছাড় কখনো লাগবে না:

test('ফ্লেকি: seed ছাড়া এলোমেলো দাম', () => {
  const qty = faker.number.int({ min: 1, max: 3 });
  const pricePaisa = faker.number.int({ min: 100, max: 400 }) * 100;
  // লেখক ভেবেছিলেন ছাড় কখনো লাগবে না
  expect(cartTotal([{ qty, pricePaisa }])).toBe(qty * pricePaisa);
});

সর্বোচ্চ ৩ × ৳৪০০ = ৳১২০০, তাই ছাড় কখনো কখনো লাগে: qty 3 (সম্ভাবনা ১/৩) আর দাম ৳৩৩৪–৪০০ (৩০১টির ৬৭টি) হলে। মোট (১/৩) × (৬৭/৩০১) ≈ ০.০৭৪২, প্রতি ৫০ বারে গড়ে প্রায় ৩.৭ বার ফেল। অংশ ৮-এ এটি বারবার চালিয়ে ধরা হবে।

(গ) Test-এর ক্রম আর ভাগ করা অবস্থা

Module-এর স্তরে রাখা একটি cart array, যা ফাইলের সব test দেখে। ফাইলের ক্রমে “খালি cart” আগে, “চাল যোগ” পরে, তাই দুটিই পাস। Vitest-কে ক্রম এলোমেলো করতে বললে (--sequence.shuffle), seed অনুযায়ী ক্রম বদলায়। দশটি seed চালানো হলো; seed 1, 2, 4–8, 10-এ দুটিই পাস, seed 3 আর 9-এ:

$ npx vitest run tests/flaky/order.test.ts --sequence.shuffle --sequence.seed=3 --reporter=verbose
 ✓ tests/flaky/order.test.ts > চাল যোগ করলে ১টি 1ms
 × tests/flaky/order.test.ts > খালি cart-এ ০টি 3ms
   → expected 1 to be +0 // Object.is equality
      Tests  1 failed | 1 passed (2)

বাস্তবে ক্রম বদলায় নতুন test যোগ হলে বা -t দিয়ে একটি test একা চালালে। নিচের block-এ একই ঘটনা একটি ছোট শিক্ষার runner-এ, সাথে সমাধান।

// শিক্ষার মডেল: ছোট একটি test runner, আসল Vitest নয়
function runSuite(label, tests, beforeEach = () => {}) {
  const out = [];
  for (const [name, fn] of tests) {
    beforeEach();
    try { fn(); out.push(`✓ ${name}`); } catch (e) { out.push(`× ${name}: ${e.message}`); }
  }
  console.log(label.padEnd(18), out.join("   "));
}
const expectEq = (got, want) => { if (got !== want) throw new Error(`পেলাম ${got}, চাই ${want}`); };

// ভুল: সব test একই module-level cart ভাগ করে
let cart = [];
const add = (sku) => cart.push(sku);
const A = ["খালি cart = 0", () => expectEq(cart.length, 0)];
const B = ["চাল যোগ = 1", () => { add("RICE-5KG"); expectEq(cart.length, 1); }];

cart = []; runSuite("ক্রম A, B:", [A, B]);
cart = []; runSuite("ক্রম B, A:", [B, A]);
cart = []; runSuite("শুধু A:", [A]);

// ঠিক: প্রতিটি test-এর আগে নতুন cart
const fresh = () => { cart = []; };
runSuite("ঠিক, ক্রম A, B:", [A, B], fresh);
runSuite("ঠিক, ক্রম B, A:", [B, A], fresh);

Mock-এর ইতিহাসও ভাগ করা অবস্থা। Module-এর স্তরে একটি const sendSms = vi.fn(), আর দুটি test প্রতিটিতে একটি order দিয়ে toHaveBeenCalledTimes(1) দেখে। Vitest 5.1.0-এর ডিফল্টে দুটিই পাস করল, কারণ Vitest 5-এ clearMocks ডিফল্টে চালু: প্রতিটি test-এর আগে mock-এর ডাকার ইতিহাস মুছে যায়। একই ফাইল config-এ clearMocks: false দিয়ে (Vitest 4-এর পুরোনো ডিফল্টের মতো) চালালে, সত্যিকারের run:

 ✓ tests/leak2/mockleak.test.ts > প্রথম order-এ একটি SMS 1ms
 × tests/leak2/mockleak.test.ts > দ্বিতীয় order-এ একটি SMS 2ms
   → expected "vi.fn()" to be called 1 times, but got 2 times

অর্থাৎ Vitest-এর version বা config বদলালে একই suite ভিন্ন ফল দেয়। এই পর্বের বাকি সব run Vitest 5-এর ডিফল্ট config-এ (clearMocks চালু)। নিজের প্রজেক্টে মানটি config-এ স্পষ্ট লিখুন, আর মনে রাখুন এটি শুধু ডাকার ইতিহাস মোছে; module-level array বা database-এর সারি নয়।

(ঘ) Async: await ভুলে যাওয়া আর উত্তরের প্রতিযোগিতা

Coupon যাচাইয়ের একটি async ফাংশন আছে, যাতে বাগ: অচেনা কোডে error হওয়ার কথা, কিন্তু চুপচাপ পুরো দাম ফেরত দেয়। তিনটি test, সত্যিকারের run:

test('১. rejects-এ await নেই', () => {
  expect(applyCoupon('FAKE99', 50000)).rejects.toThrow();
});
test('২. then-এর ভেতরে expect, return নেই', () => {
  applyCoupon('EID10', 50000).then((v) => expect(v).toBe(40000));   // ভুল প্রত্যাশা
});
test('৩. পরের একটি নিরীহ test', async () => {
  await new Promise((r) => setTimeout(r, 20));
  expect(1 + 1).toBe(2);
});

 × ১. rejects-এ await নেই 19ms
   → promise resolved "50000" instead of rejecting
   → Promise returned by `expect(actual).rejects.toThrow()` was not awaited. …
 ✓ ২. then-এর ভেতরে expect, return নেই 0ms
 ✓ ৩. পরের একটি নিরীহ test 27ms

⎯⎯⎯⎯ Unhandled Rejection ⎯⎯⎯⎯⎯
AssertionError: expected 45000 to be 40000 // Object.is equality
 ❯ tests/flaky/await.test.ts:8:53
The last test to run before this error was "৩. পরের একটি নিরীহ test".
 Test Files  1 failed (1)
      Tests  1 failed | 2 passed (3)
     Errors  1 error

Vitest 5 প্রথম ভুলটি নিজেই ধরেছে: await ছাড়া .rejects এখন স্পষ্ট বার্তাসহ ফেল। দ্বিতীয়টি ধরেনি। Test ২ সবুজ (০ ms!), কারণ ফাংশন promise ফেরত দেয়নি, তাই Vitest অপেক্ষা করেনি। ভুল expect পরে চলেছে, আর দোষ পড়েছে নির্দোষ test ৩-এর ঘাড়ে। বড় suite-এ লাল দাগ কোন test-এ পড়বে, তা তখন সময়ের ওপর নির্ভর করে। নিয়ম: async কাজ থাকলে test async, প্রতিটি promise-এ await; typescript-eslint-এর no-floating-promises এটি আগেই ধরে।

উত্তরের প্রতিযোগিতা (race condition). খোঁজার ঘরে কেউ “চা” লিখলেন, তারপর “চাল”। দুটি অনুরোধ যায়; যেটি শেষে পৌঁছায়, বাগওয়ালা কোড সেটিই দেখায়। MSW handler-এ ০ থেকে ৪০ ms-এর এলোমেলো দেরি দিয়ে (network-এর মতো), প্রতিটি test ৫০ বার চালানো হলো:

$ npx vitest run tests/flaky/race.test.ts --repeats=49 --reporter=verbose
 × বাগ: 'চা' তারপর 'চাল' লিখলে 'চাল' দেখায় 2380ms (repeat x49)
   → expected 'চা' to be 'চাল' // Object.is equality      (মোট ৬ বার)
 ✓ ঠিক: 'চা' তারপর 'চাল' লিখলে 'চাল' দেখায় 2223ms (repeat x49)
 FAIL … (2nd repeat, 5th repeat, 12th repeat, 24th repeat, 33rd repeat, 48th repeat)

প্রথম run-এ ৫০ বারে ৬ বার, দ্বিতীয়টিতে ৯ বার ফেল। এখানে কোডেই বাগ, ব্যবহারকারীও মাঝে মাঝে ভুল ফল দেখবেন। কোডের সমাধান: নতুন অনুরোধের আগে পুরোনোটি AbortController দিয়ে বাতিল (পর্ব ১৩-এর cleanup-এর ধারণা)। Test-এর সমাধান: এলোমেলো দেরির বদলে নির্দিষ্ট দেরি (প্রথমটি ৩০ ms, দ্বিতীয়টি ০), যাতে বাগ থাকলে প্রতিবার ফেল হয়।

(ঙ) বাইরে বেরিয়ে যাওয়া network

একটি test ডেলিভারি চার্জ জানতে http://127.0.0.1:47782-এ dev API ডাকে, আর এই config-এ MSW নেই। Developer-এর মেশিনে dev server চালু থাকলে, সত্যিকারের run:

== সার্ভার চালু
 ✓ tests/leak/rates.test.ts > ডেলিভারি চার্জ: ঢাকার ভেতরে ৬০ টাকা 26ms
== সার্ভার বন্ধ (যেমন CI-তে)
 × tests/leak/rates.test.ts > ডেলিভারি চার্জ: ঢাকার ভেতরে ৬০ টাকা 19ms
TypeError: fetch failed
Caused by: Error: connect ECONNREFUSED 127.0.0.1:47782

Test আসলে যাচাই করছিল “dev server চালু আছে কি না”, ডেলিভারি চার্জের নিয়ম নয়। সমাধান অংশ ৩-এরটিই: MSW সব test-এ, onUnhandledFrame: 'error'.

(চ) Animation আর আসল সময়ের অপেক্ষা

বাজারঘরের toast “বন্ধ” চাপলে ৯৮০ ms-এর fade-out শেষে DOM থেকে সরে, আর test waitForElementToBeRemoved-এর ডিফল্ট ১০০০ ms সীমায় অপেক্ষা করে; হাতে মাত্র ২০ ms. ফাঁকা মেশিনে ২০ বারে ২০ বারই পাস। তারপর CI-এর ব্যস্ত মেশিনের নকল করতে core-এর সমান সংখ্যক CPU-খাওয়া Node process (নিজের, PID ধরে পরে বন্ধ) চালিয়ে ৫০ বার:

$ npx vitest run tests/flaky/animation.test.tsx -t "ফ্লেকি" --repeats=49 --reporter=verbose
 × ফ্লেকি: আসল ঘড়িতে animation শেষের অপেক্ষা 50472ms (repeat x49)
   → Timed out in waitForElementToBeRemoved.        (৫০ বারে ৫ বার)

$ npx vitest run tests/flaky/animation.test.tsx -t "ঠিক" --repeats=49     # একই চাপের মধ্যে
 ✓ ঠিক: নকল ঘড়ি, সময় নিজে এগিয়ে দেওয়া 154ms (repeat x49)

এগুলো একটি মেশিনের একটি run, সাধারণ ফল নয়; কিন্তু ধরনটি বাস্তব: চাপ বাড়লে timer দেরিতে চলে, আর “প্রায় সমান” দুটি সময়ের প্রতিযোগিতা হেরে যায়। Component test-এ সমাধান নকল ঘড়ি (অংশ ৮)। E2E-তে Playwright-এর page.emulateMedia({ reducedMotion: 'reduce' }) বা animation বন্ধের CSS, আর auto-wait করা assertion (পর্ব ৭৬)। কখনো sleep(1000) নয়।

(ছ) সমান্তরাল test আর একই database সারি

Vitest ডিফল্টে আলাদা ফাইল আলাদা worker process-এ একসাথে চালায়। দুটি ফাইল, stock-a আর stock-b, একই database file-এর একই সারি RICE-5KG ব্যবহার করে: stock ১০ বসায়, একটি reserve করে, আশা করে ৯. প্রতিটি ফাইল ৫০ বার, একসাথে, চারবার চালানো হলো। প্রতিবারই ১০০টি run-এ ১টি ফেল:

$ npx vitest run tests/db --repeats=49 --reporter=verbose
 ✓ tests/db/stock-b.test.ts > b: একটি reserve করলে stock ১০ থেকে ৯ 1539ms (repeat x49)
 × tests/db/stock-a.test.ts > a: একটি reserve করলে stock ১০ থেকে ৯ 1602ms (repeat x49)
   → expected 8 to be 9 // Object.is equality
 FAIL  tests/db/stock-a.test.ts > … (46th repeat)

$ npx vitest run tests/db --repeats=49 --no-file-parallelism
      Tests  2 passed (2)

8 মানে অন্য ফাইলের reserve ঠিক মাঝখানে একই সারিতে পড়েছে। --no-file-parallelism সবুজ করে, কিন্তু সেটি ধীর করে লুকানো। আসল সমাধান: প্রতিটি test নিজের সারি (RICE-5KG- আর একটি randomUUID()), বা পর্ব ৭৫-এর মতো worker-প্রতি database বা rollback হওয়া transaction. নিজের সারির সংস্করণ তিনবার ১০০টি করে run-এ একবারও ফেল করেনি। এটি production-এর আসল race-এরও আয়না: একই stock-এ দুজন ক্রেতা (পর্ব ৪৩)।

৮ · Flaky খোঁজা, quarantine, নকল ঘড়ি আর retry-এর বিপদ

একটি test একবার লাল হলো, আবার চালালে সবুজ। প্রথম কাজ অনুমান নয়, মাপা। Vitest 5-এ --repeats=N প্রতিটি test প্রথমবারের পরে আরও N বার চালায়, তাই --repeats=49 মানে মোট ৫০ বার, একই process-এ, কয়েক সেকেন্ডে। যে flake process-এর বাইরের জিনিসে নির্ভর করে (ফাইলের সমান্তরালতা, port, TZ), তার জন্য shell-এর loop, যেমন for i in $(seq 50); do npx vitest run tests/x.test.ts || echo FAIL $i; done. Playwright-এর সমতুল্য --repeat-each (পর্ব ৭৬)। নিচে অংশ ৭(খ)-এর test খোঁজা থেকে সারানো পর্যন্ত:

✓ ফ্লেকি: seed ছাড়া এলোমেলো দাম 1ms
Tests  1 passed (1)

run ১: ফেল 3rd, 13th, 29th, 40th repeat → 4/50
run ২: ফেল 27th, 29th, 36th, 46th       → 4/50
run ৩: ফেল 26th, 34th, 43rd, 44th       → 4/50

expected 106305 to be 111900
111900 > 100000 → ৫% ছাড় লেগেছে
111900 × 0.95 = 106305

ছাড় লাগে শুধু qty = 3 আর দাম ৳৩৩৪–৪০০ হলে
P = (1/3) × (67/301) ≈ 0.0742
৫০ বারে প্রত্যাশা ≈ 3.7  ↔  দেখা গেল 4, 4, 4

beforeEach(() => faker.seed(77))
✓ সীমার ঠিক নিচে: ৳১০০০-এ ছাড় নেই   100000 → 100000
✓ সীমার ঠিক ওপরে: ৳১০০১-এ ৫% ছাড়    100100 → 95095
(repeat x49) Tests passed

✓ ফ্লেকি: seed ছাড়া এলোমেলো দাম (repeat x49)
status: "passed"
failureMessages: ["AssertionError: expected 102600 to be 108000 …"]

কত বার চালাবেন? একটি test প্রতি run-এ স্বাধীনভাবে p সম্ভাবনায় ফেল করলে n বারে অন্তত একবার ফেল দেখার সম্ভাবনা 1 − (1 − p)ⁿ. p = 0.0742, n = 50 হলে প্রায় ০.৯৮. কিন্তু p = 0.01 হলে ৫০ বারে মাত্র প্রায় ৩৯.৫%; ৯৫% নিশ্চয়তায় n ≥ ln(0.05) / ln(0.99) ≈ ২৯৮.১, অর্থাৎ ২৯৯ বার। উল্টো দিকে, ২০০টি test-এর প্রতিটি ০.৫% flaky হলে পুরো run সবুজ হওয়ার সম্ভাবনা 0.995²⁰⁰ ≈ ০.৩৬৭: প্রায় দুই-তৃতীয়াংশ CI run লাল, যদিও আলাদা করে প্রতিটি test “প্রায় নির্ভরযোগ্য”।

নকল ঘড়ি। সময়ের ওপর নির্ভর করা কোডের জন্য Vitest-এ vi.useFakeTimers() আর vi.setSystemTime() (পর্ব ৭৩-এ এর ভিত্তি)। নকল ঘড়ি চালু থাকলে Date আর setTimeout আপনার কথামতো চলে: সময় এগোয় শুধু যখন আপনি vi.advanceTimersByTime বলেন। ল্যাবের দুটি test এভাবে:

afterEach(() => vi.useRealTimers());

test('ঘড়ি স্থির: delivery আগামীকাল', () => {
  vi.useFakeTimers();
  vi.setSystemTime(new Date('2026-11-03T17:59:00Z'));   // ঢাকায় রাত ১১:৫৯
  expect(deliveryLabel(new Date('2026-11-04T17:59:00Z'))).toBe('আগামীকাল');
});

test('ঠিক: নকল ঘড়ি, সময় নিজে এগিয়ে দেওয়া', () => {
  vi.useFakeTimers();
  render(<Toast />);
  fireEvent.click(screen.getByText('বন্ধ'));
  act(() => vi.advanceTimersByTime(980));
  expect(screen.queryByRole('status')).toBeNull();
});

প্রথম test-এ সময় ইচ্ছা করে ঢাকার মাঝরাতের এক মিনিট আগে, কারণ বাগ সেখানেই লুকায়। দ্বিতীয়টি CPU-র চাপেও ৫০ বারে ৫০ বার পাস করেছে (অংশ ৭(চ))। afterEach-এ আসল ঘড়ি ফেরানো জরুরি, নইলে নকল ঘড়ি পরের test-এ ঢুকে নতুন flake বানাবে। নকল ঘড়ির সাথে findBy… বা MSW-এর delay মেশালে সাবধান; তারাও timer ব্যবহার করে।

Quarantine, তারপর সারানো। আজই সারানোর সময় না থাকলে flake-টি মূল suite থেকে আলাদা করুন, যেমন *.quarantine.test.ts নামে, যা মূল config-এর exclude-এ আর একটি আলাদা job-এ চলে। শর্ত: প্রতিটির issue আর মালিক, একটি সময়সীমা (ধরুন দুই সপ্তাহ), আর তারপর সারানো বা মুছে ফেলার স্পষ্ট সিদ্ধান্ত। CI-তে এর ব্যবস্থা পর্ব ৮১-এ।

৯ · Contract test — mock-কে সৎ রাখা, আর একটি চেকলিস্ট

প্রতিটি mock একটি দাবি: “বাইরের সেবা এভাবে উত্তর দেয়”। ছয় মাস পরে সেবাটি একটি field-এর নাম বদলাল, আর আপনার MSW handler এখনো পুরোনো আকার দেখায়। সব test সবুজ, production লাল।

এর উত্তর consumer-driven contract test. ধরুন বাজারঘরের frontend (consumer) আর backend (provider) দুটি আলাদা দল বানায়। Consumer-এর test চলার সময় একটি চুক্তির ফাইল লেখা হয়: “আমি GET /api/products চাই, আর উত্তরে প্রতিটি পণ্যে id, name আর পূর্ণসংখ্যার pricePaisa লাগবে”। Provider-এর দিকে সেই একই ফাইল আসল server-এর বিরুদ্ধে চালানো হয়। Provider যদি pricePaisa সরিয়ে price করে, তাহলে provider-এর CI ভাঙে, deploy-এর আগেই। এভাবে consumer-এর mock আর provider-এর আসল আচরণ একই চুক্তিতে বাঁধা থাকে।

লক্ষ করুন, কোর্সের আগের contract test শব্দটির অর্থ আলাদা: একই test একটি interface-এর সব বাস্তবায়নে চালানো। লক্ষ্য একই, নকল আর আসল যেন আলাদা না হয়ে যায়।

Mock আর test data-র চেকলিস্ট

• নিজের database, repository আর service আসল চলে; নকল শুধু বাইরের, ধীর বা অনিশ্চিত জিনিসের
• MSW-এর setup সব test-এ, onUnhandledFrame: 'error', আর প্রতিটি test-এর পরে resetHandlers
• সফল, 4xx/5xx, ধীর আর network ভাঙা, চারটি পথেরই অন্তত একটি test
• Handler-এর উত্তর factory থেকে, আর schema বা চুক্তির সাথে মেলানো
• প্রতিটি test নিজের ডেটা বানায়, শুধু জরুরি ঘর override করে; বড় ভাগ করা fixture নেই
• এলোমেলো ডেটায় seed, ফেলের বার্তায় seed ছাপা, faker-এর version lock-এ
• Time zone স্পষ্ট, “আজ”-এর হিসাবে vi.setSystemTime, শেষে vi.useRealTimers
• প্রতিটি promise-এ await, lint-এ floating promise ধরা
• সমান্তরাল test আলাদা সারি বা আলাদা database-এ
• সন্দেহজনক test --repeats বা --sequence.shuffle দিয়ে মাপা; flake quarantine-এ issue আর সময়সীমাসহ, retry দিয়ে ঢাকা নয়

১০ · AI-এর যুগে mock আর test data

AI-এর লেখা test প্রায় সবসময় পাস করে, কারণ সে প্রায়ই কোডের বর্তমান আচরণ দেখে প্রত্যাশা লেখে, আর কঠিন জায়গায় mock বসায়। এই পর্বের ল্যাবেই জ্যান্ত উদাহরণ পেলেন: MSW 2-এর onUnhandledRequest, যা version 3-এ নীরবে উপেক্ষিত।

AI-এর লেখা test মেলানোর চেকলিস্ট

• package.json-এর version-এর সাথে import আর option মিলিয়েছি (MSW 3, Vitest 5)
• কোডে একটি বাগ ইচ্ছা করে ঢুকিয়ে দেখেছি, test লাল হয়েছে
• নিজের database বা repository-র কোনো mock নেই
• --repeats=49, --sequence.shuffle আর TZ=UTC-তে সবুজ
• Handler নেই এমন একটি অনুরোধে test স্পষ্ট বার্তায় ফেল করে
• Diff-এ কোনো আসল key, আসল ফোন নম্বর বা গ্রাহকের তথ্য নেই