ffffng/app/bower_components/lodash/README.md

81 lines
3 KiB
Markdown
Raw Normal View History

2019-03-29 22:00:08 +01:00
# lodash v4.17.11
2016-05-16 13:33:49 +02:00
[Site](https://lodash.com/) |
[Docs](https://lodash.com/docs) |
[FP Guide](https://github.com/lodash/lodash/wiki/FP-Guide) |
2017-05-13 13:25:33 +02:00
[Contributing](https://github.com/lodash/lodash/blob/master/.github/CONTRIBUTING.md) |
2016-05-16 13:33:49 +02:00
[Wiki](https://github.com/lodash/lodash/wiki "Changelog, Roadmap, etc.") |
2017-05-13 13:25:33 +02:00
[Code of Conduct](https://js.foundation/conduct/) |
2016-05-16 13:33:49 +02:00
[Twitter](https://twitter.com/bestiejs) |
[Chat](https://gitter.im/lodash/lodash)
The [Lodash](https://lodash.com/) library exported as a [UMD](https://github.com/umdjs/umd) module.
Generated using [lodash-cli](https://www.npmjs.com/package/lodash-cli):
2017-05-13 13:25:33 +02:00
```shell
2016-05-16 13:33:49 +02:00
$ npm run build
$ lodash -o ./dist/lodash.js
$ lodash core -o ./dist/lodash.core.js
```
## Download
2019-03-29 22:00:08 +01:00
* [Core build](https://raw.githubusercontent.com/lodash/lodash/4.17.11/dist/lodash.core.js) ([~4 kB gzipped](https://raw.githubusercontent.com/lodash/lodash/4.17.11/dist/lodash.core.min.js))
* [Full build](https://raw.githubusercontent.com/lodash/lodash/4.17.11/dist/lodash.js) ([~24 kB gzipped](https://raw.githubusercontent.com/lodash/lodash/4.17.11/dist/lodash.min.js))
2017-05-13 13:25:33 +02:00
* [CDN copies](https://www.jsdelivr.com/projects/lodash)
2019-03-29 22:00:08 +01:00
Lodash is released under the [MIT license](https://raw.githubusercontent.com/lodash/lodash/4.17.11/LICENSE) & supports modern environments.<br>
2016-05-16 13:33:49 +02:00
Review the [build differences](https://github.com/lodash/lodash/wiki/build-differences) & pick one thats right for you.
2017-05-13 13:25:33 +02:00
## Installation
In a browser:
```html
<script src="lodash.js"></script>
```
Using npm:
```shell
$ npm i -g npm
$ npm i --save lodash
```
In Node.js:
```js
// Load the full build.
var _ = require('lodash');
// Load the core build.
var _ = require('lodash/core');
// Load the FP build for immutable auto-curried iteratee-first data-last methods.
var fp = require('lodash/fp');
// Load method categories.
var array = require('lodash/array');
var object = require('lodash/fp/object');
// Cherry-pick methods for smaller browserify/rollup/webpack bundles.
var at = require('lodash/at');
var curryN = require('lodash/fp/curryN');
```
**Note:**<br>
Install [n_](https://www.npmjs.com/package/n_) for Lodash use in the Node.js < 6 REPL.
2016-05-16 13:33:49 +02:00
## Why Lodash?
Lodash makes JavaScript easier by taking the hassle out of working with arrays,<br>
numbers, objects, strings, etc. Lodashs modular methods are great for:
2017-05-13 13:25:33 +02:00
* Iterating arrays, objects, & strings
* Manipulating & testing values
* Creating composite functions
2016-05-16 13:33:49 +02:00
## Module Formats
Lodash is available in a [variety of builds](https://lodash.com/custom-builds) & module formats.
* [lodash](https://www.npmjs.com/package/lodash) & [per method packages](https://www.npmjs.com/browse/keyword/lodash-modularized)
2017-05-13 13:25:33 +02:00
* [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)
* [lodash/fp](https://github.com/lodash/lodash/tree/npm/fp)
2016-05-16 13:33:49 +02:00
* [lodash-amd](https://www.npmjs.com/package/lodash-amd)