benalu

#Benalu

A dynamic proxy for javascript. Provide a light weight proxy class generator with multiple interception.

###About The purpose of Benalu is provide a simple way to do a simple AOP in javascript. Benalu also useful for IOC container library that hasn't support for interception like Inversify 1.x

###Features

1. Can proxy a Function prototype or an object.

2. Can proxy method & property

3. Can add multiple interceptions

###Installation

npm install benalu

###How To Use It Using benalu is very simple. You start building your proxy by using Benalu builder

//declare the class
function MyObject(){}
MyObject.prototype.getNumber = function(){
    return 700;
}

//create instance
var myObject = new MyObject();
     
//make a proxy   
var proxy = Benalu.fromInstance(myObject)
    .addInterception(function(i) {
        //filter the invocation
        if(i.methodName == "getNumber"){
            //call the real method
            i.proceed();
            //override the return value
            i.returnValue = 300;
        }
    })
    .build();
    
var numResult = proxy.getNumber();
//numResult become 300 vs 700

###Interception & Invocation Interception in Benalu simply a callback function with single parameter of Invocation. Invocation consist of 3 important members:

1. methodName name of current invoked method. Usefull when you only want to intercept specific method of the class

2. parameters arguments passed to the invoked method. Usefull when you want to get information of the arguments passed to the method.

3. proceed() method to proceed current invocation. This method will invoke the method of the real object.

4. returnValue return value of the current invoked method. this member filled automatically after the proceed() method called. You can override the return value of current invocation by suplying a value to the returnValue member

###Interception Priority Interception can be applied more than one in a proxy. The last inserted interceptor having the most priority. If the last interceptor change the return value of Invocation then all previous override will be ignored.