[6a3a178] | 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._ |
---|