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