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

CKTIS / JavaScript

ArrayBuffer: búfer de bytes sin formato

ArrayBuffer reserva memoria de bytes inicializada a cero, accesible mediante typed array o DataView y opcionalmente redimensionable.

Versión: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2

Sintaxis

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) crea un bloque de memoria lleno de ceros. ArrayBuffer no expone por sí mismo bytes indexados; para leer y escribir se necesita una vista como Uint8Array o DataView. byteLength pasa por ToIndex: una parte fraccionaria finita se trunca hacia cero, NaN y undefined se convierten en 0, e incluso -0.5 pasa a -0 y por tanto a longitud 0. Invocar el constructor sin new lanza TypeError.

options.maxByteLength solicita un búfer redimensionable si el límite no es menor que el tamaño inicial. resize(newLength) conserva el prefijo común, descarta bytes al reducir y añade ceros al ampliar; las vistas que siguen la longitud se adaptan. Un búfer fijo no puede redimensionarse. slice() copia un rango y una transferencia puede separar la fuente.

Solo un resultado negativo tras ToIntegerOrInfinity, +Infinity o -Infinity, superar el rango numérico o el límite práctico de memoria de la implementación, o un máximo menor que el tamaño inicial lanza RangeError. Las operaciones de datos sobre un búfer separado y resize() sobre uno fijo lanzan TypeError. Se propagan fallos de conversión. El redimensionamiento y las transferencias se estandarizaron en ECMAScript 2024.

La etiqueta de alcance ArrayBuffer.byteLength designa la propiedad de instancia usada como buffer.byteLength, no una propiedad estática del constructor ArrayBuffer. Este accessor de solo lectura devuelve el número actual de bytes: el resultado cambia tras resize() en un búfer redimensionable y es 0 después de separarlo. No tiene setter; aplicar el getter a un receptor incompatible, incluido SharedArrayBuffer, lanza TypeError.

Ejemplos

const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);

buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));

const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));

try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }

Resultado

4 8 true
6 10,20,30,40,0,0
3 20,30,40
true

Fuentes