Modification of proxyquire to work with webpack aliases. Proxies commonjs require/es6 import in order to allow overriding dependencies during testing.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

proxyquire-webpack-alias Build Status


Modification of proxyquire to work with webpack aliases. Proxies commonjs require/es6 import in order to allow overriding dependencies during testing. Just hides some webpack magic inside.

Proxyquire-webpack-alias has evolved into rewiremock. If you are looking for a better mocking library, not the way to fix proxyquire - you should try it.


import proxyquire, { configure } from 'proxyquire-webpack-alias';

configure('your-own-webpack-alias.conf');// optional

    .load('alias/fileName', { 'alias/dep1':{} });
// you can use webpack-aliased filenames both as module name and stub name.

Now, at last, you can use aliases as names of deps to be mocked. So you can use old proxyquire in more modern way.

the other way:

If you prefer using original proxyquire - have a look in resolveQuire. It is pure functional sugar around it, and enables same features as proxyquire-webpack-alias.

proxyquire - 2

This library uses proxyquire-2, a bit more powerfull fork of original one. For details about proxyquire-2 API – see proxyquire documentation. It is just extends functionality, 100% compatible with old one.


From some point of view - you should stop using proxyquire. The better ways were invented. Including rewiremock.


  • configire(webpack.alias.conf) allows you to overwrite location of webpack.aliases configuration file. By default one will try to find 'webpack.config.js' or 'webpack.config.babel.js' in project root.
  • defaultExport - functional class, similar to Proxyquire.

Alias behavior similar to babel-plugin-webpack-alias. As long we take some sources from it.

Using proxyquire

So you have one file. You use webpack alises and address other files using them.

import something from 'something';
import somethingElse from 'core/something';
import somethingMore from 'components/something';

And then you want to mock deps with proxyquire. But you cant.

You have to mock relative imports. And each time you have to guess the right name.

const mocked = proxyquire('source.js',{
  'something': mock,
  '../../core/something': mock, // will not work, the right path is '../../../core....'
  'shared/something': something

So, this lets fix this issue.

//import proxyquire from 'proxyquire';
import proxyquire from 'proxyquire-webpack-alias'; 

// now, you can mock files as you import them.
const mocked = proxyquire('source.js',{
  'something': mock,
  'core/something': mock, 
  'components/something': something

// and, finnaly you can be sure, that you do something RIGHT.

// next example will trigger error
const mocked = proxyquire.noUnusedStubs().load('source.js',{
  'something': mock,
  'core/something': mock, 
  'component/something': something,// <-- typo. And stub will be unsued.

Your own setup

If you want to extend proxyquire, for example to setup it as you want, and use it indirectly - you have to add some magic

// so you are using special version of proxyquire
import proxyquire from 'my-proxyquire';

Where my-proxyquire.js is your file

import proxyquire from 'proxyquire-webpack-alias';

// this one creates `special` proxyquire for the file it use
const myProxyquire = 
    (new proxyquire.Class(module.parent))
     // now you can setup default behavior     

// and this prevent caching. So in new place you will get new class
delete require.cache[require.resolve(__filename)];

export default myProxyquire;

PS: This is not wrapper around proxyquire, this is wrapper around proxyquire-2.