js-utils

This repository contains a set of simple, standalone JavaScript utility functions that I've used throughout the years in various projects. It's meant to provide useful tools that developers can easily modify and adapt for their own needs. The focus is on offering individual functions that can be changed as needed, rather than providing a full library.

The utilities are organized into packages based on their functionality. Each package contains a set of functions that are related to a specific area of development, such as arrays, strings, objects, functions, etc.

Table of Contents

Array

Name	Description
chunk	Creates an array of elements split into groups the length of size specified.
compact	Creates an array with all falsy values removed. 'false', 'null', '0', '""', 'undefined', and 'NaN' are falsy.
diff	Returns an array with only the unique values from the first array, by excluding all values from the second array using strict equality for comparisons.
drop	Creates a slice of array with n elements dropped from the beginning.
dropRight	Creates a slice of array with n elements dropped from the end.
dropRightWhile	Creates a slice of array excluding elements dropped from the end, until predicate returns falsy.
dropWhile	Creates a slice of array excluding elements dropped from the beginning, until predicate returns falsy.
groupBy	Creates an object composed of keys generated from the results of running each element of array through iteratee.
intersect	Creates an array of unique values that are included in all given arrays.
insert	Inserts one or more elements to array at specific index.
move	Move an array element to a different position.
partition	Creates an array of elements split into two groups (arrays) depending on the result of a predicated function invoked for each iteration.
pluck	Retrieves the value of a specified property from all elements in an array.
remove	Removes one or more elements from an array at the specified index(es).
shuffle	Returns a new array with its elements' order randomized, using the Fisher-Yates (aka Knuth) Shuffle algorithm.
tail	Gets all but the first element of array.
take	Creates a slice of array with n items taken from the beginning.
takeRight	Creates a slice of array with n items taken from the end.
takeRightWhile	Creates a slice of array with elements taken from the end, until predicate returns falsy.
takeWhile	Creates a slice of array with elements taken from the beginning, until predicate returns falsy.
sort	Sorts an array of primitive values.
sortBy	Sorts an array of objects by a property.
uniq	Creates a duplicate-free version of an array, using SameValueZero for equality comparisons.
uniqBy	Creates a dupliate free array by accepting an iteratee which is invoked for each element in array.
zip	Creates an array of grouped elements, the first of which contains the first elements of the given arrays, the second of which contains the second elements of the given arrays, and so on.

String

Name	Description
camelCase	Converts a string to camel case, eg 'theQuickBrownFoxJumpsOverTheLazyDog'.
capitalize	Capitalizes the first character of a string (Optionally, converts the rest of the string to lower case).
classnames	Creates a string by conditionally joining classNames together.
collapseWhitespace	Converts all adjacent whitespace characters to a single space.
deburr	Deburrs a string by converting latin-1 supplementary letters to basic latin letters and removing combining diacritical marks.
escapeHTML	Converts the characters &, <, >, " and ' in a string to their corresponding HTML entities.
escapeRegExp	Escapes RegExp special characters in a string.
kebabCase	Converts a string to kebab case, eg 'the-quick-brown-fox-jumps-over-the-lazy-dog'.
lines	Returns an array with the lines of a a string.
numberFormat

Number

Name	Description
average	Calculates the average of a set of numbers.
clamp	Clamps number within the inclusive lower and upper bounds.
degreesToRadians	Converts degrees to radians.
inRange	Checks if a number is between min and max including.
lerp	Takes a normalized value within a range of values and converts it to a numerical value that the normalized value points to.
normalize	Takes a value within a range of values and converts that value to a number from 0 to 1 that indicates where it lies in that range.
max	Returns the largest of zero or more numbers.
min	Returns the smallest of zero or more numbers.
radiansToDegrees	Converts radians to degrees.
randomDist	Returns a weighted random number (that tends to the center) of a range of numbers based on the number of the iterations set.
randomInt	Returns a pseudo-random integer number between a min (inclusive) and a max (inclusive) value.