CKTIS / JavaScript
BigInt — enteros exactos
BigInt(value) crea un valor primitivo bigint para realizar operaciones exactas con enteros fuera del rango seguro de Number. Descubre cómo funciona la conversión, qué restricciones se aplican a las operaciones aritméticas y cómo generar texto con toString(radix).
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
BigInt(value)
123n
value.toString(radix)BigInt(value) devuelve un valor primitivo de tipo bigint, que representa un entero de precisión arbitraria dentro de los límites de recursos de la implementación. Otra opción es un literal con el sufijo n, como 123n. La función y los literales forman parte de ECMAScript 2020, no de las Web APIs. new BigInt(1) provoca un TypeError. La especificación del lenguaje no es una tabla de compatibilidad de navegadores; que Node 24 esté en un repositorio no demuestra que los navegadores lo admitan.
Para valores grandes, utiliza texto, por ejemplo BigInt("9007199254740993"): la conversión no puede deshacer el redondeo previo de un valor Number. BigInt(1.5) provoca un RangeError, y un texto de entero no válido provoca un SyntaxError. Convertir true produce 1n, mientras que convertir false produce 0n.
Las operaciones aritméticas requieren tipos coincidentes: 1n + 1 provoca un TypeError, mientras que 1n + 1n produce 2n. La división entera trunca la parte fraccionaria hacia cero: 7n / 2n produce 3n. La conversión mediante Number(value) puede provocar una pérdida de precisión.
Distingue la etiqueta BigInt.toString del método de los valores: la API real es BigInt.prototype.toString, que se llama como value.toString(radix). BigInt.toString() describe la función en sí, no sirve para dar formato a un entero. El método del valor devuelve texto sin el sufijo n; la base predeterminada es 10. Antes de comprobar el intervalo, el método convierte radix en un entero truncando hacia cero. Si el valor obtenido queda fuera del intervalo de 2 a 36, ambos incluidos, el método provoca un RangeError. Por ejemplo, (255n).toString(36.9) usa la base 36 y devuelve "73".
Ejemplos
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());Resultado
bigint 9007199254740995 ff 3
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.
Fuentes
- 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