package/package.json000644 000765 000024 0000002705 12663053073013026 0ustar00000000 000000 { "name": "arr-union", "description": "Combines a list of arrays, returning a single array with unique values, using strict equality for comparisons.", "version": "3.1.0", "homepage": "https://github.com/jonschlinkert/arr-union", "author": "Jon Schlinkert (https://github.com/jonschlinkert)", "repository": "jonschlinkert/arr-union", "bugs": { "url": "https://github.com/jonschlinkert/arr-union/issues" }, "license": "MIT", "files": [ "index.js" ], "main": "index.js", "engines": { "node": ">=0.10.0" }, "scripts": { "test": "mocha" }, "devDependencies": { "ansi-bold": "^0.1.1", "array-union": "^1.0.1", "array-unique": "^0.2.1", "benchmarked": "^0.1.4", "gulp-format-md": "^0.1.7", "minimist": "^1.1.1", "mocha": "*", "should": "*" }, "keywords": [ "add", "append", "array", "arrays", "combine", "concat", "extend", "union", "uniq", "unique", "util", "utility", "utils" ], "verb": { "run": true, "toc": false, "layout": "default", "tasks": [ "readme" ], "plugins": [ "gulp-format-md" ], "related": { "list": [ "arr-diff", "arr-flatten", "arr-filter", "arr-map", "arr-pluck", "arr-reduce", "array-unique" ] }, "reflinks": [ "verb", "array-union" ], "lint": { "reflinks": true } } } package/README.md000644 000765 000024 0000006754 12663006712012025 0ustar00000000 000000 # arr-union [![NPM version](https://img.shields.io/npm/v/arr-union.svg)](https://www.npmjs.com/package/arr-union) [![Build Status](https://img.shields.io/travis/jonschlinkert/arr-union.svg)](https://travis-ci.org/jonschlinkert/arr-union) > Combines a list of arrays, returning a single array with unique values, using strict equality for comparisons. ## Install Install with [npm](https://www.npmjs.com/): ```sh $ npm i arr-union --save ``` ## Benchmarks This library is **10-20 times faster** and more performant than [array-union](https://github.com/sindresorhus/array-union). See the [benchmarks](./benchmark). ```sh #1: five-arrays array-union x 511,121 ops/sec ±0.80% (96 runs sampled) arr-union x 5,716,039 ops/sec ±0.86% (93 runs sampled) #2: ten-arrays array-union x 245,196 ops/sec ±0.69% (94 runs sampled) arr-union x 1,850,786 ops/sec ±0.84% (97 runs sampled) #3: two-arrays array-union x 563,869 ops/sec ±0.97% (94 runs sampled) arr-union x 9,602,852 ops/sec ±0.87% (92 runs sampled) ``` ## Usage ```js var union = require('arr-union'); union(['a'], ['b', 'c'], ['d', 'e', 'f']); //=> ['a', 'b', 'c', 'd', 'e', 'f'] ``` Returns only unique elements: ```js union(['a', 'a'], ['b', 'c']); //=> ['a', 'b', 'c'] ``` ## Related projects * [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://www.npmjs.com/package/arr-diff) | [homepage](https://github.com/jonschlinkert/arr-diff) * [arr-filter](https://www.npmjs.com/package/arr-filter): Faster alternative to javascript's native filter method. | [homepage](https://github.com/jonschlinkert/arr-filter) * [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) * [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) * [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) * [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) * [array-unique](https://www.npmjs.com/package/array-unique): Return an array free of duplicate values. Fastest ES5 implementation. | [homepage](https://github.com/jonschlinkert/array-unique) ## Contributing Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/arr-union/issues/new). ## Building docs Generate readme and API documentation with [verb](https://github.com/verbose/verb): ```sh $ npm i verb && npm run docs ``` Or, if [verb](https://github.com/verbose/verb) is installed globally: ```sh $ verb ``` ## Running tests Install dev dependencies: ```sh $ npm i -d && npm test ``` ## Author **Jon Schlinkert** * [github/jonschlinkert](https://github.com/jonschlinkert) * [twitter/jonschlinkert](http://twitter.com/jonschlinkert) ## License Copyright © 2016 [Jon Schlinkert](https://github.com/jonschlinkert) Released under the [MIT license](https://github.com/jonschlinkert/arr-union/blob/master/LICENSE). *** _This file was generated by [verb](https://github.com/verbose/verb), v0.9.0, on February 23, 2016._package/LICENSE000644 000765 000024 0000002100 12662744730011540 0ustar00000000 000000 The MIT License (MIT) Copyright (c) 2014-2016, Jon Schlinkert. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. package/index.js000644 000765 000024 0000001017 12662744627012213 0ustar00000000 000000 'use strict'; module.exports = function union(init) { if (!Array.isArray(init)) { throw new TypeError('arr-union expects the first argument to be an array.'); } var len = arguments.length; var i = 0; while (++i < len) { var arg = arguments[i]; if (!arg) continue; if (!Array.isArray(arg)) { arg = [arg]; } for (var j = 0; j < arg.length; j++) { var ele = arg[j]; if (init.indexOf(ele) >= 0) { continue; } init.push(ele); } } return init; };