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(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)
引数
value1
, …,valueN
-
最小値が選択して返される 0 個以上の数値です。
返値
解説
min()
は Math
の静的メソッドなので、常に Math.min()
として使用し、自分で Math
オブジェクトを生成してそのメソッドとして使用しないでください。 (Math
にはコンストラクターがありません)。
Math.min.length
は 2 であり、少なくとも 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® 2025 Language Specification # sec-math.min |
ブラウザーの互換性
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
min |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support