# difference

返回一个新数组,包含第一个数组中排除第二个数组元素后的结果。

```typescript
const result = difference(firstArr, secondArr);
```

## 用法

### `difference(firstArr, secondArr)`

当您想求两个数组的差集时,请使用 `difference`。返回一个新数组,包含只在第一个数组中存在而第二个数组中不存在的元素。

```typescript
import { difference } from 'es-toolkit/array';

// 求数字数组的差集。
const array1 = [1, 2, 3, 4, 5];
const array2 = [2, 4];
difference(array1, array2);
// 返回: [1, 3, 5]
// 2 和 4 在两个数组中都存在,所以被排除。

// 求字符串数组的差集。
const colors1 = ['red', 'blue', 'green'];
const colors2 = ['blue', 'yellow'];
difference(colors1, colors2);
// 返回: ['red', 'green']
```

与空数组的差集等于原数组。

```typescript
import { difference } from 'es-toolkit/array';

difference([1, 2, 3], []); // [1, 2, 3]
difference([], [1, 2, 3]); // []
```

#### 参数

- `firstArr` (`T[]`): 作为差集基准的数组。
- `secondArr` (`T[]`): 包含要从第一个数组中排除的元素的数组。

#### 返回值

(`T[]`): 包含只在第一个数组中存在而第二个数组中不存在的元素的新数组。
