CKTIS / JavaScript
Uint8Array — een weergave van bytes zonder teken
Uint8Array geeft buffergegevens weer als 8-bits gehele getallen zonder teken, van 0 tot en met 255. Je kunt er bytes mee maken en kopiëren, of geheugen delen via weergaven; waarden buiten het bereik lopen terug binnen het bereik in plaats van te worden begrensd.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])Uint8Array is een getypeerde array: een bufferweergave waarvan elk element één byte inneemt en als een Number-waarde van 0 tot en met 255 wordt uitgelezen. Het is geen gewone Array. De eigenschap length geeft het aantal elementen aan, byteLength de grootte van de weergave in bytes en buffer de onderliggende buffer.
new Uint8Array(length) maakt een buffer die met nullen is gevuld. new Uint8Array(values) kopieert waarden uit een itereerbaar of arrayachtig object. new Uint8Array(buffer, byteOffset, length) maakt zonder kopiëren een weergave van een bestaande buffer; byteOffset is een verschuiving in bytes en length geeft het aantal elementen aan. De constructor vereist new.
Bij toewijzing worden eindige getallen naar nul afgekapt en vervolgens modulo 256 herleid: 256 wordt 0 en -1 wordt 255. NaN en oneindigheden worden 0. Dit is geen bereikcontrole en ook geen begrenzing zoals bij Uint8ClampedArray; controleer ongeldige invoer voordat je die wegschrijft.
subarray() maakt een weergave die geheugen deelt, terwijl slice() een onafhankelijke kopie maakt. In het voorbeeld verandert een wijziging van view[0] ook bytes[1], maar blijft copy ongewijzigd. Dit artikel behandelt de basisbewerkingen van ECMAScript, niet nieuwere coderingsmethoden. De specificatie alleen bewijst geen compatibiliteit met een bepaalde browser; de aanwezigheid van Node 24 in een repository bewijst dat evenmin.
Voorbeelden
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);Resultaat
0,42,0,255 255,0 4:4
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.