Generate mocks, stubs, spies, and fakes for dependency isolation.
Use when creating mocks, stubs, or test isolation fixtures.
Trigger with phrases like "generate mocks", "create test doubles", or "setup stubs".
Generate mocks, stubs, spies, and fakes to isolate units under test from external dependencies. Supports Jest mocks, Sinon.js stubs, Python unittest.mock, Go interfaces, and testdouble.js patterns.
Prerequisites
Testing framework installed (Jest, Vitest, Mocha, pytest, JUnit 5, or Go testing)
Mocking library available (Sinon.js, testdouble.js, unittest.mock, Mockito, or gomock)
TypeScript strict mode enabled for type-safe mocks (if applicable)
Source code with clear interface or class boundaries for dependency injection
Instructions
Scan the codebase with Glob and Grep to identify modules with external dependencies (database clients, HTTP clients, file system access, third-party SDKs).
Read each module under test and catalog its dependency interfaces -- list every method signature, return type, and side effect.
Determine the appropriate test double type for each dependency:
Stub: Returns canned data, no behavior verification (use for database queries returning fixed datasets).
Mock: Verifies interactions -- call count, argument matching, call order (use for email senders, event emitters).
Spy: Wraps real implementation while recording calls (use when partial behavior is needed).
Fake: Lightweight working implementation (use for in-memory repositories replacing real databases).
Generate test double files following the project's existing test directory structure (e.g., __mocks__/, , ).
test/doubles/
testutil/
For each test double, implement:
Factory function or class matching the dependency interface exactly.
Configurable return values via builder pattern or method chaining.
Call recording for assertion (arguments, call count, call order).
Reset/restore mechanism for cleanup between tests.
Wire test doubles into existing test files using the framework's dependency injection pattern (jest.mock(), @patch, constructor injection, or Go interface substitution).
Validate all test doubles compile and pass type checks by running tsc --noEmit or equivalent.
Output
Test double source files (one per dependency) placed in the project's mock directory
Factory functions with TypeScript generics or equivalent type safety
Jest __mocks__ auto-mock modules where applicable
Updated test files wired to use generated doubles instead of real dependencies
Summary listing each double, its type (mock/stub/spy/fake), and the interface it replaces
Error Handling
Error
Cause
Solution
TypeError: X is not a function
Mock missing a method from the real interface
Regenerate the double from the current interface definition; add the missing method
Mock leaking between tests
Shared mock state not reset in afterEach
Add jest.restoreAllMocks() or sinon.restore() in teardown hooks
Type mismatch on mock return value
Return type does not match interface contract
Use as ReturnType<typeof fn> or update the mock factory to return the correct type
Spy not recording calls
Spy created after the function was already bound
Create spies before the module under test imports the dependency
Over-mocking hides real bugs
Too many layers replaced with fakes
Limit mocks to true external boundaries (I/O, network); let pure logic run unmocked