CKTIS / JavaScript
BigInt64Array: enteros con signo de 64 bits
BigInt64Array almacena valores BigInt como enteros con 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 BigInt64Array(); new BigInt64Array(length); new BigInt64Array(source); new BigInt64Array(buffer[, byteOffset[, length]])new BigInt64Array(source?, byteOffset?, length?) crea un typed array de BigInt con signo, con 8 bytes por elemento. El origen puede ser una cantidad, un iterable o array-like, otro typed array con tipo de contenido BigInt (BigInt64Array o BigUint64Array); un typed array numérico tiene un tipo incompatible y lanza TypeError o un ArrayBuffer/SharedArrayBuffer. La forma con búfer crea una vista sin copiar y byteOffset debe ser múltiplo de 8. Los elementos nuevos se inicializan a cero.
Al asignar, el valor se convierte a BigInt, se reduce módulo 2^64 y se interpreta en complemento a dos entre -2^63 y 2^63-1. Así, 2n ** 63n pasa a -2n ** 63n. Un Number normal no se acepta y lanza TypeError; use BigInt(number) para una conversión intencionada, pero solo si number es entero; un Number fraccionario lanza RangeError. El typed array usa el orden de bytes nativo; para un formato fijo use DataView.
El constructor requiere new. La longitud pasa por ToIndex: las fracciones se truncan hacia cero, NaN y undefined se convierten en 0, y -0.5 pasa a -0 y por tanto a 0. Un resultado negativo tras ToIntegerOrInfinity, infinito, exceso de rango, desplazamiento desalineado o rango fuera del búfer lanza RangeError; un búfer separado o valor no convertible lanza TypeError. La API se estandarizó en ECMAScript 2020 y BigInt64Array.BYTES_PER_ELEMENT vale 8.
Ejemplos
const signed = new BigInt64Array([1n, -2n, 2n ** 63n]);
console.log(Array.from(signed, String).join(","));
const wrapped = new BigInt64Array([2n ** 64n + 5n, -(2n ** 64n) - 1n]);
console.log(Array.from(wrapped, String).join(","));
const buffer = new ArrayBuffer(16);
const view = new BigInt64Array(buffer, 8, 1);
view[0] = 42n;
console.log(view.byteOffset, view.byteLength, view[0], BigInt64Array.BYTES_PER_ELEMENT);
try { signed[0] = 1; } catch (error) { console.log(error instanceof TypeError); }Resultado
1,-2,-9223372036854775808 5,-1 8 8 42n 8 true