Skip to content

min

INFO

This function is only available in es-toolkit/compat for compatibility reasons. It either has alternative native JavaScript APIs or isn’t fully optimized yet.

When imported from es-toolkit/compat, it behaves exactly like lodash and provides the same functionalities, as detailed here.

Finds the element in an array that has the minimum value.

Signature

typescript
function min<T>(items: [T, ...T[]]): T;
function min(): undefined;
function min<T>(items?: ArrayLike<T> | null | undefined): T | undefined;

Parameters

  • items (ArrayLike<T> | null | undefined): The array of elements to search.

Returns

(T | undefined): The element with the minimum value, or undefined if the array is empty, null, or undefined.

Example

typescript
min([1, 2, 3]); // Returns: 1
min(['a', 'b']); // Returns: 'a'

Released under the MIT License.