ioc-container-js v0.0.2

DI Container

A simple and lightweight DI container for JavaScript.

Major features

• Resolving from instance
• Resolving from factory
• Resolving from constructor
• Singletons
• Hierarchical containers
• Recursive dependency resolution

Examples

Register/Resolve instance

function MyClass() {}
var instance = new MyClass();
var container = new Container();

container.registerInstance('my-class', instance);
container.resolve('my-class');

Register/Resolve factory

function MyClass() {}
var container = new Container();
var factory = function(container) { return new MyClass(); };

container.registerFactory('my-class', factory);
container.resolve('my-class');

Register/Resolve type

function MyClass() {}
var container = new Container();

container.registerType('my-class', MyClass);
container.resolve('my-class');

Register/Resolve singleton with factory

function MyClass() {}
var container = new Container();
var factory = function(container) { return new MyClass(); };

container.registerFactory('my-class', factory, Container.Singleton);
container.resolve('my-class');

Register/Resolve singleton with type

function MyClass() {}
var container = new Container();

container.registerType('my-class', MyClass, Container.Singleton);
container.resolve('my-class');

Hierarchical containers

function ClassA() {}
function ClassB() {}

var parent = new Container();
parent.registerType('a-class', ClassA);

var child = parent.createChild();
child.registerType('b-class', ClassB);

var a = child.resolve('a-class');
var b = child.resolve('b-class');

parent.resolve('b-class'); // <-- throws error

Recursive resolution

function Service() {}

function Client(svc) {}
Client.$imports = ['service'];

function ClientOfClient(client) {}
ClientOfClient.$imports = ['client'];

var container = new Container();

container.registerType('service', Service);
container.registerType('client', Client);
container.registerType('client-of-client', ClientOfClient);

var clientOfClient = container.resolve('client-of-client');