minBy (BigInt)

배열에서 함수가 계산한 BigInt 값이 가장 작은 요소를 반환해요.

const smallest = minBy(items, getValue);

INFO

이 함수는 다른 숫자 타입의 유사한 함수와의 잠재적 충돌을 피하기 위해 es-toolkit/bigint에서만 사용할 수 있어요.

사용법

minBy(items, getValue)

비교하고 싶은 BigInt가 객체 안에 있고 숫자가 아니라 객체 전체를 돌려받고 싶을 때 minBy를 사용하세요. 각 요소에서 값을 꺼내는 함수를 넘겨주세요.

import { minBy } from 'es-toolkit/bigint';

const accounts = [
  { owner: 'alice', balance: 10n },
  { owner: 'bob', balance: 30n },
  { owner: 'carol', balance: 20n },
];

const poorest = minBy(accounts, account => account.balance);
console.log(poorest); // { owner: 'alice', balance: 10n }

가장 작은 값이 여러 개로 같으면, 가장 먼저 나온 요소가 반환돼요. getValue는 인덱스와 배열 전체도 함께 받아요.

import { minBy } from 'es-toolkit/bigint';

const first = { id: 'a', score: 10n };
const second = { id: 'b', score: 10n };
console.log(minBy([first, second], item => item.score)); // { id: 'a', score: 10n }

빈 배열은 반환할 요소가 없기 때문에 에러를 던져요.

import { minBy } from 'es-toolkit/bigint';

minBy([], () => 0n); // RangeError: Cannot find the minimum of an empty array.

파라미터

• items (readonly T[]): 탐색할 요소 배열이에요.
• getValue ((element: T, index: number, array: readonly T[]) => bigint): 비교 기준이 되는 BigInt를 반환하는 함수예요.

반환 값

(T): 계산된 BigInt가 가장 작은 요소를 반환해요. 값이 같은 요소가 여러 개면 그중 첫 번째 요소를 반환해요.

에러

배열이 비어 있으면 RangeError를 던져요.