# array-difference-x

> Creates an array of array values not included in the other given arrays.

Latest version **3.1.2** (published 2019-08-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install array-difference-x
pnpm add array-difference-x
yarn add array-difference-x
bun add array-difference-x
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.1.2 |
| Published | 2019-08-28 |
| First published | 2017-08-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=8.11.4 |
| Dependencies | 5 |
| Unpacked size | 402.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Graham Fairweather |
| Maintainers | xotic750 |
| Keywords | array, difference, module, javascript, nodejs, browser |

## Links

- npm: https://www.npmjs.com/package/array-difference-x
- Repository: https://github.com/Xotic750/array-difference-x
- Issues: https://github.com/Xotic750/array-difference-x/issues
- npm.io page: https://npm.io/package/array-difference-x

## Dependencies (5)

- [is-nil-x](https://npm.io/package/is-nil-x.md) ^2.1.1
- [array-some-x](https://npm.io/package/array-some-x.md) ^3.1.2
- [array-filter-x](https://npm.io/package/array-filter-x.md) ^3.1.2
- [array-includes-x](https://npm.io/package/array-includes-x.md) ^3.1.2
- [array-like-slice-x](https://npm.io/package/array-like-slice-x.md) ^2.2.2

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 3.1.2 (latest) — 2019-08-28
- 3.1.1 — 2019-08-20
- 3.1.0 — 2019-08-14
- 3.0.16 — 2019-08-05
- 3.0.15 — 2019-08-05
- 3.0.14 — 2019-07-31
- 3.0.13 — 2019-07-27
- 3.0.12 — 2019-07-27
- 3.0.11 — 2019-07-26
- 3.0.10 — 2019-07-25
- 3.0.9 — 2019-07-24
- 3.0.8 — 2019-07-24
- 3.0.7 — 2019-07-22
- 3.0.6 — 2019-07-22
- 3.0.5 — 2019-07-21
- … 8 more at https://npm.io/package/array-difference-x/versions

## README

<a
  href="https://travis-ci.org/Xotic750/array-difference-x"
  title="Travis status">
<img
  src="https://travis-ci.org/Xotic750/array-difference-x.svg?branch=master"
  alt="Travis status" height="18">
</a>
<a
  href="https://david-dm.org/Xotic750/array-difference-x"
  title="Dependency status">
<img src="https://david-dm.org/Xotic750/array-difference-x/status.svg"
  alt="Dependency status" height="18"/>
</a>
<a
  href="https://david-dm.org/Xotic750/array-difference-x?type=dev"
  title="devDependency status">
<img src="https://david-dm.org/Xotic750/array-difference-x/dev-status.svg"
  alt="devDependency status" height="18"/>
</a>
<a
  href="https://badge.fury.io/js/array-difference-x"
  title="npm version">
<img src="https://badge.fury.io/js/array-difference-x.svg"
  alt="npm version" height="18">
</a>
<a
  href="https://www.jsdelivr.com/package/npm/array-difference-x"
  title="jsDelivr hits">
<img src="https://data.jsdelivr.com/v1/package/npm/array-difference-x/badge?style=rounded"
  alt="jsDelivr hits" height="18">
</a>
<a
  href="https://bettercodehub.com/results/Xotic750/array-difference-x"
  title="bettercodehub score">
<img src="https://bettercodehub.com/edge/badge/Xotic750/array-difference-x?branch=master"
  alt="bettercodehub score" height="18">
</a>
<a
  href="https://coveralls.io/github/Xotic750/array-difference-x?branch=master"
  title="Coverage Status">
<img src="https://coveralls.io/repos/github/Xotic750/array-difference-x/badge.svg?branch=master"
  alt="Coverage Status" height="18">
</a>

<a name="module_array-difference-x"></a>

## array-difference-x

Creates an array of array values not included in the other given arrays.

<a name="exp_module_array-difference-x--module.exports"></a>

### `module.exports(array, [...exclude])` ⇒ <code>array</code> ⏏

This method creates an array of array values not included in the other given
arrays using SameValueZero for equality comparisons. The order and references
of result values are determined by the first array.

**Kind**: Exported function  
**Returns**: <code>array</code> - Returns the new array of filtered values.  
**Throws**:

- <code>TypeError</code> If array is null or undefined.

| Param        | Type               | Description            |
| ------------ | ------------------ | ---------------------- |
| array        | <code>array</code> | The array to inspect.  |
| [...exclude] | <code>array</code> | The values to exclude. |

**Example**

```js
import difference from 'array-difference-x';

console.log(difference([2, 1], [2, 3])); // => [1]
```

---
_Source: https://npm.io/package/array-difference-x · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._