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

TypeError: can't convert x to BigIntオブジェクトは、JavaScript実行時に値の型変換に問題が発生したことを示すオブジェクトです。このエラーは、JavaScriptで非常に大きな整数値を扱うための特別なデータ型であるBigIntに、互換性のない型の値を変換しようとした際に発生します。

BigIntは、通常の数値型（Number型）では表現できない範囲の整数を正確に扱うことができる点が特徴です。しかし、その特性上、Number型や文字列型など、他のデータ型との間で厳密な型の区別が求められます。

具体的には、BigInt()コンストラクタ関数に、整数として解釈できない値（例: null、undefined、真偽値のtrueやfalse、小数点を含む数値、またはBigInt型ではないオブジェクトなど）を渡した場合にこのエラーがスローされます。また、BigInt型の値とNumber型の値を、明示的な型変換を行わずに直接演算しようとした際にも発生します。例えば、10n + 5のような記述はエラーの原因となります。

このエラーを解決するためには、BigIntに変換しようとしている値が、有効な整数形式であることを確認してください。文字列として整数が表現されている場合（例: '123'）や、通常の整数リテラル（例: 123）であれば、BigInt()コンストラクタは正常に動作します。BigIntと他の型の値を演算したい場合は、例えば10n + BigInt(5)のように、明示的に型を揃えてから操作を実行する必要があります。

Copy
1const bigIntValue = 10n;
2const numberValue = 5;
3
4// BigIntとNumber型は直接算術演算できません。
5// 以下のコードはTypeErrorを発生させます。
6// エラーメッセージはJavaScriptエンジンによって異なる場合がありますが、
7// "TypeError: can't convert x to BigInt" に類するメッセージが出ることがあります。
8const sum = bigIntValue + numberValue;

引数なし

引数はありません

戻り値なし

戻り値はありません