container-ts

Lightweight decorator-based Dependency Injection container for Typescript and ES7.

Features

• Dependency Injection via ES6 Decorators
• Container lifecycle management

API

Container {
    add(item: any): void;
    add(item: any, name: string): void;
    get(ctor: Function): any;
    get(name: string): any;
    has(ctor: Function): any;
    has(name: string): any;
    init(): void;
    destroy(): void;
}
 
class ContainerBuilder {
    static create(): Container;
}
 
// decorators
@Inject(selector: () => any | string)
@Destroy
@PostConstruct

Usage

import {ContainerBuilder, Container, Inject, PostConstruct, Destroy} from './container';
 
@InjectConstructor('ctorDependency1', 'ctorDependency2')
MainClass {
 
    @Inject('elementId')  // injection by id
    dependency1 : DependencyClass1;
 
    @Inject(() => DependencyClass2)  // injection by type
    dependency2 : DependencyClass2;
 
    constructor(a : CtorDependency1, b : CtorDependency2) {
        // ...
    }
 
    @PostConstruct // invoked after all injections have been resolved
    init() {
        console.log(dependency1.sayHello());
    }
 
    @Destroy
    destroy() {
        console.log('destroy');
    }
}
 
let container = ContainerBuilder.create();
 
container.add(new MainClass());
container.add(new DependencyClass1(), 'elementId');
container.add(new DependencyClass2());
 
container.add(new CtorDependency1(), 'ctorDependency1');
container.add(new CtorDependency2(), 'ctorDependency2');
 
container.get('elementId'); // returns the instance of DependencyClass1 added as 'elementId'
 
container.get(DependencyClass2); // returns the DependencyClass2 instance
 
container.init();  // output: "Hello!
 
container.destroy(); // output: "destroy"