This mini JavaScript library is based off of Haskell's List functions. JavaScript doesn't have a List type and so this library will really assist in making functional programming in JavaScript a lot easier.
A fundamental aspect of using lists/arrays in functional programming is that the original list/array should never be changed. No mutation occurs when an array is passed through one of these functions, simply a new array is created, still giving you access to the original array.
For example,
const arr = [1,2,3]
List.reverse(arr)arr will still have a value of [1,2,3] even though it has been passed through a function.
Whereas using the inbuilt reverse JavaScript function:
const arr = [1,2,3]
arr.reverse()The value of arr will now be [3,2,1].
Creates an array (with a default step of one) of values between two numbers.
List.range(1,5) === [1,2,3,4,5]
List.range(2,10,2) === [2,4,6,8,10]Creates an array of letter in alphabetical order.
List.alphaRange("F", "M") === ["F","G","H","I","J","K","L","M"]
List.alphaRange("a", "z") === ["a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z"]Take a specified length of values from an infinite list.
List.takeRange(13,26,15) === [13,26,39,52,65,78,91,104,117,130,143,156,169,182,195]Creates an array of one value for a specified length.
List.replicate("Hi", 10) === ["Hi","Hi","Hi","Hi","Hi","Hi","Hi","Hi","Hi","Hi"]Takes an array and replicates the items for a specified length.
List.cycle([1,2,3],10) === [1,2,3,1,2,3,1,2,3,1]Returns the first element of an array.
List.first([1,2,3]) === 1Returns the last element of an array.
List.last([1,2,3]) === 3Returns the smallest value of an array.
List.min([9,3,7,2,5,4]) === 2Returns the largest value of an array.
List.max([9,3,7,2,5,4]) === 9Returns the sum of all the elements in an array.
List.sum([9,3,7,2,5,4]) === 30Returns the product of all the elements in an array.
List.product([9,3,7,2,5,4]) === 7560Sorts an array containing numerical elements from smallest to largest.
List.sort([10,7,15,19,11,8,2]) === [2,7,8,10,11,15,19]Randomly sorts the elements of an array.
List.shuffle(["I","L","O","V","E","J","S"] === ["J","V","S","E","I","L","O"]Reverses the order of elements in an array.
List.reverse([1,2,3]) === [3,2,1]Returns a Boolean value on whether or not the array is empty.
List.isEmpty([]) === true
List.isEmpty([1,2,3]) === falseReturns a Boolean value on whether or not two arrays are the same.
List.isEqual([1,2,3], [4,5,6]) === false
List.isEqual([1,2,3], [1,2,3]) === trueReturns the array without the last element.
List.init([1,2,3,4,5,6]) === [1,2,3,4,5]Returns the array without the first element.
List.tail([1,2,3,4,5,6]) === [2,3,4,5,6]Returns the array with the first specified number of elements.
List.take([1,2,3,4,5,6], 4) === [1,2,3,4]Returns the array without the first specified number of elements.
List.drop([1,2,3,4,5,6], 4) === [5,6]Returns the array with only the unique elements.
List.unique([1,2,3,5,2,1,6,2,3]) === [1,2,3,5,6]Adds an element to the end of an array.
List.append([1,2,3], 4) === [1,2,3,4]Adds an element to the start of an array.
List.prepend([1,2,3], 4) === [4,1,2,3]Inserts an element into an array at a specified index.
List.insert([1,2,3], 2, 4) === [1,2,4,3]Replaces all instances of an element with a different element.
List.replace([1,2,3,4,2], 2, 6) === [1,6,3,4,6]Replaces an element at a specified index.
List.replaceAt([1,2,3,4,2], 3, 6) === [1,2,3,6,2]Removes all instances of an element.
List.remove([1,2,3,4,2], 2) === [1,3,4]Removes an element at a specified index.
List.removeAt([1,2,3,4,2], 3) === [1,2,3,2]Combines two arrays into one with any given function.
List.combine([1,2,3], [4,5,6], mult = (x,y) => x*y) === [4,5,6,8,10,12,12,15,18]Takes two one-dimensional arrays and combines them into a single two-dimensional array, but only where indexes match.
List.zip([1,2,3], [4,5,6,7,8,9]) === [[1,4], [2,5], [3,6]]