Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Littéral BigInt

Un littéral BigInt est un entier écrit avec le suffixe n minuscule, comme 42n. Il crée une valeur bigint sans l’arrondi qui affecte les grandes valeurs Number.

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

0n; 42n; 0b101010n; 0o52n; 0x2An

Un littéral BigInt, comme 42n, crée une valeur primitive de type bigint, et non number. BigInt fait partie d’ECMAScript 2020 et représente exactement les entiers au-delà de la plage des entiers sûrs de Number.

Le n minuscule doit suivre immédiatement l’écriture de l’entier. Les formes décimale (42n), binaire (0b101010n), octale (0o52n) et hexadécimale (0x2An) sont prises en charge. 1.5n, 1e3n et 042n sont des erreurs de syntaxe. Dans -42n, - est un opérateur unaire, et non une partie du littéral.

Les opérations arithmétiques comme + exigent des types numériques correspondants : 42n + 1n fonctionne, mais 42n + 1 déclenche un TypeError. La division BigInt supprime la partie fractionnaire en direction de zéro : 7n / 2n produit 3n. Convertir une grande valeur en Number peut entraîner une perte de précision.

Il s’agit de syntaxe du langage, pas d’une API Web. L’environnement d’exécution doit pouvoir l’analyser ; un navigateur qui ne la prend pas en charge ne peut pas exécuter un fichier contenant un tel littéral. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs ciblés.

Exemples

const value = 9007199254740993n;
console.log(typeof value);
console.log(String(value + 2n));
console.log(String(7n / 2n));
console.log(42n === 0x2An);

Résultat

bigint
9007199254740995
3
true

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