swk-metaobject v0.0.5

metaobject

This library is a lightweight implementation of the technique describe by Reginald Braithwaite in his book Javascript Spessore

Overview

Metaobjects are an object creation pattern that allow the user to generate objects that either forward or delegate their methods to other objects

forward(receiver={}, source={}, filter=[]/{})

This method will create methods on the receiver with the same name as the method on the source, but using the source as the context. You can select a subset of the methods by providing an array of strings denoting the methods to be referenced. You can alias the methods by providing an object, where the keys are the new names for the methods denoted by the values

delegate(receiver={}, source={}, filter=[]/{})

This method will create methods on the receiver with the same name as the methods on the source, but using the receiver as the context. You can select a subset of the methods by providing an array of strings denoting the methods to be referenced. You can alias the methods by providing an object, where the keys are the new names for the methods denoted by the values

Examples

var source, 
  receiver,
  meta = require("swk-metaobject");

source = {
  prop: "foo",
  doThis: function () { 
      return this.prop;
  },
  doThat: function () {
    return this;
  }
};

receiver = { 
  prop: "bar"
};

meta.forward(receiver, source);
receiver.doThis(); // foo
receiver.doThat(); // receiver

meta.delegate(receiver, source);
receiver.doThis(); // bar
receiver.doThat(); // receiver

// method filtering (same for delegate)
meta.forward(receiver, source, ['doThis']);
receiver.doThis; // function 
receiver.doThat; // undefined

// method aliasing (same for delegate)
meta.delegate(receiver, source, {executeThis: 'doThis'}
meta.doThis; // undefined
meta.doThat; // undefined
meta.executeThis; // function