difference

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

const result = difference(firstArr, secondArr);

参考

difference(firstArr, secondArr)

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

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']

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

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

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

参数

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

返回值

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

性能对比

	Bundle Size	Performance
es-toolkit	90 字节 (小 92.4%)	9,317,227 次 (快 85%)
lodash-es	7,958 字节	5,030,861 次