30 lines
1.4 KiB
JavaScript
Raw Normal View History

2026-05-31 13:21:13 +02:00
const require_differenceWith = require("./differenceWith.js");
const require_intersectionWith = require("./intersectionWith.js");
const require_unionWith = require("./unionWith.js");
//#region src/array/xorWith.ts
/**
* Computes the symmetric difference between two arrays using a custom equality function.
* The symmetric difference is the set of elements which are in either of the arrays,
* but not in their intersection.
*
* @template T - Type of elements in the input arrays.
*
* @param {T[]} arr1 - The first array.
* @param {T[]} arr2 - The second array.
* @param {(item1: T, item2: T) => boolean} areElementsEqual - The custom equality function to compare elements.
* @returns {T[]} An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the custom equality function.
*
* @example
* // Custom equality function for objects with an 'id' property
* const areObjectsEqual = (a, b) => a.id === b.id;
* xorWith([{ id: 1 }, { id: 2 }], [{ id: 2 }, { id: 3 }], areObjectsEqual);
* // Returns [{ id: 1 }, { id: 3 }]
*/
function xorWith(arr1, arr2, areElementsEqual) {
const union = require_unionWith.unionWith(arr1, arr2, areElementsEqual);
const intersection = require_intersectionWith.intersectionWith(arr1, arr2, areElementsEqual);
return require_differenceWith.differenceWith(union, intersection, areElementsEqual);
}
//#endregion
exports.xorWith = xorWith;