this is a lighweight port of famous AS3 library swiftsuspenders 2.

NB. js-suspenders-101-porting.zip file contains the first version I ported. I mean... i just wrote as a monkey copying from AS3 to JS.

Dependency injection means giving an object its instance variables. Really. That's it. by James Shore.

This is also the js-suspenders design goal.

Although it basically works, at the moment this is just a "porting exercise".(I commented pieces of code I wasn't able to rewrite) Not every features are implemented:

• constructor injection point.
• Class, Singleton and Value providers.
• NO children injector.

Why? because at first I'd like to understand what i wrote :)

##Defining functions to map

It supports mapping by Array ["Dep", "SecondDep", Sprite]

// Sprite.js
function Sprite(a,b) {
    this.element = 1;
    this.method = function () { };
    this.dep = a;
    this.secondDep = b;
}
Sprite.prototype = {
    initialize: function () {
        console.log("Array",this.dep);
    }
};

or mapping by arguments names (it will break with minification)

// SpriteNoArray.js
function SpriteNoArray(dep, secondDep) {
    this.element = 1;
    this.method = function () {
    };
    this.dep = dep;
    this.secondDep = secondDep;
}

SpriteNoArray.prototype = {
    initialize: function () {
        console.log("NO ARRAY",this.dep);
    }
};

// two different dependencies functions
function Dep() {}
function ThirdType() {}

Create an Injector

var injector = new Injector();

##Mapping

You can map in some different ways

• directly with function name (minification can breaks function names!!!)

injector.map(Dep).asSingleton(); // asSingleton() allow you to map a function as a Singleton.

• map a function directly with its name, providing a name (string will not break, but dependencies still can)

injector.map(SpriteNoArray,'SpriteNoArray');

• map dependencies with an array and a name. (supposed to be safest way to map)

injector.map(["Dep", "SecondDep", Sprite],"Sprite");

• You can map an Object

injector.map('Value').toValue({
    init: function () {
        console.log("toValue", this);
    }
});

• or you can override a function with another one. Both function must have the same interface

injector.map('SecondDep').toType(ThirdType);

##Prototype or Singletons

Functions are registered as prototype by default, but you can map them as Singletons.

injector.map(Dep).asSingleton(); // asSingleton() allow you to register a function as a Singleton. Only 1 instance will be created.

toValue() method can be considered an alternative to map a Singleton.

##Get instances

Finally you can get an instance of mapped functions/Objects.

According the way you mapped each function/Object you can get by name or by type.

var sprite = injector.getInstance('Sprite');
var sprite2 = injector.getInstance(SpriteNoArray);

###Dependencies I added lodash dependency trying to make js-suspenders more functional oriented.