Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Uint8Array — uma vista de bytes sem sinal

Uint8Array expõe os dados de um buffer como inteiros sem sinal de 8 bits, entre 0 e 255. Permite criar e copiar bytes ou partilhar memória através de vistas; as escritas fora do intervalo regressam ao intervalo em vez de serem limitadas.

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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])

Uint8Array é um array tipado: uma vista de um buffer cujos elementos ocupam um byte cada e são lidos como valores Number entre 0 e 255. Não é um Array normal. A propriedade length indica o número de elementos, byteLength indica o tamanho da vista em bytes e buffer expõe o buffer subjacente.

new Uint8Array(length) cria um buffer preenchido com zeros. new Uint8Array(values) copia valores de um objeto iterável ou semelhante a um array. new Uint8Array(buffer, byteOffset, length) cria uma vista de um buffer existente sem o copiar; byteOffset é um deslocamento em bytes e length indica o número de elementos. O construtor requer new.

Ao atribuir valores, os números finitos são truncados em direção a zero e, em seguida, reduzidos módulo 256: 256 passa a 0 e -1 passa a 255. NaN e os infinitos passam a 0. Isto não é uma validação do intervalo nem uma limitação como a de Uint8ClampedArray; valida os dados inválidos antes de os escrever.

subarray() cria uma vista que partilha memória, enquanto slice() cria uma cópia independente. No exemplo, alterar view[0] também altera bytes[1], mas não modifica copy. Esta entrada abrange operações fundamentais de ECMAScript, não métodos de codificação mais recentes. A especificação, por si só, não comprova a compatibilidade com um navegador específico; a presença de Node 24 num repositório também não a comprova.

Exemplos

const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);

Resultado

0,42,0,255
255,0
4:4

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.

Fontes