29 lines
1.3 KiB
JavaScript
29 lines
1.3 KiB
JavaScript
|
import { differenceBy } from "./differenceBy.mjs";
|
||
|
|
import { intersectionBy } from "./intersectionBy.mjs";
|
||
|
|
import { unionBy } from "./unionBy.mjs";
|
||
|
|
//#region src/array/xorBy.ts
|
||
|
|
/**
|
||
|
|
* Computes the symmetric difference between two arrays using a custom mapping function.
|
||
|
|
* The symmetric difference is the set of elements which are in either of the arrays,
|
||
|
|
* but not in their intersection, determined by the result of the mapping function.
|
||
|
|
*
|
||
|
|
* @template T - Type of elements in the input arrays.
|
||
|
|
* @template U - Type of the values returned by the mapping function.
|
||
|
|
*
|
||
|
|
* @param {T[]} arr1 - The first array.
|
||
|
|
* @param {T[]} arr2 - The second array.
|
||
|
|
* @param {(item: T) => U} mapper - The function to map array elements to comparison values.
|
||
|
|
* @returns {T[]} An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the values returned by the mapping function.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Custom mapping function for objects with an 'id' property
|
||
|
|
* const idMapper = obj => obj.id;
|
||
|
|
* xorBy([{ id: 1 }, { id: 2 }], [{ id: 2 }, { id: 3 }], idMapper);
|
||
|
|
* // Returns [{ id: 1 }, { id: 3 }]
|
||
|
|
*/
|
||
|
|
function xorBy(arr1, arr2, mapper) {
|
||
|
|
return differenceBy(unionBy(arr1, arr2, mapper), intersectionBy(arr1, arr2, mapper), mapper);
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
export { xorBy };
|