JavaScript Number.isSafeInteger()メソッド
例
引数が「安全な整数」であるかどうかをチェックします:
Number.isSafeInteger(123);
Number.isSafeInteger(-123);
Number.isSafeInteger('123');
Number.isSafeInteger(5-2);
Number.isSafeInteger(0);
Number.isSafeInteger(0.5);
Number.isSafeInteger(0/0);
試してみる »
定義と使い方
isSafeInteger() メソッドは、渡された引数の値が「安全な整数」(safe integer)であるかどうかを判定します。安全な整数の場合は true を返し、それ以外の場合は false を返します。
安全な整数とは、次の条件を満たす整数です:
- IEEE-754 倍精度浮動小数点数として正確に表現できること。
- その IEEE-754 表現が、他の整数を IEEE-754 表現に適合させるために丸めた結果ではないこと。
例えば、2^53 - 1 は安全な整数です。正確に表現でき、いかなる IEEE-754 の丸めモード(rounding mode)でも、他の整数が丸められてこの整数になることはありません。対照的に、2^53 は安全な整数ではありません。IEEE-754 で表現できますが、2^53 + 1 は IEEE-754 で直接表現できず、最近接丸め(round-to-nearest)およびゼロ方向への丸めでは 2^53 に丸められます。
安全な整数の範囲は、-(2^53 - 1) から 2^53 - 1 までの整数で、-(2^53 - 1) と 2^53 - 1 を含みます。
Number.isSafeInteger(3); // true
Number.isSafeInteger(Math.pow(2, 53)) // false
Number.isSafeInteger(Math.pow(2, 53) - 1) // true
Number.isSafeInteger(NaN); // false
Number.isSafeInteger(Infinity); // false
Number.isSafeInteger("3"); // false
Number.isSafeInteger(3.1); // false
Number.isSafeInteger(3.0); // true
ブラウザ対応
Number.isSafeInteger() は ECMAScript6 (ES6) の新機能です。
基本的に最新のブラウザバージョンはすべて ES6 (JavaScript 2015) をサポートしています。
Number.isSafeInteger() は Internet Explorer 11 およびそれより前のバージョンのブラウザではサポートされていません。
| Chrome | Edge | Firefox | Safari | Opera |
| Yes | Yes | Yes | Yes | Yes |
構文
Number.isSafeInteger(value)
パラメータ値
| 引数 | 説明 |
|---|---|
| value | 判定する値。 |
戻り値
| 型 | 説明 |
|---|---|
| ブール型 | 安全な整数の場合は true を返し、それ以外の場合は false を返します。 |
技術詳細
| JavaScript バージョン: | ECMAScript 6 |
|---|
その他の例
例
引数が安全な整数かどうかをチェックします:
Number.isSafeInteger(Math.pow(2, 53));
Number.isSafeInteger(Math.pow(2, 53) - 1);
Number.isSafeInteger(true);
Number.isSafeInteger(false);
Number.isSafeInteger(Infinity);
Number.isSafeInteger(-Infinity);
試してみる »
JavaScript Number オブジェクト