Lodash is trying to cover each possible use case, even very rare while typical observed use case of lodash is basic methods used on basic data. As an example, let's take a _.pick method that simply returns an object, based on source object, with just some properties copied. Easy, right? Few lines of code? Lodash makes that 114 imports!

@ezez/utils aims to:

cover only most typical use cases of given functions,
add useful methods that are missing in lodash,
NOT being 100% compatible replacement for lodash/underscore, while keeping MOST behavior identical,
not being a "polyfill" (no map/forEach functions etc.),
perform fast and have code size small.

Supported methods

cap - cap a value between lower and upper bound
capitalize - capitalize a string, optionally lower casing the rest
coalesce - return first non-nullish value
ensureArray - ensure that given value is an array
ensureError - ensure that given value is an error
get - extract a value from a deep object using specified path, optionally with a default value
getMultiple - same as above, but test multiple paths
insertSeparator - insert a separator between every character in an array
isEmpty - check if given value is empty
isPlainObject - check if given value is a plain object
last - get last element of an array
mapAsync - map an array asynchronously if sync version blocks your event loop for too long
mapValues - map values of an object
match - split your array into two groups - one that matches given predicate, and one that doesn't
merge - merge two objects shallowly, allowing to remove properties while doing so
mostFrequent - find most frequent value in an array
noop - do nothing
omit - omit properties from an object
pack - group array items into arrays of given size
pages - create a pages list to display on front-end
pick - pick some properties from an object
pull - remove values from an array (by mutating)
remove - remove values from an array (by mutating) using predicate function and return removed values
rethrow - throw given value
scale - scale given value from old range to new range
seq - sequentially execute Promise-returning functions until one returns a value
set - set a value in a deep object using specified path
setImmutable - set a value in a deep object using specified path, but return a new object
sortBy - sort an array by given property (create callback function for Array.prototype.sort)
throttle - throttle a function, very configurable
truthy - is value truthy? (useful for filtering with more correct TypeScript support than filter(Boolean))
wait - wait given amount of time (async)
waitSync - wait given amount of time (sync)
waitFor - wait for a condition to be true, checking every given amount of time

Methods will be added as I need them. I am open for suggestions and PRs. See next heading for list of methods that I want to add.

Methods to be supported

(TODO)

debounce

Tested

This library is fully unit tested and can be used on production. See License.

License

MIT