Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

BigUint64Array: enteros sin signo de 64 bits

BigUint64Array almacena BigInt como enteros sin signo de 64 bits y los ajusta módulo 2^64.

Versión: ECMAScript 2020 onward; example target: Node.js 24.22.2

Sintaxis

new BigUint64Array(); new BigUint64Array(length); new BigUint64Array(source); new BigUint64Array(buffer[, byteOffset[, length]])

new BigUint64Array(source?, byteOffset?, length?) crea un typed array sin signo de 8 bytes por elemento. El origen puede ser una longitud, iterable o array-like, BigInt64Array/BigUint64Array o búfer; un typed array numérico tiene otro tipo de contenido y lanza TypeError. La forma con búfer es una vista sin copia y byteOffset debe ser múltiplo de 8.

La asignación convierte a BigInt y reduce módulo 2^64: -1n pasa a 2^64 - 1 y 2^64 + 5 a 5n. Un Number normal lanza TypeError; BigInt(number) solo acepta un Number entero y uno fraccionario lanza RangeError. El orden de bytes es nativo; use DataView para un formato fijo.

La longitud pasa por ToIndex: las fracciones se truncan hacia cero, NaN/undefined se vuelven 0 y -0.5 también da 0. Resultado negativo tras ToIntegerOrInfinity, infinito, exceso de rango, desplazamiento desalineado o rango fuera del búfer lanza RangeError. Búfer separado y valores incompatibles lanzan TypeError. La API es de ECMAScript 2020; BYTES_PER_ELEMENT vale 8.

Ejemplos

const values = new BigUint64Array([0n, -1n, 2n ** 64n + 5n]);
console.log(Array.from(values, String).join(","));

const buffer = new ArrayBuffer(16);
const view = new BigUint64Array(buffer, 8, 1);
view[0] = 42n;
console.log(view.byteOffset, view.byteLength, view[0], BigUint64Array.BYTES_PER_ELEMENT);

console.log(new BigUint64Array(2.9).length, new BigUint64Array(-0.5).length);
try { values[0] = 1; } catch (error) { console.log(error instanceof TypeError); }
try { new BigUint64Array(new Uint8Array([1])); } catch (error) { console.log(error instanceof TypeError); }

Resultado

0,18446744073709551615,5
8 8 42n 8
2 0
true
true

Fuentes