JavaScript Number.isSafeInteger()メソッド

Number 对象参考手册JavaScript Number オブジェクト

例

引数が「安全な整数」であるかどうかをチェックします:

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);

試してみる »

Number 对象参考手册JavaScript Number オブジェクト

その他の拡張