This package requires ES5 and promises.
We strongly recommend to use jakearchibald/es6-promise
Install Scorpion with npm: npm install scorpion.
import Scorpion from 'scorpion';
const di = new Scorpion();
// register an object
di.register('myConfig', Scorpion.always({
test: true
}));
// get registered module
di.get('myConfig').then((myConfig) => {
// do something
});Register a module with dependencies.
di.register('foo', ['bar'], (bar) => {
return {};
});Register a module without dependencies.
di.register('foo', () => {
return {};
});This method just works like register but won't throw when a module with the same name already exists.
get returns a promise which will be resolved once all dependencies are resolved.
di.get('foo').then((foo) => {
// do something with foo
});getAll returns a promise which will be resolved once all requested modules and dependencies are resolved.
di.getAll(['foo', 'bar']).then((modules) => {
modules[0] // foo
modules[1] // bar
});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 |
|---|---|---|
| objectOrFunction | mixed |
Invokes this function once |
Invokes the passed factory once and will then always return the same return value.
| 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.
import Scorpion from 'scorpion';
const di = new Scorpion();
// register an object
di.register('myConfig', Scorpion.always({
test: true
}));
// register a class
class MyClass {
constructor(myConfig) {
}
}
di.register('MyClass', ['myConfig'], Scorpion.withNew(MyClass));
// register an async factory
di.register('asyncModule', () => {
return new Promise((resolve) => {
// do some async tasks then resolve
resolve({
asyncModule: true
});
});
});
// get registered modules
di.get('myConfig').then((myConfig) => {
// do something
});
di.get('MyClass').then((myClassInstance) => {
// do something
});
di.get('asyncModule').then((asyncModule) => {
// do something
});The MIT License (MIT)
Copyright (c) 2015 ProSiebenSat.1 Digital GmbH
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.