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

CKTIS / JavaScript

TypedArray: tamaños, indexación, vistas y copias

Aprende la diferencia entre el número de elementos y el número de bytes en TypedArray. Descubre cómo buffer y byteOffset describen una vista y por qué subarray() comparte datos mientras que slice() crea una copia independiente.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray es la interfaz común de las vistas tipadas sobre datos binarios, no un constructor disponible globalmente. Usa un tipo concreto como Uint16Array. Estas API pertenecen a ECMAScript y no requieren DOM. Aquí, TypedArray.length, TypedArray.byteLength, TypedArray.buffer y TypedArray.byteOffset se refieren a propiedades de instancia como view.length, no a propiedades estáticas.

length cuenta elementos, byteLength cuenta los bytes de la vista, buffer hace referencia al ArrayBuffer o SharedArrayBuffer subyacente completo, y byteOffset indica el comienzo de la vista en bytes con respecto al búfer. Para una vista válida, byteLength === length * BYTES_PER_ELEMENT. Una vista puede abarcar solo una parte de su búfer. En new Uint16Array(buffer, byteOffset, length), el desplazamiento debe ser múltiplo de 2, mientras que length sigue contando elementos. Estas propiedades son de solo lectura; aun así, cambiar el tamaño del búfer puede modificar los tamaños indicados, y una vista fuera de límites informa tamaños y desplazamiento iguales a cero.

TypedArray.indexing se refiere a la sintaxis view[index], no a un método. Los índices empiezan en cero y acceden a elementos desde el comienzo de la vista. La asignación convierte el valor al tipo del elemento. Una lectura fuera de límites devuelve undefined; una escritura fuera de límites no amplía la vista ni almacena un valor. view[-1] no lee el último elemento.

TypedArray.prototype.subarray(begin, end) crea una vista nueva que comparte el búfer: los cambios en los elementos coincidentes se ven en ambas vistas. TypedArray.prototype.slice(start, end) copia los elementos seleccionados a un búfer independiente. Ambos métodos expresan los límites en elementos, incluyen el inicio y excluyen el final; los límites negativos se cuentan desde el final y, si se omite el final, se toma el final de la vista. Estas reglas describen los tipos integrados habituales; las subclases personalizadas pueden alterar la creación de resultados mediante Symbol.species.

Ejemplos

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Resultado

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes