Constructeur BigInt()

Syntaxe

BigInt(value)

Paramètres

value

La valeur à convertir en valeur BigInt. Il peut s'agir d'une chaînes de caractères, d'un entier, d'une valeur booléenne ou d'un autre BigInt.

Valeur de retour

Une valeur BigInt. Les valeurs numériques doivent être des entiers et sont converties en BigInt. La valeur booléenne true devient 1n, et false devient 0n. Les chaînes de caractères sont analysées comme s'il s'agissait du texte source de littéraux entiers, ce qui signifie qu'elles peuvent comporter des espaces blancs au début et à la fin et être préfixées par 0b, 0o ou 0x.

Exceptions

RangeError

Levée si le paramètre est un nombre non entier.

TypeError

Levée dans l'un des cas suivants :

• Le paramètre ne peut pas être converti en primitif.
• Après conversion en primitif, le résultat est undefined, null, symbol.

SyntaxError

Levée si le paramètre est une chaîne de caractère qui ne peut pas être interprété 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 très explicite. Cependant, seuls les entiers sont autorisés.

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 chaînes de caractères

BigInt("123"); // 123n
BigInt("0b10101"); // 21n, soit 10101 en binaire
BigInt("0o123"); // 83n, soit 123 en octal
BigInt("0x123"); // 291n, soit 123 en hexadécimal
BigInt("  123  "); // 123n, les espaces blancs en début et fin sont autorisés

Spécifications

Compatibilité des navigateurs

Voir aussi

• La valeur BigInt