min (Lodash 兼容性)

::: warning 请使用 Math.min

这个 min 函数由于额外的函数调用和 null/undefined 处理会运行较慢。

请使用更快、更现代的 Math.min(...array)。

:::

在数组中查找最小值。

typescript

const result = min(items);

用法

`min(items?)`

当您想要在数组中查找最小值时，请使用 min。

typescript

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

// 数字数组中的最小值
min([3, 1, 4, 1, 5, 9]);
// Returns: 1

min([10, 5, 8, 20]);
// Returns: 5

// 字符串数组中的最小值（按字典序）
min(['c', 'a', 'b']);
// Returns: 'a'

min(['cherry', 'apple', 'banana']);
// Returns: 'apple'

// 空数组或 null/undefined
min([]);
// Returns: undefined

min(null);
// Returns: undefined

min(undefined);
// Returns: undefined

负数也能正确处理。

typescript

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

min([0, -3, 2, 8, 7]);
// Returns: -3

min([-1, -5, -3]);
// Returns: -5

参数

items (ArrayLike<T> | null | undefined, 可选): 要查找最小值的数组。

返回值

(T | undefined): 返回数组中的最小值。如果数组为空或为 null/undefined，则返回 undefined。