【JavaScript ECMAScript】TypeError: can't convert BigInt to numberエラーの使い方

TypeError: can't convert BigInt to numberクラスは、JavaScriptにおいて、BigInt型の値をNumber型へ暗黙的に変換しようとした際に発生するエラーを表すクラスです。JavaScriptのNumber型は、一般的な数値（浮動小数点数）を扱い、表現できる整数の範囲に限界があります。一方、ES2020で導入されたBigInt型は、その名の通り非常に大きな整数を正確に扱える新しいデータ型です。

このエラーは、BigIntの値がNumber型を期待する文脈で使用されたときに発生します。例えば、Number()コンストラクタにBigIntの値を直接渡したり、Mathオブジェクトのメソッド（Math.sqrt()など）にBigIntを渡したりするケースが挙げられます。JavaScriptは、BigIntがNumber型の表現範囲を超えている可能性があるため、データ損失を防ぐ目的でBigIntからNumberへの自動的な型変換を行いません。

このエラーを解決するためには、開発者が明示的に型変換を行う必要があります。値をNumber型に変換したい場合はNumber(bigIntValue)のように記述しますが、この際、元のBigInt値がNumber型の表現範囲を超える場合は精度が失われたり、Infinityになる可能性があるため注意が必要です。また、値が大きすぎてNumber型で表現しきれない場合は、文字列として扱うString(bigIntValue)などの方法も検討すると良いでしょう。このエラーは、データの整合性を保ち、予期せぬ数値の丸めや欠落を防ぐための重要な警告です。

Copy
1const bigIntValue = 10n;
2const numberValue = Number(bigIntValue);

引数なし

引数はありません

戻り値なし

戻り値はありません