injection-js
    TypeScript icon, indicating that this package has built-in type declarations

    2.4.0 • Public • Published

    Build Status Downloads

    Dependency Injection

    Dependency injection library for JavaScript and TypeScript in 5.2K. It is an extraction of the Angular's dependency injection which means that it's feature complete, fast, reliable and well tested.

    Why not Angular version 5 and above?

    Angular version 5 deprecated the ReflectiveInjector API and introduced StaticInjector. In short, the dependency injection in the newest versions of Angular will happen entirely compile-time so reflection will not be necessary.

    However, if you want to use dependency injection in your Node.js, Vue, React, Vanilla JS, TypeScript, etc. application you won't be able to take advantage of StaticInjector the way that Angular will because your application won't be compatible with Angular compiler.

    This means that if you need dependency injection outside of Angular @angular/core is not an option. In such case, use injection-js for fast, small, reliable, high-quality, well designed and well tested solution.

    How to use?

    $ npm i injection-js
    # OR 
    $ yarn add injection-js

    Note:

    For ES5 Class syntax and TypeScript you need a polyfill for the Reflect API. You can use:

    Also for TypeScript you will need to enable experimentalDecorators and emitDecoratorMetadata flags within your tsconfig.json

    TypeScript

    import 'reflect-metadata';
    import { ReflectiveInjector, Injectable, Injector } from 'injection-js';
     
    class Http {}
     
    @Injectable()
    class Service {
      constructor(private http: Http) {}
    }
     
    @Injectable()
    class Service2 {
      constructor(private injector: Injector) {}
     
      getService(): void {
        console.log(this.injector.get(Service) instanceof Service);
      }
     
      createChildInjector(): void {
        const childInjector = ReflectiveInjector.resolveAndCreate([Service], this.injector);
      }
    }
     
    const injector = ReflectiveInjector.resolveAndCreate([Service, Http]);
     
    console.log(injector.get(Service) instanceof Service);

    ES6

    const { Inject, ReflectiveInjector } = require('injection-js');
     
    class Http {}
     
    class Service {
      static get parameters() {
        return [new Inject(Http)];
      }
     
      constructor(http) {
        this.http = http;
      }
    }
     
    const injector = ReflectiveInjector.resolveAndCreate([Http, Service]);
     
    console.log(injector.get(Service) instanceof Service);

    ES5

    require('reflect-metadata');
    var di = require('injection-js');
     
    var Http = di.Class({
      constructor: function() {},
    });
     
    var Service = di.Class({
      constructor: [
        Http,
        function(http) {
          this.http = http;
        },
      ],
    });
     
    var injector = di.ReflectiveInjector.resolveAndCreate([Http, Service]);
     
    console.log(injector.get(Service) instanceof Service);

    API

    For full documentation check Angular DI docs:

    Ecosystem

    This is a list of libraries that are using injection-js. If you have a suggestion on what to add, please don't hesitate to submit a PR.

    Libraries

    • ng-packagr Transpile your libraries to Angular Package Format. Part of the official Angular CLI.
    • @martin_hotell/axios-http Injectable axios HttpClient wrapper for browser and node
    • @martin_hotell/rea-di Dependency injection for React done right. Hierarchical injection on both component and service layer powered by injection-js (Angular DI framework) 🖖
    • rxstack RxStack is a realtime object-oriented framework which helps you build a micro service web applications on top of other frameworks like express and socketio by adding an abstraction layer.
    • ServeRX-ts Experimental Node.js HTTP framework using RxJS, built with TypeScript and optimized for serverless deployments. Features declarative routes and dependency injection powered by injection-js.

    License

    MIT

    Install

    npm i injection-js

    DownloadsWeekly Downloads

    345,151

    Version

    2.4.0

    License

    MIT

    Unpacked Size

    324 kB

    Total Files

    66

    Last publish

    Collaborators

    • mgechev