1 | # array-unique [](https://www.npmjs.com/package/array-unique) [](https://npmjs.org/package/array-unique) [](https://travis-ci.org/jonschlinkert/array-unique)
|
2 |
|
3 | Remove duplicate values from an array. Fastest ES5 implementation.
|
4 |
|
5 | ## Install
|
6 |
|
7 | Install with [npm](https://www.npmjs.com/):
|
8 |
|
9 | ```sh
|
10 | $ npm install --save array-unique
|
11 | ```
|
12 |
|
13 | ## Usage
|
14 |
|
15 | ```js
|
16 | var unique = require('array-unique');
|
17 |
|
18 | var arr = ['a', 'b', 'c', 'c'];
|
19 | console.log(unique(arr)) //=> ['a', 'b', 'c']
|
20 | console.log(arr) //=> ['a', 'b', 'c']
|
21 |
|
22 | /* The above modifies the input array. To prevent that at a slight performance cost: */
|
23 | var unique = require("array-unique").immutable;
|
24 |
|
25 | var arr = ['a', 'b', 'c', 'c'];
|
26 | console.log(unique(arr)) //=> ['a', 'b', 'c']
|
27 | console.log(arr) //=> ['a', 'b', 'c', 'c']
|
28 | ```
|
29 |
|
30 | ## About
|
31 |
|
32 | ### Related projects
|
33 |
|
34 | * [arr-diff](https://www.npmjs.com/package/arr-diff): Returns an array with only the unique values from the first array, by excluding all… [more](https://github.com/jonschlinkert/arr-diff) | [homepage](https://github.com/jonschlinkert/arr-diff "Returns an array with only the unique values from the first array, by excluding all values from additional arrays using strict equality for comparisons.")
|
35 | * [arr-flatten](https://www.npmjs.com/package/arr-flatten): Recursively flatten an array or arrays. This is the fastest implementation of array flatten. | [homepage](https://github.com/jonschlinkert/arr-flatten "Recursively flatten an array or arrays. This is the fastest implementation of array flatten.")
|
36 | * [arr-map](https://www.npmjs.com/package/arr-map): Faster, node.js focused alternative to JavaScript's native array map. | [homepage](https://github.com/jonschlinkert/arr-map "Faster, node.js focused alternative to JavaScript's native array map.")
|
37 | * [arr-pluck](https://www.npmjs.com/package/arr-pluck): Retrieves the value of a specified property from all elements in the collection. | [homepage](https://github.com/jonschlinkert/arr-pluck "Retrieves the value of a specified property from all elements in the collection.")
|
38 | * [arr-reduce](https://www.npmjs.com/package/arr-reduce): Fast array reduce that also loops over sparse elements. | [homepage](https://github.com/jonschlinkert/arr-reduce "Fast array reduce that also loops over sparse elements.")
|
39 | * [arr-union](https://www.npmjs.com/package/arr-union): Combines a list of arrays, returning a single array with unique values, using strict equality… [more](https://github.com/jonschlinkert/arr-union) | [homepage](https://github.com/jonschlinkert/arr-union "Combines a list of arrays, returning a single array with unique values, using strict equality for comparisons.")
|
40 |
|
41 | ### Contributing
|
42 |
|
43 | Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
|
44 |
|
45 | ### Building docs
|
46 |
|
47 | _(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_
|
48 |
|
49 | To generate the readme and API documentation with [verb](https://github.com/verbose/verb):
|
50 |
|
51 | ```sh
|
52 | $ npm install -g verb verb-generate-readme && verb
|
53 | ```
|
54 |
|
55 | ### Running tests
|
56 |
|
57 | Install dev dependencies:
|
58 |
|
59 | ```sh
|
60 | $ npm install -d && npm test
|
61 | ```
|
62 |
|
63 | ### Author
|
64 |
|
65 | **Jon Schlinkert**
|
66 |
|
67 | * [github/jonschlinkert](https://github.com/jonschlinkert)
|
68 | * [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
|
69 |
|
70 | ### License
|
71 |
|
72 | Copyright © 2016, [Jon Schlinkert](https://github.com/jonschlinkert).
|
73 | Released under the [MIT license](https://github.com/jonschlinkert/array-unique/blob/master/LICENSE).
|
74 |
|
75 | ***
|
76 |
|
77 | _This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.1.28, on July 31, 2016._ |
\ | No newline at end of file |