Range.js is an attempt to add ruby-like range class to javascript. Library is written using ES6 (ecmascript 2015), but compiled (using babel) ES5 version is provided as well.

• Ruby-like full-featured range class (check methods list)
• Chars and numbers are supported
• Node, requirejs and browsers are supported
• ES6 and ES5 version for older browsers (like Internet Explorer 10-11)
• Easy to fork: gulpfile and tests are provided

npm i --save Range.js

git clone https://github.com/1001v/Range.js.git ./Range.js

You can add Range.js to your node.js project, HTML-code or RequireJS

Require Range.js ES6:

const Range = require('Range.js');

Require Range.js ES5:

const Range = require('Range.js/dist/range.es5.js');

Make Range class global:

global.Range = Range;

Add script tag to your HTML:

<script src='Range.js/dist/range.es5.js'></script> 

Create your range like this:

let min = 0;
let max = 10;
let range = new Range(min, max);

Max value must be greater or equal to min value, otherwise an error would be thrown. Min and max values must be the same type (string or number). You can create a range of any unicode symbols, for example:

let range = new Range('a', 'z');

The only condition is that charcode is rising from min to max. Note that Range.js doesn't store all range values, so feel free to create pretty big ranges.

###isEqual(other) Check if this range object is equal to other range object:

new Range(1, 5).isEqual(new Range(1, 5)) // true
new Range(1, 5).isEqual(new Range('a', 'z')) // false

###get(index) Get a value from range by index like from array:

new Range(-10, 5).get(0) // -10
new Range('a', 'z').get(25) // 'z'
new Range(0, 1).get(-1) // undefined

###getRandom() Get random value from range:

new Range(-10, 10).getRandom() // -4
new Range(1, 10).getRandom() // 5
new Range('a', 'z').getRandom() // 'f'
new Range('C', 'G').getRandom() // 'E'

###includes(value) Check if range includes a value:

new Range(1, 10).includes(5) // true
new Range('A', 'Z').includes(100) // false

###toString() Get string from range:

new Range(0, 10).toString() // '[0..10]'

###toArray() Get array of all values, included by range (this one is useful when you want an alphabet array):

new Range(5, 10).toArray() // [5, 6, 7, 8, 9, 10]
new Range('a', 'f').toArray() // ['a', 'b', 'c', 'd', 'e', 'f']

###forEach(callback) Iterate your range like array (no array allocs):

let range = new Range(5, 10).forEach((value, index, range) => {
    // value contains each value from range
    // index contains value index like in array
    // range contains this range
})
// Note that forEach method returns the range it was called for, unlike Array.prototype.forEach does in vanilla js
range.toString() // '[5..10]'

###size() Get range size:

new Range(0, 10).size() // 11

###getClass() Get class name:

new Range(0, 10).getClass() // 'Range'

Gulpfile for building and tests for Mocha are provided in this repository.

Clone (or fork and clone optionally) this repository:

git clone https://github.com/1001v/Range.js.git ./Range.js

Install development dependencies:

cd Range.js && npm install

npm test

Unfortunately, there's no option to uglify ES6 version now due to 3rd party reasons.

gulp build:all

You can check gulpfile for specific build tasks.

This project is licensed under the MIT License - see the LICENSE.md file for details