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

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 buffer

view.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