Math.min()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Math.min() 函数返回作为输入参数的数字中最小的一个，如果没有参数，则返回 Infinity。

尝试一下

console.log(Math.min(2, 3, 1)); // Expected output: 1 console.log(Math.min(-2, -3, -1)); // Expected output: -3 const array1 = [2, 3, 1]; console.log(Math.min(...array1)); // Expected output: 1

语法

Math.min() Math.min(value0) Math.min(value0, value1) Math.min(value0, value1, /* … ,*/ valueN)

参数

value1, …, valueN: 0 个或多个数字，将在其中选择，并返回最小值。

返回值

给定数值中最小的数。如果任一参数不能转换为数值，则返回 NaN。如果没有提供参数，返回 Infinity。

描述

因为 min() 是 Math 的静态方法，所以你应始终使用 Math.min()，而不是作为你创建的 Math 对象的方法（Math 不是构造函数）。

Math.min.length 是 2，这从某种程度上表明了它旨在处理至少两个参数。

示例

使用 Math.min()

下例找出 x 和 y 的最小值，并把它赋值给 z：

const x = 10; const y = -20; const z = Math.min(x, y); // -20

使用 Math.min() 裁剪值

Math.min() 经常用于裁剪一个值，以便使其总是小于或等于某个边界值。例如：

let x = f(foo); if (x > boundary) { x = boundary; }

可以写成：

const x = Math.min(f(foo), boundary);

Math.max() 可以以类似的方式用于在另一端裁剪一个值。

规范

Specification
ECMAScript® 2026 Language Specification # sec-math.min

浏览器兼容性

参见

Math.max()