Skip to content

keyBy

Maps each element of an array based on a provided key-generating function.

This function takes an array and a function that generates a key from each element. It returns an object where the keys are the generated keys and the values are the corresponding elements. If there are multiple elements generating the same key, the last element among them is used as the value.

Signature

typescript
function keyBy<T, K extends PropertyKey>(arr: T[], getKeyFromItem: (item: T) => K): Record<K, T>;

Parameters

  • arr (T[]): The array of elements to be mapped.
  • getKeyFromItem ((item: T) => K): A function that generates a key from an element.

Returns

(Record<K, T>) An object where keys are mapped to each element of an array.

Examples

typescript
import { 
keyBy
} from 'js-utils-es/array';
const
array
= [
{
category
: 'fruit',
name
: 'apple' },
{
category
: 'fruit',
name
: 'banana' },
{
category
: 'vegetable',
name
: 'carrot' },
]; const
result
=
keyBy
(
array
,
item
=>
item
.
category
);
// result will be: // { // fruit: { category: 'fruit', name: 'banana' }, // vegetable: { category: 'vegetable', name: 'carrot' } // }

Source

SourceDocsTest Case

Contributors

Changelog

No recent changes

Made with ❤️