feat(copyArrayByValue): Add copyArrayByValue function (#213) (#214)

Closes #213

Author: mancristiana

src/copyArrayByValue.js

@@ -0,0 +1,13 @@
+export default copyArrayByValue
+
+/**
+ * Original Source: https://stackoverflow.com/a/7486130/5679427
+ *
+ * This method will clone the array and return a reference to the new array.
+ *
+ * @param {Array} array - The array to be copied
+ * @return {Array} - Reference to the copied array
+ */
+function copyArrayByValue(array) {
+  return array.slice()
+}

src/index.js

@@ -79,6 +79,7 @@ import last from './last'
 import descendingOrder from './descending-order'
 import reduceCount from './reduceCount'
 import BitwiseAnd from './BitwiseAnd'
+import copyArrayByValue from './copyArrayByValue'
 
 export {
   reverseArrayInPlace,
@@ -162,4 +163,5 @@ export {
   descendingOrder,
   reduceCount,
   BitwiseAnd,
+  copyArrayByValue,
 }

test/copyArrayByValue.test.js

@@ -0,0 +1,9 @@
+import test from 'ava'
+import {copyArrayByValue} from '../src'
+
+test('copies the given array', t => {
+  const original = ['a', 'b', 'c', 1, 2, {d: 'e'}]
+  const expected = ['a', 'b', 'c', 1, 2, {d: 'e'}]
+  const actual = copyArrayByValue(original)
+  t.deepEqual(actual, expected)
+})