RichJS

A JavaScript library for rich prototypes

This is a simple library designed to give a belt of good utility functions throughout your well known data types

How to use

var Rich = require('rich-js');
Rich.Core.applyAll(); // To apply all prototypes
Rich.Array.applyRichPrototype(); // Applies only the Array prototype

npm install --save rich-js

Safety

This library try not to clash with any possible standard when naming methods. And in case it clashes, it will not override the method and will output a warn in the console.

Prefix

In case you want to prefix the new methods, you can do by:

Rich.Util.prefix = 'r';
Rich.Number.applyRichPrototype();
 
(1).rseconds(); //1000

Adding your own custom prototypes

Rich.Util.applyToPrototype(Number, 'square', function() {
    return this.valueOf() * this.valueOf();
});
 
(3).square();
// 9

Documentation

1. Number
2. Object
3. Array

Examples

A few examples of what this library offers

//Number prototype
(3).minutes();
// 180000
 
(3).times(function(i) {
    console.log(i);
});
// 0
// 1
// 2
 
(3).isEven();
// false
(3).isOdd();
// true
 
// Object prototype
({
    prop: {
        name: 'Test'
    }
}).getProperty('prop.name');
// 'Test'
 
// Array prototype
[{a: 1}, {a: 1}, {a: 2}].groupBy('a');
/*
{
  1: [{a: 1}, {a: 1}],
  2: [{a: 2}]
}
*/