es-toolkit/dist/bigint/min.js

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

//#region src/bigint/min.ts
/**
* Finds the smallest bigint in an array.
*
* This function iterates through the array and returns the smallest element. Unlike `Math.min`,
* which cannot accept bigints, it compares values directly so arbitrarily large integers stay exact.
*
* @param nums - An array of bigints to search.
* @returns The smallest bigint in the array.
* @throws {RangeError} If the array is empty, since there is no bigint that represents "no minimum".
*
* @example
* const result = min([1n, 5n, 3n]);
* // result will be 1n
*/
function min(nums) {
	if (nums.length === 0) throw new RangeError("Cannot find the minimum of an empty array.");
	let result = nums[0];
	for (let i = 1; i < nums.length; i++) if (nums[i] < result) result = nums[i];
	return result;
}
//#endregion
exports.min = min;