Stub out module function

Edit: Being a little bit more precise.

I want to test usecases for a Github API wrapper extension, that our team has created. For testing, we don’t want to use API wrapper extension directly, so we want to stub out its functions. All calls to the API wrapper should be stubbed out for the tests, not just creating a clone stub.

  • Uncaught TypeError: fs.createWriteStream is not a function
  • AWS lambda read parameter or outputs from CloudFormation
  • grunt uglify task failing
  • Express - Send a page AND custom data to the browser in a single request?
  • How to deploy a production meteor server in 2015?
  • Why is ElasticSearch match query returning all results?
  • I have a module “github” in Node.js:

    module.exports = function(args, done) {
        ...
    }
    

    And I am requiring it like this:

    var github = require('../services/github');
    

    Now, I would like to stub out github(...) using Sinon.js:

    var stub_github = sinon.stub(???, "github", function (args, callback) { 
        console.log("the github(...) call was stubbed out!!");
    });
    

    But sinon.stub(...) expects from me to pass an object and a method and does not allow me to stub out a module that is a function.

    Any ideas?

  • Globally set node_modules location for project
  • Design pattern for many asynchronous tasks in node
  • Cross compiling NodeJS for Windows CE on ARMv11
  • How to install babel and using ES6 locally on Browser?
  • hazelcast client module for node.js
  • Get 'spawn cmd ENOENT' when try to build Cordova application (event.js:85)
  • 4 Solutions collect form web for “Stub out module function”

    There might be a way to accomplish this in pure Sinon, but I suspect it would be pretty hacky. However, proxyquire is a node library that is designed for solving these sort of issues.

    Supposing you want to test some module foo that makes use of the github module; you’d write something like:

    var proxyquire = require("proxyquire");
    var foo = proxyquire(".foo", {"./github", myFakeGithubStub});
    

    where myFakeGithubStub can be anything; a complete stub, or the actual implementation with a few tweaks, etc.

    If, in the above example, myFakeGithubStub has a property “@global” set as true, (i.e. by executing myFakeGithubStub["@global"] = true) then the github module will be replaced with the stub not only in the foo module itself, but in any module that the foo module requires. However, as stated in the proxyquire documentation on the global option, generally speaking this feature is a sign of poorly designed unit tests and should be avoided.

    I found that this worked for me…

    const sinon          = require( 'sinon' );
    const moduleFunction = require( 'moduleFunction' );
    
    //    Required modules get added require.cache. 
    //    The property name of the object containing the module in require.cache is 
    //    the fully qualified path of the module e.g. '/Users/Bill/project/node_modules/moduleFunction/index.js'
    //    You can get the fully qualified path of a module from require.resolve
    //    The reference to the module itself is the exports property
    
    const stubbedModule = sinon.stub( require.cache[ require.resolve( 'moduleFunction' ) ], 'exports', () => {
    
        //    this function will replace the module
    
        return 'I\'m stubbed!';
    });
    
    // sidenote - stubbedModule.default references the original module...
    

    You have to make sure that you stub the module (as above) before it’s required elsewhere…

    // elsewhere...
    
    const moduleFunction = require( 'moduleFunction' ); 
    
    moduleFunction();    // returns 'I'm stubbed!'
    

    Simplest solution is to refactor your module:

    instead of this:

    module.exports = function(args, done) {
        ...
    }
    

    do this:

    module.exports = function(){
        return module.exports.github.apply(this, arguments);
    };
    module.exports.github = github;
    
    function github(args, done) {
        ...
    }
    

    Now you can require it with:

    const github = require('../services/github.js');
    //or
    const github = require('../services/github.js').github;
    

    To stub:

    const github = require('../services/github.js');
    let githubStub = sinon.stub(github, 'github', function () {
        ... 
    });
    

    If you are doing

    var github = require('../services/github');

    in global scope, then you can using ‘global’ as the object and ‘github’ as the method to be stubbed out.

    var stub_github = sinon.stub(global, "github", function (args, callback) { 
        console.log("the github(...) call was stubbed out!!");
    });
    
    Node.js is the Best Javascript runtime in the world.