← 返回首页
Constructeur BigInt() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Basculer la barre latérale
  1. Web
  2. JavaScript
  3. Référence
  4. Objets natifs standards
  5. BigInt
  6. BigInt()
Thème
  • Automatique
  • Clair
  • Sombre
Français
Se souvenir de la langue En savoir plus

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Constructeur BigInt()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2020.

Le constructeur BigInt() retourne des valeurs primitives de type BigInt.

Dans cet article

Syntaxe

js
BigInt(value)

Note : BigInt() ne s'utilise pas avec l'opérateur new. Tenter de le construire avec new lève une erreur TypeError.

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.

js
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

js
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

Spécification
ECMAScript® 2027 Language Specification
# sec-bigint-constructor

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?
Oui Non
Apprendre à contribuer

Cette page a été modifiée le 14 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu
  1. Objets natifs standards
  2. BigInt
  3. Constructeur
    1. BigInt()
  4. Méthodes statiques
    1. asIntN()
    2. asUintN()
  5. Méthodes d'instance
    1. toLocaleString()
    2. toString()
    3. valueOf()
  6. Héritage
  7. Object/Function
  8. Méthodes statiques
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
  9. Propriétés statiques
    1. displayName
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  10. Méthodes d'instance
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  11. Propriétés d'instance
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Votre modèle pour un internet meilleur.

MDN Contribuer Développeur·euse·s

Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.