isFinite()

グローバル関数 isFinite() は渡された値が有限数かどうかを判定します。必要に応じて、引数はまず数値へと変換されます。

このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。

構文

isFinite(testValue)

引数

testValue

有限性の評価を行いたい値。

返値

正または負の Infinity か NaN の場合は false です。それ以外の場合は true です。

解説

isFinite は最上位関数で、どのオブジェクトにも関連付けされません。

この関数を使用すると、ある数値が有限数かどうかを判定できます。 isFinite 関数はその引数内の数値を調査します。この関数は、引数が NaN、正の無限大、負の無限大のいずれかの場合に false を返し、それ以外は true を返します。

使用例

isFinite(Infinity);  // false
isFinite(NaN);       // false
isFinite(-Infinity); // false

isFinite(0);         // true
isFinite(2e64);      // true
isFinite(910);       // true

isFinite(null);      // true, would've been false with the 
                     // more robust Number.isFinite(null)

isFinite('0');       // true が返される、より堅牢性の高い
                     // Number.isFinite("0") では false となる

仕様書

ブラウザーの互換性

関連情報

• Number.isFinite()
• Number.NaN
• Number.POSITIVE_INFINITY
• Number.NEGATIVE_INFINITY