CKTIS / JavaScript
Uint16Array — array tipado sem sinal de 16 bits
Uint16Array é uma vista tipada de um buffer que armazena números inteiros de 0 a 65535, usando 2 bytes por elemento. Saiba como os valores são convertidos e qual a diferença entre copiar dados e partilhar uma vista.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)Uint16Array é um array tipado integrado do ECMAScript, não um Array normal. Cada elemento ocupa 2 bytes e, quando lido, é devolvido como um Number entre 0 e 65535. length indica o número de elementos, byteLength conta os bytes da vista e Uint16Array.BYTES_PER_ELEMENT é 2.
O construtor exige new. Se o argumento for numérico, o construtor aplica ToIndex para determinar quantos elementos são inicializados a zero. Por exemplo, new Uint16Array(3.9) cria três elementos, enquanto new Uint16Array(-1) lança um RangeError. Uma coleção fornece os valores a copiar. A variante com ArrayBuffer cria uma vista sem copiar: byteOffset é medido em bytes e tem de ser múltiplo de 2, enquanto length, opcional, conta elementos e não bytes.
Ao escrever, os valores são convertidos em vez de serem validados quanto ao intervalo: os valores Number finitos são truncados em direção a zero e, em seguida, reduzidos módulo 65536. Assim, 65536 torna-se 0, -1 torna-se 65535 e 3.9 torna-se 3. NaN e os infinitos tornam-se 0; os valores BigInt provocam um TypeError. Não se trata de limitar os valores ao intervalo.
subarray() partilha o armazenamento com o original, enquanto slice() copia os dados. O exemplo demonstra a conversão e a alteração do original através de uma vista. A ordem dos bytes é a nativa da implementação; utilize DataView para um formato binário com uma ordem de bytes explícita.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.