c5fd23b54f | ||
---|---|---|
.. | ||
dist | ||
LICENSE.txt | ||
README.md | ||
lodash.js | ||
package.json |
README.md
Lo-Dash v2.4.2
A utility library delivering consistency, customization, performance, & extras.
Download
Check out our wiki for details over the differences between builds.
-
Modern builds perfect for newer browsers/environments:
Development & Production -
Compatibility builds for older environment support too:
Development & Production -
Underscore builds to use as a drop-in replacement:
Development & Production
CDN copies are available on cdnjs & jsDelivr. For smaller file sizes, create custom builds with only the features needed.
Love modules? We’ve got you covered with lodash-amd, lodash-es6, lodash-node, & npm packages per method.
Dive in
There’s plenty of documentation, unit tests, & benchmarks.
Check out DevDocs as a fast, organized, & searchable interface for our documentation.
The full changelog for this release is available on our wiki.
A list of upcoming features is available on our roadmap.
Installation & usage
In browsers:
<script src="lodash.js"></script>
Using npm
:
npm i --save lodash
{sudo} npm i -g lodash
npm ln lodash
var _ = require('lodash');
// or as Underscore
var _ = require('lodash/dist/lodash.underscore');
Notes:
- Don’t assign values to special variable
_
when in the REPL - If Lo-Dash is installed globally, run
npm ln lodash
in your project’s root directory before requiring it
In Rhino:
load('lodash.js');
In an AMD loader:
require({
'packages': [
{ 'name': 'lodash', 'location': 'path/to/lodash', 'main': 'lodash' }
]
},
['lodash'], function(_) {
console.log(_.VERSION);
});
Resources
- Podcasts
- Posts
- Videos
A list of other community created podcasts, posts, & videos is available on our wiki.
Features
- AMD loader support (curl, dojo, requirejs, etc.)
- _(…) supports intuitive chaining
- _.at for cherry-picking collection values
- _.bindKey for binding “lazy” defined methods
- _.clone supports shallow cloning of
Date
&RegExp
objects - _.cloneDeep for deep cloning arrays & objects
- _.constant & _.property function generators for composing functions
- _.contains accepts a
fromIndex
- _.create for easier object inheritance
- _.createCallback for extending callbacks in methods & mixins
- _.curry for creating curried functions
- _.debounce & _.throttle accept additional
options
for more control - _.findIndex & _.findKey for finding indexes & keys
- _.forEach is chainable & supports exiting early
- _.forIn for iterating own & inherited properties
- _.forOwn for iterating own properties
- _.isPlainObject for checking if values are created by
Object
- _.mapValues for mapping values to an object
- _.memoize exposes the
cache
of memoized functions - _.merge for a deep _.extend
- _.noop for function placeholders
- _.now as a cross-browser
Date.now
alternative - _.parseInt for consistent behavior
- _.pull & _.remove for mutating arrays
- _.random supports returning floating-point numbers
- _.runInContext for easier mocking
- _.sortBy supports sorting by multiple properties
- _.support for flagging environment features
- _.template supports “imports” options & ES6 template delimiters
- _.transform as a powerful alternative to _.reduce for transforming objects
- _.where supports deep object comparisons
- _.xor as a companion to _.difference, _.intersection, & _.union
- _.zip is capable of unzipping values
- _.omit, _.pick, & more accept callbacks
- _.contains, _.toArray, & more accept strings
- _.filter, _.map, & more support “_.pluck” & “_.where” shorthands
- _.findLast, _.findLastIndex, & more right-associative methods
Support
Tested in Chrome 5~31, Firefox 2~25, IE 6-11, Opera 9.25-17, Safari 3-7, Node.js 0.6.21-0.10.22, Narwhal 0.3.2, PhantomJS 1.9.2, RingoJS 0.9, & Rhino 1.7RC5.