Constructeur BigInt()

Syntaxe

BigInt(value)

Paramtres

value

La valeur convertir en valeur BigInt. Il peut s'agir d'une chanes de caractres, d'un entier, d'une valeur boolenne ou d'un autre BigInt.

Valeur de retour

Une valeur BigInt. Les valeurs numriques doivent tre des entiers et sont converties en BigInt. La valeur boolenne true devient 1n, et false devient 0n. Les chanes de caractres sont analyses comme s'il s'agissait du texte source de littraux entiers, ce qui signifie qu'elles peuvent comporter des espaces blancs au dbut et la fin et tre prfixes par 0b, 0o ou 0x.

Exceptions

RangeError

Leve si le paramtre est un nombre non entier.

TypeError

Leve dans l'un des cas suivants :

• Le paramtre ne peut pas tre converti en primitif.
• Aprs conversion en primitif, le rsultat est undefined, null, Symbol.

SyntaxError

Leve si le paramtre est une chane de caractres qui ne peut pas tre interprte comme un BigInt.

Exemples

Utiliser BigInt() pour convertir un nombre en BigInt

BigInt() est le seul cas o un nombre peut tre converti en BigInt sans lever d'exception, car c'est trs explicite. Cependant, seuls les entiers sont autoriss.

BigInt(123); // 123n
BigInt(123.3); // RangeError : le nombre 123.3 ne peut pas tre converti en BigInt, car ce n'est pas un entier

Utiliser des chanes de caractres

BigInt("123"); // 123n
BigInt("0b10101"); // 21n, soit 10101 en binaire
BigInt("0o123"); // 83n, soit 123 en octal
BigInt("0x123"); // 291n, soit 123 en hexadcimal
BigInt("  123  "); // 123n, les espaces blancs en dbut et fin sont autoriss

Spcifications

Compatibilit des navigateurs

Voir aussi

• La valeur BigInt