UNPKG

es-toolkit

Version:

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

27 lines (26 loc) 952 B
import { keyBy as keyBy$1 } from "../../array/keyBy.mjs"; //#region src/fp/array/keyBy.ts /** * Creates a function that indexes values by a derived key. * * The key selector receives each value, index, and full input array. When multiple values * produce the same key, the last value wins, matching the main {@link keyBy} behavior. * * @template T - The type of elements in the array. * @template K - The property-key type produced by the selector. * @param getKey - Called with each value, index, and array to produce an object key. * @returns A function that maps a readonly array to an object keyed by the derived keys. * * @example * import { keyBy, pipe } from 'es-toolkit/fp'; * * pipe([{ id: 'a', value: 1 }, { id: 'b', value: 2 }], keyBy(item => item.id)); * // => { a: { id: 'a', value: 1 }, b: { id: 'b', value: 2 } } */ function keyBy(getKey) { return function(array) { return keyBy$1(array, getKey); }; } //#endregion export { keyBy };