CKTIS / JavaScript
TypedArray: búfer, desplazamiento, tamaño en bytes y número de elementos
Distingue el búfer completo del intervalo de bytes y del número de elementos de una vista tipada. Aprende qué devuelven sus propiedades si el búfer cambia de tamaño o se desacopla.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
view.buffer
view.byteOffset
view.byteLength
view.length
new Uint16Array(buffer)
new Uint16Array(buffer, byteOffset)
new Uint16Array(buffer, byteOffset, length)Una instancia como Uint16Array es una vista sobre un búfer. TypedArray designa la familia de tipos; no hay un constructor global con ese nombre que se pueda llamar directamente. Las cuatro propiedades son accesores heredados sin setter. Invocar uno de sus getters sobre un objeto que no es un array tipado lanza TypeError. view.length no es Uint16Array.length, que indica el número de parámetros declarados del constructor.
view.buffer devuelve el mismo objeto ArrayBuffer o SharedArrayBuffer subyacente, no una copia. view.byteOffset indica dónde empieza la vista con respecto al inicio del búfer y view.byteLength indica su tamaño, ambos en bytes. view.length cuenta elementos. Si ambas lecturas corresponden al mismo tamaño de la vista, se cumple view.byteLength === view.length * view.BYTES_PER_ELEMENT. Los getters se invocan por separado: si otro agente amplía el SharedArrayBuffer subyacente entre las lecturas, los getters de una vista de longitud adaptable pueden observar tamaños distintos y la comparación puede devolver false. view.buffer.byteLength mide el búfer completo, no solo la vista.
En new Uint16Array(buffer, byteOffset, length), el segundo argumento va en bytes y el tercero en elementos. Un desplazamiento mal alineado o un intervalo que se sale del búfer lanza RangeError. Las escrituras se ven desde las vistas solapadas del mismo búfer. Pasar una vista no oculta los demás bytes: para exponer solo un intervalo válido, copia sus bytes a un búfer independiente.
En un búfer de tamaño fijo, omitir length abarca el resto, que debe contener un número entero de elementos. En un ArrayBuffer redimensionable o un SharedArrayBuffer ampliable, omitir length o pasar undefined crea una vista de longitud adaptable: cuenta los elementos completos que caben desde su desplazamiento. Un número de elementos explícito fija la longitud de la vista.
Reducir el búfer puede dejar la vista fuera de sus límites; volver a ampliarlo puede hacer que encaje otra vez. Mientras esté fuera de límites, o si su ArrayBuffer se ha desacoplado (por ejemplo, al transferirlo), los tres getters numéricos devuelven 0, pero buffer sigue devolviendo el mismo objeto. Una vista vacía válida puede tener un desplazamiento distinto de cero. ECMAScript 2024 especifica el redimensionamiento y la ampliación; comprueba su compatibilidad en el entorno de ejecución de destino.
Ejemplos
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log([
view.buffer === buffer,
view.byteOffset,
view.byteLength,
view.length,
view.buffer.byteLength,
].join(" "));
view[0] = 513;
console.log(String(new Uint16Array(buffer)[2]));
}Resultado
true 4 6 3 16 513
La vista empieza en el byte 4 y abarca tres elementos de dos bytes, es decir, 6 de los 16 bytes. La escritura en el índice 0 se ve en el índice 2 de la vista del búfer completo.
Lecciones relacionadas
- JavaScript · Lección 2 · Avanzado · Versión: 4