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

CKTIS / JavaScript

Uint16Array — array tipado sin signo de 16 bits

Uint16Array es una vista tipada de un búfer que almacena enteros de 0 a 65535, con 2 bytes por elemento. Aprende cómo se convierten los valores y en qué se diferencian copiar datos y compartir una vista.

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

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array es un array tipado integrado de ECMAScript, no un Array normal. Cada elemento ocupa 2 bytes y, al leerse, se devuelve como un Number entre 0 y 65535. length indica el número de elementos, byteLength cuenta los bytes de la vista y Uint16Array.BYTES_PER_ELEMENT vale 2.

El constructor requiere new. Si el argumento es numérico, el constructor aplica ToIndex para determinar cuántos elementos se inicializan a cero. Por ejemplo, new Uint16Array(3.9) crea tres elementos, mientras que new Uint16Array(-1) lanza un RangeError. Una colección proporciona los valores que se copiarán. La variante con ArrayBuffer crea una vista sin copiar: byteOffset se mide en bytes y debe ser múltiplo de 2, mientras que length, que es opcional, cuenta elementos, no bytes.

Al escribir, los valores se convierten en lugar de comprobarse si están dentro del rango: los valores finitos de tipo Number se truncan hacia cero y después se reducen módulo 65536. Así, 65536 se convierte en 0, -1 en 65535 y 3.9 en 3. NaN y los infinitos se convierten en 0; los valores BigInt provocan un TypeError. No se aplica saturación.

subarray() comparte el almacenamiento con el original, mientras que slice() copia los datos. El ejemplo muestra la conversión y la modificación del original a través de una vista. El orden de los bytes depende de la implementación; usa DataView para un formato binario con un orden de bytes explícito.

Ejemplos

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Resultado

65535,42,65535,3
4 8 2

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