Returns an array with only the unique values present in all given arrays using strict equality for comparisons.
JavaScript
Latest commit 51202a8 May 7, 2016 @jonschlinkert 3.0
Permalink
Failed to load latest commit information.
benchmark update benchmarks May 7, 2016
.editorconfig use eslint. lint Dec 6, 2015
.eslintrc.json run `update`, lint May 7, 2016
.gitattributes first commit Sep 26, 2014
.gitignore first commit Sep 26, 2014
.travis.yml run `update`, lint May 7, 2016
.verb.md generate docs May 7, 2016
LICENSE run `update`, lint May 7, 2016
README.md generate docs May 7, 2016
bower.json run `update`, lint May 7, 2016
index.js faster implementation May 7, 2016
package.json 3.0 May 7, 2016
test.js faster implementation May 7, 2016

README.md

arr-diff NPM version NPM downloads Build Status

Returns an array with only the unique values from the first array, by excluding all values from additional arrays using strict equality for comparisons.

Install

Install with npm:

$ npm install arr-diff --save

Install with bower

$ bower install arr-diff --save

Usage

Returns the difference between the first array and additional arrays.

var diff = require('arr-diff');

var a = ['a', 'b', 'c', 'd'];
var b = ['b', 'c'];

console.log(diff(a, b))
//=> ['a', 'd']

Benchmarks

This library versus array-differ, on May 07, 2016:

# benchmark/fixtures/long.js (94529 bytes)
  current x 1,246 ops/sec ±0.98% (85 runs sampled)
  array-differ x 993 ops/sec ±1.35% (87 runs sampled)

# benchmark/fixtures/med.js (708 bytes)
  current x 583,612 ops/sec ±1.24% (87 runs sampled)
  array-differ x 464,480 ops/sec ±1.42% (85 runs sampled)

# benchmark/fixtures/short.js (60 bytes)
  current x 788,823 ops/sec ±0.95% (89 runs sampled)
  array-differ x 521,483 ops/sec ±1.65% (86 runs sampled)

Related projects

You might also be interested in these projects:

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.


This file was generated by verb, v0.9.0, on May 07, 2016.