SimpleDi is a very simple dependency injector.
- 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)
npm install simpledi
SimpleDi is compatible with ES3 compliant browsers
| 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.
| Name | Type | Description |
|---|---|---|
| dependencies | array |
An array of dependencies containing arrays each containing parameters for di.register |
di.registerBulk([
['foo', this.always({foo: true})],
['Bar', this.withNew(Bar), ['foo']],
]);| 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.
Returns an object with numbers that state how often each dependency got resolved.
// Example return value
{ Foo: 1, Bar: 1, Baz: 1 }| Name | Type | Description |
|---|---|---|
| objectOrFunction | mixed |
Always returns this argument |
A factory function that always returns the first argument when di.get is called.
| Name | Type | Description |
|---|---|---|
| Constructor | function |
A constructor function |
When di.get is called this factory function will initialize the given constructor with new.
| 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.
| 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.
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);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"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.