Jarr.js in a queryable array type object that inherits standard array functionality and provides methods to query and transform the data. The aim is is to simplify your JavaScript code by incorporating some of the most common array manipulations into easy to use methods.
npm install jarr.js
Create a new Jarr from an existing array.
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);Alternatively, n-arguments can be past into the constructor.
var jarr = new Jarr(1, 2, 3, 4, 5, 6);all
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.all(function (item) { return item > 3; });false
any
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.any(function (item) { return item > 3; });true
at
jarr = new Jarr(1, 2, 3, 4, 5, 6);
jarr.at(1);2
contains
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.contains(3);returns true;
add
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.add(7);[1, 2, 3, 4, 5, 6, 7] as an instance of Jarr.
copy
- performs a shallow copy of the array.
jarr = new Jarr(1, 2, 3, 4, 5, 6)
jarr.copy();[1, 2, 3, 4, 5, 6]
count
jarr = new Jarr(1, 2, 3, 4, 5, 6);
jarr.count();6
defaultIfEmpty
jarr = new Jarr();
jarr.defaultIfEmpty({"my" : "value"});[{"my" : "value"}]
distinct
jarr = new Jarr(1, 1, 2, 3, 3, 3, 4, 5, 5, 5, 5, 6);
jarr.distinct();[1, 2, 3, 4, 5, 6]
elementAt
jarr = new Jarr(1, 2, 3, 4, 5, 6);
jarr.elementAt(1);2
elementAtOrDefault
jarr = new Jarr({"my" : "value 1"}, {"my" : "value 2"}, {"my" : "value 3"});
jarr.elementAtOrDefault(0, {"my" : "default value"});
jarr.elementAtOrDefault(99, {"my" : "default value"});{"my" : "value 1"}
{"my" : "default value"}
first
jarr = new Jarr(1, 2, 3, 4, 5, 6);
jarr.first(function (item) {
return item > 3;
});4
firstOrDefault
jarr = new Jarr();
jarr.firstOrDefault({"my" : "default value"});
jarr = new Jarr({"my" : "value 1"}, {"my" : "value 2"}, {"my" : "value 3"});
jarr.firstOrDefault({"my" : "default value"});{"my" : "default value"}
{"my" : "value 1"}
insertAt
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.insertAt(1, 'X');[1, 'X', 2, 3, 4, 5, 6]
intersect
var jarr = new Jarr([1, 2, 3, 4, 5, 6]),
anyArray = [3, 5, 6, 7, 8, 9];
jarr.intersect(anyArray, function (item1, i1, item2, i2) {
return item1 == item2;
});or simply
jarr.intersect(anyArray);[3, 5, 6]
last
jarr = new Jarr(1, 2, 3, 4, 5, 6);
jarr.last(function (item) {
return item < 5;
});4
lastOrDefault
jarr = new Jarr();
jarr.lastOrDefault({"my" : "default value"});
jarr = new Jarr({"my" : "value 1"}, {"my" : "value 2"}, {"my" : "value 3"});
jarr.lastOrDefault({"my" : "default value"});{"my" : "default value"}
{"my" : "value 3"}
notIntersect
var jarr = new Jarr([1, 2, 3, 4, 5, 6]),
anyArray = [3, 5, 6, 7, 8, 9];
jarr.notIntersect(anyArray, function (item1, i1, item2, i2) {
return item1 == item2;
});var jarr = new Jarr([1, 2, 3, 4, 5, 6]),
anyArray = [3, 5, 6, 7, 8, 9];
jarr.intersect(anyArray, function (item1, i1, item2, i2) {
return item1 == item2;
});orderBy
jarr = new Jarr({value : 4}, {value : 1}, {value : 5}, {value : 2}, {value : 6}, {value : 3})
jarr.orderBy(function (item) {
return item.value; //order by value property
});[{value : 1}, {value : 2}, {value : 3}, {value : 4}, {value : 5}, {value : 6}]
orderByDescending
jarr = new Jarr({value : 4}, {value : 1}, {value : 5}, {value : 2}, {value : 6}, {value : 3})
jarr.orderByDescending(function (item) {
return item.value; //order by value property
});[{value : 6}, {value : 5}, {value : 4}, {value : 3}, {value : 2}, {value : 1}]
remove
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.remove(4);[1, 2, 3, 5, 6]
removeAt
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.removeAt(4);[1, 2, 3, 4, 6]
reverse
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.reverse();[6, 5, 4, 3, 2, 1]
select
var jarr = new Jarr({name: "red", values : [4, 5, 6]}, {name: "green", values : 1}, {name : "blue", values : [9, 0]}, {name : "purple", values : 1}, {name: "orange", values : [1, 2, 3]}, {name: "yellow", values : 3});
jarr.select(function (item) {
return item.values;
});[ [4, 5, 6], 1, [9, 0], 1, [1, 2, 3], 3 ]
selectMany
var jarr = new Jarr({name: "red", values : [4, 5, 6]}, {name: "green", values : 1}, {name : "blue", values : [9, 0]}, {name : "purple", values : 1}, {name: "orange", values : [1, 2, 3]}, {name: "yellow", values : 3});
jarr.selectMany(function (item) {
return item.values;
});[4, 5, 6, 1, 9, 0, 1, 1, 2, 3, 3]
where
var jarr = new Jarr([1, 2, 3, 4, 5, 6]);
jarr.where(function (item) {
return item % 2 == 0;
});[2, 4, 6]