lodash v3.7.0
The modern build of lodash exported as Node.js/io.js modules.
Generated using lodash-cli:
$ lodash modularize modern exports=node -o ./
$ lodash modern -d -o ./index.js
Installation
Using npm:
$ {sudo -H} npm i -g npm
$ npm i --save lodash
In Node.js/io.js:
// load the modern build
var _ = require('lodash');
// or a method category
var array = require('lodash/array');
// or a method (great for smaller builds with browserify/webpack)
var chunk = require('lodash/array/chunk');
See the package source for more details.
Note:
Don’t assign values to the special variable _ when in the REPL.
Install n_ for a REPL that includes lodash by default.
Module formats
lodash is also available in a variety of other builds & module formats.
Further Reading
Features
- ~100% code coverage
- Follows semantic versioning for releases
- Lazily evaluated chaining
- _(…) supports intuitive chaining
- _.add for mathematical composition
- _.ary & _.rearg to change function argument limits & order
- _.at for cherry-picking collection values
- _.attempt to execute functions which may error without a try-catch
- _.before to complement _.after
- _.bindKey for binding “lazy” defined methods
- _.chunk for splitting an array into chunks of a given size
- _.clone supports shallow cloning of
Date & RegExp objects - _.cloneDeep for deep cloning arrays & objects
- _.create for easier object inheritance
- _.curry & _.curryRight for creating curried functions
- _.debounce & _.throttle are cancelable & accept options for more control
- _.fill to fill arrays with values
- _.findKey for finding keys
- _.flow to complement _.flowRight (a.k.a
_.compose) - _.forEach supports exiting early
- _.forIn for iterating all enumerable properties
- _.forOwn for iterating own properties
- _.get & _.set for deep property getting & setting
- _.inRange for checking whether a number is within a given range
- _.isNative to check for native functions
- _.isPlainObject & _.toPlainObject to check for & convert to
Object objects - _.isTypedArray to check for typed arrays
- _.matches supports deep object comparisons
- _.matchesProperty to complement _.matches & _.property
- _.method & _.methodOf to create functions that invoke methods
- _.merge for a deep _.extend
- _.parseInt for consistent cross-environment behavior
- _.pull, _.pullAt, & _.remove for mutating arrays
- _.random supports returning floating-point numbers
- _.restParam & _.spread for applying rest parameters & spreading arguments to functions
- _.runInContext for collisionless mixins & easier mocking
- _.slice for creating subsets of array-like values
- _.sortByAll & _.sortByOrder for sorting by multiple properties & orders
- _.sum to get the sum of values
- _.support for flagging environment features
- _.template supports “imports” options & ES template delimiters
- _.transform as a powerful alternative to _.reduce for transforming objects
- _.xor to complement _.difference, _.intersection, & _.union
- _.valuesIn for getting values of all enumerable properties
- _.bind, _.curry, _.partial, & more support customizable argument placeholders
- _.capitalize, _.trim, & more string methods
- _.clone, _.isEqual, & more accept callbacks
- _.dropWhile, _.takeWhile, & more to complement _.first, _.initial, _.last, & _.rest
- _.findLast, _.findLastKey, & more right-associative methods
- _.includes, _.toArray, & more accept strings
- _#commit & _#plant for working with chain sequences
- _#thru to pass values thru a chain sequence
Support
Tested in Chrome 41-42, Firefox 36-37, IE 6-11, Opera 27-28, Safari 5-8, io.js 1.7.1, Node.js 0.8.28, 0.10.38, & 0.12.2, PhantomJS 1.9.8, RingoJS 0.11, & Rhino 1.7RC5. Automated browser & CI test runs are available. Special thanks to Sauce Labs for providing automated browser testing.
