Sinon — راقب وبدّل السلوك

Sinon مش runner

Sinon مكتبة test doubles. تركبها غالبًا جنب Mocha + Chai، لكن تقدر تستخدمها مع أي runner. Jest وVitest عندهم بدائل مدمجة (jest.fn وvi.fn)، فإضافة Sinon ليهم محتاجة سبب واضح.

Fake وSpy وStub

const send = sinon.fake.resolves({ id: 7 });

const spy = sinon.spy(logger, "info");

الـ stub يستبدل behavior: يرجّع قيمة، يرمي error، أو يتصرف بشكل مختلف كل call. الأصل مش بيتنفذ.

const stub = sinon.stub(gateway, "charge");stub.onFirstCall().rejects(new Error("timeout"));stub.onSecondCall().resolves({ ok: true });

اختبر error path

import { expect } from "chai";import sinon from "sinon";import { checkout } from "../src/checkout.js";describe("checkout", () => {  afterEach(() => sinon.restore());  it("يرجع رسالة مفهومة لو الدفع وقع", async () => {    sinon.stub(gateway, "charge").rejects(new Error("timeout"));    const result = await checkout(gateway);    expect(result).to.deep.equal({ ok: false, reason: "payment-unavailable" });    sinon.assert.calledOnce(gateway.charge);  });});

الـ sandbox ينضّف وراك

لو عندك doubles كتير، sandbox تجمعهم:

const sandbox = sinon.createSandbox();afterEach(() => sandbox.restore());it("يبعت event", () => {  const publish = sandbox.stub(bus, "publish").resolves();  // شغّل السلوك  sinon.assert.calledWith(publish, "order.created");});

إمتى بلاش stub؟

لو تقدر تمرّر dependency كدالة عادية، fake مستقلة أبسط من ترقيع module عالمي:

const sendEmail = sinon.fake.resolves();await registerUser({ email: "a@b.com" }, { sendEmail });sinon.assert.calledOnce(sendEmail);

ده كمان يحسن تصميم production: dependency واضحة بدل import مخفي.

خلّصت الفصل لما

• تعرف إن spy يراقب والأصل ممكن يشتغل
• تعرف إن stub يستبدل السلوك
• تبدأ بـ fake بسيطة للكود الجديد لما تكفي
• تعمل restore بعد كل test