KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Uint8ClampedArray — bytes met begrensde waarden

Uint8ClampedArray is een getypeerde array die gehele getallen van 0 tot 255 opslaat. Bij het schrijven worden waarden tot dat bereik begrensd en breuken afgerond, in plaats van dat waarden teruglopen zoals bij Uint8Array.

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

Uint8ClampedArray is een standaardtype van ECMAScript: een view op een buffer waarvan elk element één byte inneemt en een unsigned geheel getal van 0 tot 255 voorstelt. Uitgelezen waarden hebben het type Number; het is geen gewone Array.

Bij het schrijven wordt ToUint8Clamp toegepast: waarden onder 0 worden 0 en waarden boven 255 worden 255. Breuken worden afgerond op het dichtstbijzijnde gehele getal; bij een exact gelijkspel wordt naar het even getal afgerond. Daarom wordt 2.5 2 en 3.5 4. Dit is anders dan bij Math.round. NaN wordt 0, Infinity wordt 255 en -Infinity wordt 0. Uint8Array kapt breuken juist af en laat gehele getallen teruglopen modulo 256.

new Uint8ClampedArray(length) maakt elementen die met nullen zijn gevuld, terwijl new Uint8ClampedArray(values) waarden kopieert en omzet. De vorm met buffer maakt zonder kopiëren een view op bestaand geheugen; alleen het maken van de view zet de opgeslagen bytes niet om. Voor de constructor is new vereist.

Het voorbeeld laat begrenzing en afronding zien tijdens het maken en bij een latere toewijzing. Begrenzing geldt voor het schrijven naar elementen, niet voor berekeningen met getallen die uit de array zijn gelezen. Dit is een taalfunctie, geen browser-API; de specificatie is geen browsercompatibiliteitstabel.

Voorbeelden

const values = new Uint8ClampedArray([-20, 2.5, 3.5, 300, NaN]);
values[0] = 260;
console.log(JSON.stringify(Array.from(values)));

Resultaat

[255,2,4,255,0]

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.

Bronnen