Math.min()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Math.min() 靜態方法返回輸入引數中最小的數字,如果沒有引數則返回 Infinity

試一試

console.log(Math.min(2, 3, 1));
// Expected output: 1

console.log(Math.min(-2, -3, -1));
// Expected output: -3

const array = [2, 3, 1];

console.log(Math.min(...array));
// Expected output: 1

語法

js
Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)

引數

value1, …, valueN

零個或多個數字,將從中選擇並返回最小的值。

返回值

給定數字中最小的那個。如果任何引數是或被轉換為 NaN,則返回 NaN。如果沒有提供引數,則返回 Infinity

描述

因為 min()Math 的一個靜態方法,所以你總是使用 Math.min() 來呼叫它,而不是使用你建立的 Math 物件的某個方法(Math 不是一個建構函式)。

Math.min.length 的值為 2,這在一定程度上表明它被設計為至少處理兩個引數。

示例

使用 Math.min()

這會找出 xy 的最小值,並將其賦給 z

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

使用 Math.min() 裁剪值

Math.min() 通常用於裁剪值,使其始終小於或等於一個邊界。例如,這

js
let x = f(foo);

if (x > boundary) {
  x = boundary;
}

可以這樣寫

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

Math.max() 也可以用於在另一端裁剪值。

規範

規範
ECMAScript® 2026 語言規範
# sec-math.min

瀏覽器相容性

另見