CKTIS / JavaScript
BigInt — entiers exacts
BigInt(value) crée une primitive bigint pour effectuer des calculs entiers exacts au-delà de la plage sûre de Number. Découvrez le fonctionnement de la conversion, les restrictions applicables aux opérations arithmétiques et la production de texte avec toString(radix).
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
BigInt(value)
123n
value.toString(radix)BigInt(value) renvoie une primitive de type bigint, qui représente un entier de précision arbitraire dans les limites des ressources de l’implémentation. Une autre possibilité est un littéral suffixé par n, par exemple 123n. La fonction et les littéraux font partie d’ECMAScript 2020, et non des Web APIs. new BigInt(1) déclenche une TypeError. La spécification du langage n’est pas un tableau de compatibilité des navigateurs ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Pour les grandes valeurs, utilisez du texte, par exemple BigInt("9007199254740993") : la conversion ne peut pas annuler un arrondi antérieur d’une valeur Number. BigInt(1.5) déclenche une RangeError, et un texte d’entier invalide déclenche une SyntaxError. La conversion de true produit 1n, tandis que celle de false produit 0n.
Les opérations arithmétiques exigent des types identiques : 1n + 1 déclenche une TypeError, tandis que 1n + 1n produit 2n. La division entière tronque la partie fractionnaire vers zéro : 7n / 2n produit 3n. La conversion avec Number(value) peut entraîner une perte de précision.
Distinguez le nom BigInt.toString de la méthode appliquée à une valeur : l’API réelle est BigInt.prototype.toString, appelée sous la forme value.toString(radix). BigInt.toString() décrit la fonction elle-même au lieu de formater un entier. La méthode appliquée à une valeur renvoie du texte sans le suffixe n ; la base par défaut est 10. Avant de vérifier la plage, la méthode convertit radix en entier par troncature vers zéro. Si la valeur obtenue n’est pas comprise entre 2 et 36 inclus, la méthode déclenche une RangeError. Par exemple, (255n).toString(36.9) utilise la base 36 et renvoie "73".
Exemples
const value = BigInt("9007199254740993");
const next = value + 2n;
console.log(typeof value);
console.log(next.toString());
console.log((255n).toString(16));
console.log((7n / 2n).toString());Résultat
bigint 9007199254740995 ff 3
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® 2020 Language Specification
- Official reference — developer.mozilla.org: BigInt / toString