README.md
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._