TL;DR
A diferença entre ambas acontece quando tentamos inserir um valor inteiro fora intervalo permitido (0
e 255
inclusive).
Uint8ClampedArray
- Se for um número negativo, o valor será
0
- Se for um número maior que 255, o valor será
255
let array = new Uint8ClampedArray([-1, 0, 255, 256]);
// resultado: Uint8ClampedArray([0, 0, 255, 255]);
Uint8Array
Sempre guarda os 8 bits menos significantes (a direta):
let array = new Uint8Array([-1, 0, 255, 256]);
// resultado: Uint8Array([255, 0, 255, 0]);
Pois:
┌─────────┬────────────────────────────────────┬─────────────────┐
│ Decimal │ Binário (8bits finais) │ 8bits │
├─────────┼────────────────────────────────────┼─────────────────┤
│ -1 │ 111111111111111111111111(11111111) │ 11111111 == 255 │
│ 256 │ 000000000000000000000001(00000000) │ 00000000 == 0 │
└─────────┴────────────────────────────────────┴─────────────────┘
Resposta completa
A diferença entre Uint8Array e Uint8ClampedArray está na atribuição de valores aos seus respectivos itens.
Na especificação do ECMAScrpt 2015 mostra que a operação de conversão para Uint8Array
e Uint8ClampedArray
são diferentes. Sendo elas:
O que as duas fazem é basicamente:
- Converter o valor para um inteiro de 8 bits
- Tratar alguns casos especiais como
NaN
, Infinity
, etc...
A principal diferença está nessa conversão para inteiro onde:
Uint8Array: trunca o valor para inteiro e utiliza apenas os últimos 8 bits do número, ignorando os restantes.
Seria análogo a:
let n = meuNumero;
n = n & 0xff;
Exemplo:
let array = new Uint8Array([
0, // 0x00000000
255, // 0x000000ff
256, // 0x00000100
-1 // 0xffffffff
]);
// Usa apenas os 8 bits da direita (últimos 2 caracteres hexadecimais)
console.log(array[0]); // 00
console.log(array[1]); // ff
console.log(array[2]); // 00
console.log(array[3]); // ff
Uint8ClampedArray: arredonda o valor usando "round half to even" (se o número for N.5
o arredondamento é feito para o número par mais próximo, ex: 2.5 → 2
e 1.5 → 2
). Se o valor arredondado for menor que 0
o valor será 0
, se o valor for maior que 255
o valor será 255
.
Seria análogo a:
let n = meuNumero;
if (n < 0) {
n = 0;
}
if (n > 255) {
n = 255;
}
Exemplo:
let array = new Uint8ClampedArray([0, 255, 256,-1])
// Se o valor for menor que zero, o valor será 0
// Se o valor for maior que 255, o valor será 255
console.log(array[0]); // 0
console.log(array[1]); // 255
console.log(array[2]); // 255
console.log(array[3]); // 0
Uint8ClampedArray
se especificarmos valores fora do intervalo 0-255 eles serão alterados para 0 ou 255. Se especificarmos um valor não inteiro ele será alterado para o inteiro mais próximo.Uint8Array
o valor atribuído baseia-se nos primeiros 8 bits do valor especificado.