es-toolkit/docs/reference/array/xorBy.md

29 lines
844 B
Markdown
Raw Normal View History

2024-04-25 14:56:13 +03:00
# xorBy
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,
2024-04-25 14:56:13 +03:00
but not in their intersection, determined by the result of the mapping function.
## Signature
```typescript
function xorBy<T, U>(arr1: T[], arr2: T[], mapper: (item: T) => U): T[];
```
### Parameters
2024-04-25 14:56:13 +03:00
- `arr1` (`T[]`): The first array.
- `arr2` (`T[]`): The second array.
- `mapper` (`(item: T) => U`): 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.
## Examples
```typescript
// Returns [{ id: 1 }, { id: 3 }]
xorBy([{ id: 1 }, { id: 2 }], [{ id: 2 }, { id: 3 }], x => x.id);
```