This function will return the first element of the array (#218)

closes #216

Author: latiifabdi

src/first.js

@@ -0,0 +1,11 @@
+export default first
+
+/**
+ * This method will return the first element of the array.
+ *
+ * @param {Array} array - the array
+ * @return {*} - first item in the array
+ */
+function first(array) {
+  return array[0]
+}

src/index.js

@@ -81,6 +81,7 @@ import reduceCount from './reduceCount'
 import BitwiseAnd from './BitwiseAnd'
 import copyArrayByValue from './copyArrayByValue'
 import timeSince from './timeSince'
+import first from './first'
 
 export {
   reverseArrayInPlace,
@@ -166,4 +167,5 @@ export {
   BitwiseAnd,
   copyArrayByValue,
   timeSince,
+  first,
 }

test/first.test.js

@@ -0,0 +1,8 @@
+import test from 'ava'
+import {first} from '../src'
+
+test('gets the first item from an array', t => {
+  const array = [1, 2, 3]
+  const lastItem = first(array)
+  t.deepEqual(lastItem, 1)
+})