\begin{quote}
Combines a list of arrays, returning a single array with unique values, using strict equality for comparisons. \end{quote}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3178}{}\doxysection{Install}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3178}
Install with \href{https://www.npmjs.com/}{\texttt{ npm}}\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{\$ npm i arr-\/union -\/-\/save }

\end{DoxyCode}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3179}{}\doxysection{Benchmarks}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3179}
This library is {\bfseries{10-\/20 times faster}} and more performant than \href{https://github.com/sindresorhus/array-union}{\texttt{ array-\/union}}.

See the \href{./benchmark}{\texttt{ benchmarks}}.


\begin{DoxyCode}{0}
\DoxyCodeLine{\#1: five-\/arrays}
\DoxyCodeLine{  array-\/union x 511,121 ops/sec ±0.80\% (96 runs sampled)}
\DoxyCodeLine{  arr-\/union x 5,716,039 ops/sec ±0.86\% (93 runs sampled)}
\DoxyCodeLine{}
\DoxyCodeLine{\#2: ten-\/arrays}
\DoxyCodeLine{  array-\/union x 245,196 ops/sec ±0.69\% (94 runs sampled)}
\DoxyCodeLine{  arr-\/union x 1,850,786 ops/sec ±0.84\% (97 runs sampled)}
\DoxyCodeLine{}
\DoxyCodeLine{\#3: two-\/arrays}
\DoxyCodeLine{  array-\/union x 563,869 ops/sec ±0.97\% (94 runs sampled)}
\DoxyCodeLine{  arr-\/union x 9,602,852 ops/sec ±0.87\% (92 runs sampled) }

\end{DoxyCode}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3180}{}\doxysection{Usage}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3180}

\begin{DoxyCode}{0}
\DoxyCodeLine{var union = require('arr-\/union');}
\DoxyCodeLine{}
\DoxyCodeLine{union(['a'], ['b', 'c'], ['d', 'e', 'f']);}
\DoxyCodeLine{//=> ['a', 'b', 'c', 'd', 'e', 'f'] }

\end{DoxyCode}


Returns only unique elements\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{union(['a', 'a'], ['b', 'c']);}
\DoxyCodeLine{//=> ['a', 'b', 'c'] }

\end{DoxyCode}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3181}{}\doxysection{Related projects}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3181}

\begin{DoxyItemize}
\item \href{https://www.npmjs.com/package/arr-diff}{\texttt{ arr-\/diff}}\+: Returns an array with only the unique values from the first array, by excluding all… \href{https://www.npmjs.com/package/arr-diff}{\texttt{ more}} $\vert$ \href{https://github.com/jonschlinkert/arr-diff}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/arr-filter}{\texttt{ arr-\/filter}}\+: Faster alternative to javascript\textquotesingle{}s native filter method. $\vert$ \href{https://github.com/jonschlinkert/arr-filter}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/arr-flatten}{\texttt{ arr-\/flatten}}\+: Recursively flatten an array or arrays. This is the fastest implementation of array flatten. $\vert$ \href{https://github.com/jonschlinkert/arr-flatten}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/arr-map}{\texttt{ arr-\/map}}\+: Faster, node.\+js focused alternative to Java\+Script\textquotesingle{}s native array map. $\vert$ \href{https://github.com/jonschlinkert/arr-map}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/arr-pluck}{\texttt{ arr-\/pluck}}\+: Retrieves the value of a specified property from all elements in the collection. $\vert$ \href{https://github.com/jonschlinkert/arr-pluck}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/arr-reduce}{\texttt{ arr-\/reduce}}\+: Fast array reduce that also loops over sparse elements. $\vert$ \href{https://github.com/jonschlinkert/arr-reduce}{\texttt{ homepage}}
\item \href{https://www.npmjs.com/package/array-unique}{\texttt{ array-\/unique}}\+: Return an array free of duplicate values. Fastest ES5 implementation. $\vert$ \href{https://github.com/jonschlinkert/array-unique}{\texttt{ homepage}}
\end{DoxyItemize}\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3182}{}\doxysection{Contributing}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3182}
Pull requests and stars are always welcome. For bugs and feature requests, \href{https://github.com/jonschlinkert/arr-union/issues/new}{\texttt{ please create an issue}}.\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3183}{}\doxysection{Building docs}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3183}
Generate readme and API documentation with \href{https://github.com/verbose/verb}{\texttt{ verb}}\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{\$ npm i verb \&\& npm run docs }

\end{DoxyCode}


Or, if \href{https://github.com/verbose/verb}{\texttt{ verb}} is installed globally\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{\$ verb }

\end{DoxyCode}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3184}{}\doxysection{Running tests}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3184}
Install dev dependencies\+:


\begin{DoxyCode}{0}
\DoxyCodeLine{\$ npm i -\/d \&\& npm test }

\end{DoxyCode}
\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3185}{}\doxysection{Author}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3185}
{\bfseries{Jon Schlinkert}}


\begin{DoxyItemize}
\item \href{https://github.com/jonschlinkert}{\texttt{ github/jonschlinkert}}
\item \href{http://twitter.com/jonschlinkert}{\texttt{ twitter/jonschlinkert}}
\end{DoxyItemize}\hypertarget{md_sfcode_node_modules_arr_union_README_autotoc_md3186}{}\doxysection{License}\label{md_sfcode_node_modules_arr_union_README_autotoc_md3186}
Copyright © 2016 \href{https://github.com/jonschlinkert}{\texttt{ Jon Schlinkert}} Released under the \href{https://github.com/jonschlinkert/arr-union/blob/master/LICENSE}{\texttt{ MIT license}}.

\DoxyHorRuler{0}


{\itshape This file was generated by \href{https://github.com/verbose/verb}{\texttt{ verb}}, v0.\+9.\+0, on February 23, 2016.} 