max (for BigInts) ​

Returns the largest BigInt in an array.

const largest = max(numbers);

Usage ​

max(nums) ​

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

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

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

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

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

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

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

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

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

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

Parameters ​

• nums (readonly bigint[]): The array of BigInts to search.

Returns ​

(bigint): Returns the largest BigInt in the array.

Throws ​

Throws a RangeError if the array is empty.