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