SimpleDi

SimpleDi is a very simple dependency injector.

There's also an async version available: p7s1digital/scorpion

Features

• Simple API
• Fully tested
• Tiny (1.3kb gzipped)
• Works in any ES3 compliant environment
• Helps you find unresolved dependencies with getResolvedDependencyCount
• Battle-tested (used in real-world projects)

Installation

npm install simpledi

Compatibility

SimpleDi is compatible with ES3 compliant browsers

Api

di.register(dependencyName, factoryFunction[, dependencies[, overwrite]])

Parameters:

Name	Type	Description
dependencyName	string	The name of the dependency
factoryFunction	function	A function that gets called when get is called
dependencies	array<string>	optional An array of depdendency names
overwrite	boolean	optional This allows to explicitly overwrite dependencies

Adds a dependency to the registry. It throws an exception when a dependency with the same name already exists and overwrite true is not passed.

di.registerBulk(dependencies)

Parameters:

Name	Type	Description
dependencies	array	An array of dependencies containing arrays each containing parameters for di.register

Example:

di.registerBulk([
    ['foo', this.always({foo: true})],
    ['Bar', this.withNew(Bar), ['foo']],
]);

di.get(name[, arg1[, arg2[, ...]]])

Parameters:

Name	Type	Description
dependencyName	string	The name of the dependency
arg1, arg2, ...	mixed	All args defined after the name will also be injected

Returns a previously registered dependency and resolves all dependencies.

di.getResolvedDependencyCount()

Returns an object with numbers that state how often each dependency got resolved.

 
// Example return value
{ Foo: 1, Bar: 1, Baz: 1 }
 

Built-in factory functions

SimpleDi.always(objectOrFunction)

Name	Type	Description
objectOrFunction	mixed	Always returns this argument

A factory function that always returns the first argument when di.get is called.

SimpleDi.withNew(Constructor)

Name	Type	Description
Constructor	function	A constructor function

When di.get is called this factory function will initialize the given constructor with new.

SimpleDi.withNewOnce(Constructor)

Name	Type	Description
Constructor	function	A constructor function

When di.get is called the first time this factory function will initialize the given constructor and for all upcoming calls it will always return the same instance. You can think of it as a singleton factory.

SimpleDi.once(factory)

Name	Type	Description
factory	function	A factory function

When di.get is called the first time this factory function will call the given factory and for all upcoming calls it will always return the same factory return value. You can think of it as a singleton factory.

Example 1

var SimpleDi = require('simpledi');
var di = new SimpleDi();
 
function Engine(config) {
    this.hp = config.hp;
    this.maxSpeed = config.maxSpeed;
}
 
function Car(engine) {
    this.text = 'This car has ' + engine.hp + 'hp!';
}
 
di.register('Engine', SimpleDi.withNew(Engine), ['engineConfig']);
di.register('engineConfig', SimpleDi.always({
    hp: 120,
    maxSpeed: 200
}));
di.register('Car', SimpleDi.withNew(Car), ['Engine']);
 
var car = di.get('Car');
 
console.log(car.text);

Example: Circular Dependency

di.register('foo', SimpleDi.always({
    foo: true
}), ['bar']);
 
di.register('bar', SimpleDi.always({
    bar: true
}), ['foo']);
 
di.get('foo'); // throws "Circular Dependency detected: foo => bar => foo"

License

The MIT License (MIT)

Copyright (c) 2015 Julian Hollmann

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.