#min (for BigInts) es-toolkit

Returns the smallest BigInt in an array.

const smallest = min(numbers);

#Usage

#min(nums)

Use min when you want the smallest of several BigInts. Math.min cannot accept BigInts at all, so this is the way to compare them.

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

const smallest = min([1n, 5n, 3n]);
console.log(smallest); // 1n

// Works with negative values
console.log(min([-5n, -1n, -3n])); // -5n

Because BigInts are compared exactly, values that number would round to the same thing stay distinguishable.

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

// As `number`, both of these are 9007199254740992
console.log(min([9007199254740993n, 9007199254740992n])); // 9007199254740992n

There is no BigInt that means "no minimum" — BigInt has no NaN and no Infinity — so an empty array throws instead of returning a placeholder.

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

min([]); // RangeError: Cannot find the minimum of an empty array.

#Parameters

#Returns

Returns the smallest BigInt in the array.

bigint

#Throws

Throws a RangeError if the array is empty.