Skip to content
Sarj Sarj Sarj Standards

no-first-party-module-mock

Prefer injected collaborators over mocking maintained first-party modules in tests.

noFirstPartyModuleMock Rule source Tests Catalog JSON

Why

Replacing an owned module couples tests to its lookup path and can verify mock wiring while bypassing the real implementation contract.

Fix

Extract a narrow port or pure core operation and inject a typed fake; retain module mocking only when module lookup or bootstrap behavior is the contract.

Examples

Before — flagged Do not replace an owned module
action.test.ts
import { vi } from "vitest";
vi.mock("./service", () => ({ run: vi.fn() }));
After — preferred Inject a narrow service port
action.test.ts
const result = await runAction({ service: recordingService });

Options

{
  "additionalProperties": false,
  "properties": {
    "additionalModulePrefixes": {
      "items": { "minLength": 1, "type": "string" },
      "type": "array",
      "uniqueItems": true
    }
  },
  "type": "object"
}