Wondering what’s next for npm?Check out our public roadmap! »

    TypeScript icon, indicating that this package has built-in type declarations

    1.0.11 • Public • Published

    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.


    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.


    • 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.


    npm i proxyquire-webpack-alias

    DownloadsWeekly Downloads






    Last publish


    • avatar