Number.isInteger()

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.

Number.isInteger() は静的メソッドで、渡された値が整数かどうかを判定します。

試してみましょう

構文

js
Number.isInteger(value)

引数

value

整数かどうかを判定される値です。

返値

論理値で、渡された値が整数であれば true です。それ以外の場合は false です。

解説

指定された値が整数の場合は true を返し、そうでない場合は false を返します。NaN もしくは Infinity の場合も false を返します。このメソッドは整数として表すことができる浮動小数点数も true を返します。値が数値でない場合は常に false を返します。

数値リテラルの中には、ECMAScript の浮動小数点数エンコーディング (IEEE-754) の精度制限により、整数でないように見えても実は整数を表しているものがあることに注意してください。例えば、5.000000000000000151e-16 だけ異なりますが、これは小さすぎて表しきれません。(参考までに、Number.EPSILON は、1 と 1 より大きい次の表現可能な浮動小数点数の間の距離を格納しており、それはおよそ 2.22e-16 です)。したがって、5.00000000000000015 と同じエンコーディングで表されますので、Number.isInteger(5.000000000001)true を返すことになります。

同様の意味で、Number.MAX_SAFE_INTEGER の大きさ前後の数値は精度を失い、整数でなくても Number.isIntegertrueを返すようになる。(実際の閾値は、10 進数を表すのに何ビット必要かによって変わります。例えば、 Number.isInteger(450000000000.1)true ですが、 Number.isInteger(450000000000.5)false です。)

isInteger の使用

js
Number.isInteger(0); // true
Number.isInteger(1); // true
Number.isInteger(-100000); // true
Number.isInteger(99999999999999999999999); // true

Number.isInteger(0.1); // false
Number.isInteger(Math.PI); // false

Number.isInteger(NaN); // false
Number.isInteger(Infinity); // false
Number.isInteger(-Infinity); // false
Number.isInteger("10"); // false
Number.isInteger(true); // false
Number.isInteger(false); // false
Number.isInteger([1]); // false

Number.isInteger(5.0); // true
Number.isInteger(5.000000000000001); // false
Number.isInteger(5.0000000000000001); // true(精度が落ちるため)
Number.isInteger(4500000000000000.1); // true(精度が落ちるため)

仕様書

Specification
ECMAScript Language Specification
# sec-number.isinteger

ブラウザーの互換性

BCD tables only load in the browser

関連情報