Library for injecting fake/mocked dependencies in tests
HijackDI provides a way of mocking, faking or stubbing external dependencies that are loaded via require() in nodejs.
HijackDI provides a sandbox environment for you to run your tests within. In this environment node modules or classes which are required are switched with your fakes or mocks. This works at any level, not just at the subject meaning HikackDI is perfect for integration or unit testing.
See the examples folder for more.
The easiest way to install is through the Node Package Manager (NPM)
npm install hijackdi
If we have the following class...
var bob = require'bob'jimmy = require'./jimmy.js';varreturn bob + ' ' +jimmy;;moduleexports = MyClass;
...we could mock, stub or fake out the require(s) using HijackDI. The test below demonstrates how this is done.
require'chai'should;var Hijackdi = require'hijackdi';var hijackdi = 'MyClass.js'stubs =return 'hello';return 'world';;test'a test'hijackdisandboxstubsvar myClass = ;myClassdoshouldequal'hello world';;;
The hijack object created has a sandbox method that takes an object literal containing the external dependencies that you wish to replace. The function supplied in this method is the code executed whilst the dependencies are replaced. After execution of this function the mocked/stubbed/faked dependencies are removed.
var HijackDi = require'hijackdi';/*This constructs a hijackdi object with a subject. The subject will havethe dependencies you specify switched for your mocks. Any otherdependencies will remain intact.*/var hijackdi = '../lib/MySubjectClass.js';/*definition of the fake dependencies. These will replace the real objectin the sanbox environment. To fake out your own objects the key should be therelative path from the test file. For a node_module just use the module name.*/fakes =return 'hello';'redis' : return fakeRedisClient;;/*Within the sanbox mode redis and ../lib/someDependency.js are switche out.Any other subdependency will be intact. If another subdependen ALSO required redis,it will get our fake too.*/hijackdisandboxfakesvar mySubjectClass = MySubjectClass; //with our fake subdependenciesvar redis = require'redis'; // fake redis (why are you requiring here??);