package
Easy prototype and static methods inheritance via inheritedBy method
npm install objexGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Estimated unpacked size across 2 packages.
22.9 kB
Includes dependencies.
Base constructor to ease prototype inheritance.
var Objex = require('objex'),
Animal = Objex.create(function() {
Animal.__super.apply(this, arguments);
this.feet = 4;
this.hands = 0;
this.head = 1;
}),
Wolf = Animal.create(),
Dog = Wolf.create(),
Monkey = Animal.create(function() {
Monkey.__super.apply(
var Animal = Objex.create(function() {
Animal.__super.apply(this, arguments);
Animal.count++;
}),
Sheep,
Wolf;
Animal.count = 0;
Animal.kill = function() {
if (Animal.count > 0) {
Animal.count--;
}
};
// pass `false` as first argument to prevent static fields bypass,
// static method `create` will be copied anyway.
// Assume, you want to count sheeps separately.
// Animal.count will not be copied to Sheep.count, because it useless here.
// Animal.kill will not be copied to Sheep too, aren't you want to shoot your own Sheep?
Suppose, you need to create Error inheritor, so your prototype chain must look like ErrorEx > Error > Object, not ErrorEx > Object.
Objex.wrap at your service!
var MyOwnErrorEx;
function ErrorEx() {
ErrorEx.__super.apply(this, arguments);
this.extended = true;
}
util.inherits(ErrorEx, Error);
Objex.wrap(ErrorEx, Error);
// now ErrorEx has `create` method and `__super` property
MyOwnErrorEx = ErrorEx.create(function(code) {
this.code = code;
MyOwnErrorEx.__super.apply(this, Array.prototype.slice.call(arguments, 1));
});Mixin (copy) static and prototype properties from any constructor to the Objex successor, without prototype chain modification. Mixed properties will be own properties of a target object.
var Animal = Objex.create(),
Dog = Animal.create(),
TrickyPet = function() {}, // mixin ctor
LoudVoice = function() {}, // more one
jimmy = new Dog();
Animal.prototype.say = function(wat) {
console.log(wat);
}
// mixin method
TrickyPet.prototype.jumpBackward = function() {
this.say('Woo-oo!');
};
// copy TrickyPet.prototype methods to Dog.prototype
Dog.mixin
You can declare special static method __objexOnMixing in the mixin, which will be called while mixin applies:
var Human = Objex.create(function() {
Human.__super.apply(this, arguments);
Human.population++;
}),
Mutant = function() {}; // mixin
Human.population = 1000;
Human.prototype.doSomething = function() {
console.log('Doing something...');
};
Mutant.__objexOnMixing = function(Base, isHungry) {
var doSomething = Base.prototype.doSomething;
if (isHungry && typeof
Description of the Objex and its successors static methods.
Create successor of the callee with constructor passed as ctor argument. Argument options describes how the successor inherits statis fields:
true – default value; copy all static properties w/o existing properties overriding;false – don't copy statis properties;{ include : [], exclude : [] } – object with optional fields include and exclude which are arrays of properties' names to copy of not;Array of String – shotcut syntax for { include : [] }.Add Objex create and mixin static methods to the ctor which is not Objex successor without prototype chain modification.
Mixin (copy) static and prototype methods of ctor to the callee contructor and its prototype if they doesn't exists.
Argument options is mostly the same as of the create method, but the object argument can contain additional properties:
{Boolean} [override=false] — if it equals true existing methods of the callee will be overriden by mixin's methods,{Boolean} [skipDynamicMixing=false] — if it equals true __objexOnMixing won’t be called.twilightfeel
twilightfeel@gmail.com