es-toolkit/dist/bigint/minBy.js

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

//#region src/bigint/minBy.ts
/**
* Finds the element in an array that has the smallest bigint value returned by `getValue`.
*
* This function maps every element to a bigint and returns the element with the smallest value.
* If several elements tie, the first one is returned.
*
* @template T - The type of elements in the array.
* @param items - An array of elements to search.
* @param getValue - A function that maps an element to the bigint to compare by.
* @returns The element with the smallest mapped bigint.
* @throws {RangeError} If the array is empty, since there is no element to return.
*
* @example
* const accounts = [{ balance: 10n }, { balance: 30n }, { balance: 20n }];
* const result = minBy(accounts, account => account.balance);
* // result will be { balance: 10n }
*/
function minBy(items, getValue) {
	if (items.length === 0) throw new RangeError("Cannot find the minimum of an empty array.");
	let minElement = items[0];
	let min = getValue(items[0], 0, items);
	for (let i = 1; i < items.length; i++) {
		const element = items[i];
		const value = getValue(element, i, items);
		if (value < min) {
			min = value;
			minElement = element;
		}
	}
	return minElement;
}
//#endregion
exports.minBy = minBy;