1# lodash v4.17.15
2
3[Site](https://lodash.com/) |
4[Docs](https://lodash.com/docs) |
5[FP Guide](https://github.com/lodash/lodash/wiki/FP-Guide) |
6[Contributing](https://github.com/lodash/lodash/blob/master/.github/CONTRIBUTING.md) |
7[Wiki](https://github.com/lodash/lodash/wiki "Changelog, Roadmap, etc.") |
8[Code of Conduct](https://js.foundation/conduct/) |
9[Twitter](https://twitter.com/bestiejs) |
10[Chat](https://gitter.im/lodash/lodash)
11
12The [Lodash](https://lodash.com/) library exported as a [UMD](https://github.com/umdjs/umd) module.
13
14Generated using [lodash-cli](https://www.npmjs.com/package/lodash-cli):
15```shell
16$ npm run build
17$ lodash -o ./dist/lodash.js
18$ lodash core -o ./dist/lodash.core.js
19```
20
21## Download
22
23 * [Core build](https://raw.githubusercontent.com/lodash/lodash/4.17.15/dist/lodash.core.js) ([~4 kB gzipped](https://raw.githubusercontent.com/lodash/lodash/4.17.15/dist/lodash.core.min.js))
24 * [Full build](https://raw.githubusercontent.com/lodash/lodash/4.17.15/dist/lodash.js) ([~24 kB gzipped](https://raw.githubusercontent.com/lodash/lodash/4.17.15/dist/lodash.min.js))
25 * [CDN copies](https://www.jsdelivr.com/projects/lodash)
26
27Lodash is released under the [MIT license](https://raw.githubusercontent.com/lodash/lodash/4.17.15/LICENSE) & supports modern environments.<br>
28Review the [build differences](https://github.com/lodash/lodash/wiki/build-differences) & pick one that’s right for you.
29
30## Installation
31
32In a browser:
33```html
34<script src="lodash.js"></script>
35```
36
37Using npm:
38```shell
39$ npm i -g npm
40$ npm i --save lodash
41```
42
43In Node.js:
44```js
45// Load the full build.
46var _ = require('lodash');
47// Load the core build.
48var _ = require('lodash/core');
49// Load the FP build for immutable auto-curried iteratee-first data-last methods.
50var fp = require('lodash/fp');
51
52// Load method categories.
53var array = require('lodash/array');
54var object = require('lodash/fp/object');
55
56// Cherry-pick methods for smaller browserify/rollup/webpack bundles.
57var at = require('lodash/at');
58var curryN = require('lodash/fp/curryN');
59```
60
61**Note:**<br>
62Install [n_](https://www.npmjs.com/package/n_) for Lodash use in the Node.js < 6 REPL.
63
64## Why Lodash?
65
66Lodash makes JavaScript easier by taking the hassle out of working with arrays,<br>
67numbers, objects, strings, etc. Lodash’s modular methods are great for:
68
69 * Iterating arrays, objects, & strings
70 * Manipulating & testing values
71 * Creating composite functions
72
73## Module Formats
74
75Lodash is available in a [variety of builds](https://lodash.com/custom-builds) & module formats.
76
77 * [lodash](https://www.npmjs.com/package/lodash) & [per method packages](https://www.npmjs.com/browse/keyword/lodash-modularized)
78 * [lodash-es](https://www.npmjs.com/package/lodash-es), [babel-plugin-lodash](https://www.npmjs.com/package/babel-plugin-lodash), & [lodash-webpack-plugin](https://www.npmjs.com/package/lodash-webpack-plugin)
79 * [lodash/fp](https://github.com/lodash/lodash/tree/npm/fp)
80 * [lodash-amd](https://www.npmjs.com/package/lodash-amd)
81