thlorenz/proxyquire

Health v2 · maintenance only

Adoption not part of the score

2745 stars · 102 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Node.js library that proxies the require function so dependencies can be overridden with stubs or mocks during testing without modifying the code under test. It is mocking-framework agnostic and lets non-overridden methods behave like the original.

Use cases

• stub node modules in unit tests
• override dependencies without changing production code
• mock require calls in javascript tests
• inject test doubles into nodejs modules
• partially mock a module while keeping other methods real
• prevent call-thru to original dependencies during tests

When to choose

• you test CommonJS Node.js code that uses require and want unobtrusive dependency stubbing
• you want to use your existing mocking/stubbing library with require overrides
• you need to stub only some methods of a dependency and leave the rest intact

When to avoid

• you write ES modules with import statements instead of CommonJS require
• you use a bundler-based test setup (browser/client code) rather than Node.js
• you prefer modern test runners with built-in module mocking

Facets

library · maturity maintenance

mocking testing testing developer-tools backend dependency-injection stubbing require-proxy unit-testing mock-framework-agnostic nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="thlorenz/proxyquire")