本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

文字列を数値に変換する

Number() と parseInt() と単項プラスは、失敗したときの振る舞いが違います。空文字・全角・単位つき・カンマ区切りで何が起きるかを実行して確かめ、安全な書き方をまとめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

答え

Number() を使い、空文字を先に弾き、変換できたかを確かめます。

example.js

function toNumber(text) {
  const s = String(text).trim();
  if (s === '') return null;

  const n = Number(s);
  return Number.isFinite(n) ? n : null;
}

console.log(toNumber('42'));
console.log(toNumber('3.14'));
console.log(toNumber('42px'));
console.log(toNumber(''));
固定例の期待出力 · Node 24.22.3
42
3.14
null
null
表示用コードUTF-8 · LF

関門は2つあります。

  • 空文字を先に弾く … Number('') は NaN ではなく0になる
  • Number.isFinite() で確かめる … NaN も Infinity もまとめて落ちる

どちらも省くと静かに壊れます。理由はこのあと順に見ます。

上のコードは書き換えて実行できます。'42px' を ' 42 ' にしてみてください。

3つのやり方の違い

example.js

const inputs = ['42', '3.14', '42px', '', '  7 ', 'あ', '0x1f', '1e3'];

for (const s of inputs) {
  console.log(
    JSON.stringify(s).padEnd(8),
    'Number:', String(Number(s)).padEnd(6),
    'parseInt:', String(parseInt(s, 10)).padEnd(6),
    'parseFloat:', parseFloat(s),
  );
}
固定例の期待出力 · Node 24.22.3
"42"     Number: 42     parseInt: 42     parseFloat: 42
"3.14"   Number: 3.14   parseInt: 3      parseFloat: 3.14
"42px"   Number: NaN    parseInt: 42     parseFloat: 42
""       Number: 0      parseInt: NaN    parseFloat: NaN
"  7 "   Number: 7      parseInt: 7      parseFloat: 7
"あ"      Number: NaN    parseInt: NaN    parseFloat: NaN
"0x1f"   Number: 31     parseInt: 0      parseFloat: 0
"1e3"    Number: 1000   parseInt: 1      parseFloat: 1000
表示用コードUTF-8 · LF
全体が数値でないとき 空文字 小数点
Number() NaN(厳しい) 0 になる 読む
parseInt() 読める所まで読む NaN 切り捨てる
parseFloat() 読める所まで読む NaN 読む

入力の検証には Number() を使ってください。 parseInt() は '42px' を 42 として通してしまいます。

空文字が 0 になる

Number() のいちばんの落とし穴です。未入力が 0 として通ります。

javascript失敗・注意の例

console.log(Number(''));
console.log(Number('   '));
console.log(Number(null));
console.log(Number([]));
console.log(Number(false));
固定例の期待出力 · Node 24.22.3
0
0
0
0
0
表示用コードUTF-8 · LF

フォームの未入力は空文字で届きます。そのまま Number() に渡すと 「0 と入力された」と区別できません。

example.js

const guarded = (text) => (text.trim() === '' ? null : Number(text));

console.log(guarded(''));
console.log(guarded('   '));
console.log(guarded('0'));
固定例の期待出力 · Node 24.22.3
null
null
0
表示用コードUTF-8 · LF

先に空かどうかを見れば、「未入力」と「0 と入力」を区別できます。

単項プラスは Number() と同じ

+text は短く書けますが、中身は Number() です。空文字も 0 になります。

example.js

console.log(+'42', Number('42'));
console.log(+'', Number(''));
console.log(+'42px', Number('42px'));
固定例の期待出力 · Node 24.22.3
42 42
0 0
NaN NaN
表示用コードUTF-8 · LF

短いぶん、変換していることが読み取りにくくなります。人が読むコードでは Number() を勧めます。

parseInt には必ず基数を渡す

第2引数を省くと、2文字目までを見て基数を決めます。

example.js

console.log(parseInt('0x1f'));
console.log(parseInt('0x1f', 10));
console.log(parseInt('08'));
console.log(parseInt('08', 10));
固定例の期待出力 · Node 24.22.3
31
0
8
8
表示用コードUTF-8 · LF

'0x1f' は16進数とみなされて 31 になります。 '08' は現在の仕様では10進数ですが、古い環境では8進数として 0 になりました。

parseInt(s, 10) と必ず書いてください。

カンマ区切りと全角

そのままでは通りません。先に整えます。

javascript失敗・注意の例

console.log(Number('1,234'));
console.log(Number('123'));
console.log(Number('123'));
固定例の期待出力 · Node 24.22.3
NaN
NaN
NaN
表示用コードUTF-8 · LF

全角数字は1文字でも混ざると変換できません。 カンマも同じです。

日本語の入力欄では全角で打たれるのが普通です。 「数字を入れてください」と書いても、全角で来ます。受け取る側で直してください。

example.js

function normalize(text) {
  return text
    .replace(/[0-9.-]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 0xfee0))
    .replace(/,/g, '')
    .trim();
}

console.log(Number(normalize('1,234')));
console.log(Number(normalize('123')));
console.log(Number(normalize('123')));
console.log(Number(normalize(' 1,234 '.replace(/,/g, ','))));
固定例の期待出力 · Node 24.22.3
1234
123
123
1234
表示用コードUTF-8 · LF

全角の記号は種類が多いので、扱う範囲を決めて明示的に置き換えてください。何でも受け付けようとすると、かえって読めなくなります。

区切って複数の数値を受け取るなら String.prototype.split() と組み合わせます。

大きすぎる数

16桁を超えると、変換できても元に戻りません。

javascript失敗・注意の例

const text = '9007199254740993';

console.log(Number(text));
console.log(String(Number(text)) === text);
固定例の期待出力 · Node 24.22.3
9007199254740992
false
表示用コードUTF-8 · LF

ID や電話番号のような「計算しない数字」は、数値に変換しないでください。 文字列のまま扱うのが正解です。

計算が必要なら BigInt を使います。

example.js

const text = '9007199254740993';

console.log(BigInt(text));
console.log(String(BigInt(text)) === text);
固定例の期待出力 · Node 24.22.3
9007199254740993n
true
表示用コードUTF-8 · LF

理由は なぜ 0.1 + 0.2 は 0.30000000000000004 になるのか にあります。

NaN の判定に isNaN() を使わない

グローバルの isNaN() は先に数値へ変換します。別の質問に答えてしまいます。

javascript失敗・注意の例

console.log(isNaN('あ'));
console.log(isNaN(''));
console.log(Number.isNaN(Number('')));
固定例の期待出力 · Node 24.22.3
true
false
false
表示用コードUTF-8 · LF

Number.isNaN() か Number.isFinite() を使ってください。 詳しくは なぜ NaN === NaN は false なのか にあります。

まとめ

example.js

function toNumber(text) {
  if (typeof text !== 'string') return null;

  const s = text.trim();
  if (s === '') return null;

  const n = Number(s);
  return Number.isFinite(n) ? n : null;
}

for (const s of ['42', '3.14', '', '  ', '42px', 'あ', '1e3', 'Infinity']) {
  console.log(JSON.stringify(s).padEnd(10), toNumber(s));
}
固定例の期待出力 · Node 24.22.3
"42"       42
"3.14"     3.14
""         null
"  "       null
"42px"     null
"あ"        null
"1e3"      1000
"Infinity" null
表示用コードUTF-8 · LF
  • 変換には Number()(parseInt() は途中まで読んでしまう)
  • 空文字を先に弾く(Number('') は 0)
  • Number.isFinite() で確かめる(NaN も Infinity も落ちる)
  • parseInt() を使うときは必ず基数を渡す
  • 計算しない数字(ID・電話番号)は変換しない

出典

この教材の原文(Markdown・別タブ)