Closes #4

Author: ecrmnn

README.md

@@ -25,6 +25,7 @@ All available methods
 - [chunk](#chunk)
 - [collapse](#collapse)
 - [combine](#combine)
+- [concat](#concat)
 - [contains](#contains)
 - [count](#count)
 - [diff](#diff)
@@ -184,6 +185,27 @@ combine.all();
 //=>   number: 8
 //=> }
 ```
+
+#### ``concat()``
+The concat method is used to merge two or more collections/arrays/objects:
+
+*You can also ``concat()`` an array of objects, or a multidimensional array*
+
+```js
+const collection = collect([1, 2, 3]);
+
+collection
+  .concat(['a', 'b', 'c'])
+  .concat({
+    name: 'Steven Gerrard',
+    number: 8
+  });
+
+collection.all();
+
+//=> [1, 2, 3, 'a', 'b', 'c', 'Steven Gerrard', 8]
+```
+
 #### ``contains()``
 The contains method determines whether the collection contains a given item:
 ```js

dist/index.js

@@ -12,6 +12,7 @@ Collection.prototype.avg = require('./methods/average');
 Collection.prototype.chunk = require('./methods/chunk');
 Collection.prototype.collapse = require('./methods/collapse');
 Collection.prototype.combine = require('./methods/combine');
+Collection.prototype.concat = require('./methods/concat');
 Collection.prototype.contains = require('./methods/contains');
 Collection.prototype.count = require('./methods/count');
 Collection.prototype.diff = require('./methods/diff');

dist/methods/concat.js

@@ -0,0 +1,30 @@
+'use strict';
+
+var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };
+
+module.exports = function concat(collectionOrArrayOrObject) {
+  var _this = this;
+
+  var list = collectionOrArrayOrObject;
+
+  if (collectionOrArrayOrObject instanceof this.constructor) {
+    list = collectionOrArrayOrObject.all();
+  } else if ((typeof collectionOrArrayOrObject === 'undefined' ? 'undefined' : _typeof(collectionOrArrayOrObject)) === 'object') {
+    list = [];
+    Object.keys(collectionOrArrayOrObject).forEach(function (property) {
+      list.push(collectionOrArrayOrObject[property]);
+    });
+  }
+
+  list.forEach(function (item) {
+    if ((typeof item === 'undefined' ? 'undefined' : _typeof(item)) === 'object') {
+      Object.keys(item).forEach(function (key) {
+        return _this.items.push(item[key]);
+      });
+    } else {
+      _this.items.push(item);
+    }
+  });
+
+  return this;
+};

package.json

@@ -1,6 +1,6 @@
 {
   "name": "collect.js",
-  "version": "3.0.45",
+  "version": "3.0.46",
   "description": "Convenient and dependency free wrapper for working with arrays and objects.",
   "main": "dist/index.js",
   "typings": "index.d.ts",

src/index.js

@@ -12,6 +12,7 @@ Collection.prototype.avg = require('./methods/average');
 Collection.prototype.chunk = require('./methods/chunk');
 Collection.prototype.collapse = require('./methods/collapse');
 Collection.prototype.combine = require('./methods/combine');
+Collection.prototype.concat = require('./methods/concat');
 Collection.prototype.contains = require('./methods/contains');
 Collection.prototype.count = require('./methods/count');
 Collection.prototype.diff = require('./methods/diff');

src/methods/concat.js

@@ -0,0 +1,24 @@
+'use strict';
+
+module.exports = function concat(collectionOrArrayOrObject) {
+  let list = collectionOrArrayOrObject;
+
+  if (collectionOrArrayOrObject instanceof this.constructor) {
+    list = collectionOrArrayOrObject.all();
+  } else if (typeof collectionOrArrayOrObject === 'object') {
+    list = [];
+    Object.keys(collectionOrArrayOrObject).forEach((property) => {
+      list.push(collectionOrArrayOrObject[property]);
+    });
+  }
+
+  list.forEach((item) => {
+    if (typeof item === 'object') {
+      Object.keys(item).forEach(key => this.items.push(item[key]));
+    } else {
+      this.items.push(item);
+    }
+  });
+
+  return this;
+};

test/tests.js

@@ -1872,6 +1872,78 @@ describe('Collect.js Test Suite', function () {
     expect(collectionObject.toArray()).to.eql(collectionObject.values().all());
   });
 
+  it('should append arrays to collection', function () {
+    const expected = [
+      4,
+      5,
+      6,
+      'a',
+      'b',
+      'c',
+      'Jonny',
+      'from',
+      'Laroe',
+      'Jonny',
+      'from',
+      'Laroe'
+    ];
+
+    const firstCollection = collect([4, 5, 6]);
+    const firstArray = ['a', 'b', 'c'];
+    const secondArray = [{
+      who: 'Jonny'
+    }, {
+      preposition: 'from'
+    }, {
+      where: 'Laroe'
+    }];
+    const firstObj = {
+      who: 'Jonny',
+      preposition: 'from',
+      where: 'Laroe'
+    };
+
+    firstCollection.concat(firstArray).concat(secondArray).concat(firstObj);
+
+    expect(firstCollection.count()).to.eql(12);
+    expect(firstCollection.all()).to.eql(expected);
+  });
+
+  it('should append collections to collection', function () {
+    const expected = [
+      4,
+      5,
+      6,
+      'a',
+      'b',
+      'c',
+      'Jonny',
+      'from',
+      'Laroe',
+      'Jonny',
+      'from',
+      'Laroe'
+    ];
+
+    const firstCollection = collect([4, 5, 6]);
+    const secondCollection = collect(['a', 'b', 'c']);
+    const thirdCollection = collect([{
+      who: 'Jonny'
+    }, {
+      preposition: 'from'
+    }, {
+      where: 'Laroe'
+    }]);
+
+    firstCollection
+      .concat(secondCollection)
+      .concat(thirdCollection)
+      .concat(thirdCollection);
+
+    expect(firstCollection.count()).to.eql(12);
+    expect(firstCollection.all()).to.eql(expected);
+  });
+
   it('should be iterable', function () {
     let result = '';