#medianBy (for BigInts) es-toolkit

Returns the middle of the BigInts that a function derives from each element of an array.

const middle = medianBy(items, getValue);

#Usage

#medianBy(items, getValue)

Use medianBy when the BigInts you want the median of are inside objects. Pass a function that pulls the value out of each element, and it takes the median of everything that function returns.

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

const accounts = [{ balance: 10n }, { balance: 30n }, { balance: 20n }];
const middle = medianBy(accounts, account => account.balance);
console.log(middle); // 20n

Just like median, an even number of elements averages the two middle values and truncates toward zero, and an empty array throws.

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

const payments = [{ amount: 1n }, { amount: 2n }, { amount: 3n }, { amount: 4n }];
console.log(medianBy(payments, payment => payment.amount)); // 2n

medianBy([], () => 0n); // RangeError: Cannot compute the median of an empty array.

#Parameters

#Returns

Returns the median of every value returned by getValue. For an even number of elements, returns the average of the two middle values, truncated toward zero.

bigint

#Throws

Throws a RangeError if the array is empty.