CKTIS / JavaScript
Arrays tipados: número de elementos, bytes de la vista y bytes del búfer
Distingue el búfer subyacente (`.buffer`), el número de elementos (`.length`), los bytes de la vista (`.byteLength`) y el tamaño actual de todo el búfer (`.buffer.byteLength`).
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer // backing buffer object
view.length // element count in the view
view.byteLength // byte count in the view
buffer.byteLength // current byte count of the entire bufferview.buffer devuelve el mismo objeto búfer sin copiar los datos: un ArrayBuffer o, si la vista usa memoria compartida, un SharedArrayBuffer. view.length cuenta elementos, mientras que view.byteLength cuenta bytes de la vista: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength indica el tamaño actual en bytes de todo el búfer, no su máximo. SharedArrayBuffer tiene su propio getter byteLength. Son propiedades de solo lectura, no métodos.
new Uint16Array(n) reserva espacio para n elementos. En cambio, new Uint16Array(buffer, byteOffset, length) crea una vista sin copiar: el desplazamiento se expresa en bytes y la longitud en elementos. Un desplazamiento mal alineado o un intervalo que sobrepase el búfer provoca RangeError. Si el destinatario solo debe recibir los datos de la vista, pásale una copia de su intervalo de bytes, no view.buffer, que también da acceso a los bytes fuera de la vista.
Con un ArrayBuffer redimensionable (ECMAScript 2024), si omites length, la vista abarca tantos elementos completos como quepan desde su desplazamiento hasta el final del búfer. Un length explícito fija el intervalo de la vista. Al reducir el búfer, la vista puede quedar fuera de los límites: view.length y view.byteLength devuelven entonces 0. Volver a ampliar el búfer puede hacer que el intervalo vuelva a ser válido. Comprueba si el entorno de destino admite el redimensionamiento antes de usarlo.
En la Web, transferir un ArrayBuffer puede desvincular el búfer original de sus datos. view.buffer sigue devolviendo el mismo objeto, pero buffer.byteLength, view.length y view.byteLength devuelven 0. Un cero por sí solo no demuestra la desvinculación: el búfer o la vista pueden estar simplemente vacíos.
Ejemplos
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Resultado
true | 3 | 6 | 16
`true | 3 | 6 | 16` confirma que la vista usa el mismo búfer: comienza en el desplazamiento de 4 bytes y abarca 3 elementos de 2 bytes cada uno dentro de un búfer de 16 bytes.
Lecciones relacionadas
- JavaScript · Lección 5 · Avanzado · Versión: 4
Fuentes
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer