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.