1 | # array-unique [![NPM version](https://img.shields.io/npm/v/array-unique.svg?style=flat)](https://www.npmjs.com/package/array-unique) [![NPM downloads](https://img.shields.io/npm/dm/array-unique.svg?style=flat)](https://npmjs.org/package/array-unique) [![Build Status](https://img.shields.io/travis/jonschlinkert/array-unique.svg?style=flat)](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._ |
---|