Merge pull request #3 from hashemirafsan/h11n

Adding 'chunk()' method as a new API

Author: me-shaon

README.md

@@ -168,6 +168,7 @@ Following API examples are shown based on the sample JSON data given [here](exam
 * [sortBy](#sortbyproperty-order)
 * [reset](#resetdata)
 * [copy](#copy)
+* [chunk](#chunk)
 
 ### `fetch()`
 
@@ -523,6 +524,12 @@ It will return a complete clone of the Object instance.
 
 See a detail example [here](examples/copy.js).
 
+### `chunk(size)`
+
+It will return a complete new array after chunking your array with specific size.
+
+See a detail example [here](examples/chunk.js).
+
 ## Bugs and Issues
 
 If you encounter any bugs or issues, feel free to [open an issue at

examples/chunk.js

@@ -0,0 +1,15 @@
+/*
+Example of Chunk() API
+---------------------
+You need to pass an integer number to chunk method to get your desired result.
+*/
+
+const jsonQ = require('../index.js');
+let Q = new jsonQ(__dirname + '/data.json');
+
+const chunking = Q.from('users')
+ .where('location', '=', 'Barisal')
+ .chunk(4);
+
+console.log('-------- Printing Result of chunk ---------');
+console.log(chunking);

index.js

@@ -80,6 +80,32 @@ class JSJsonQ {
  return this._jsonContent;
  }
 
+ /**
+ * chunk - group the resulted collection to multiple chunk
+ *
+ * @param {integer} The length of each chunk
+ * @return {Array} New Array 
+ */
+
+ chunk(size = 0) {
+ if(size <= 0) {
+ throw Error('Invalid chunk size');
+ }
+ 
+ this._prepare();
+
+ let _newContent = [];
+
+ while(this._jsonContent.count() > 0) {
+ _newContent.push(this._jsonContent.splice(0, size));
+ }
+
+ this._jsonContent = _newContent;
+
+ return this._jsonContent;
+ }
+
+
  /**
  * at - get the data traversing through the given path hierarchy
  * Will return the JsonQuery Object instance, so that further