KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

TypedArray.length — aantal elementen in een view

TypedArray.length geeft het aantal elementen in een getypeerde array aan, niet het aantal bytes. Lees de waarde af van een instantie, bijvoorbeeld met values.length; je kunt de view er niet mee vergroten of verkleinen.

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

typedArray.length

TypedArray.length verwijst hier naar de instantie-eigenschap die is gedocumenteerd als TypedArray.prototype.length. Lees deze uit met typedArray.length, zonder aanroep-haakjes. TypedArray is de gedeelde abstractie voor concrete typen zoals Uint16Array, geen globale constructor die je rechtstreeks kunt gebruiken.

length telt de elementen in de view. byteLength telt de bytes in die view, terwijl buffer.byteLength de volledige buffer beschrijft. Elk element van een Uint16Array neemt 2 bytes in beslag. Een view met een length van 3 heeft dus een byteLength van 6. Een view kan slechts een deel van de buffer beslaan. Bij de constructor geef je byteOffset op in bytes en length in elementen.

De eigenschap is een accessor zonder setter: een waarde toewijzen aan length verandert de grootte van een getypeerde array niet. Bij een aanpasbare buffer kan de length van een view die de lengte volgt echter veranderen wanneer de buffer verandert. Als het verkleinen van de buffer het bereik van de view ongeldig maakt, levert het uitlezen van de eigenschap 0 op, ook bij een view met een vaste lengte. Controleer ondersteuning voor aanpasbare buffers afzonderlijk; alleen toegang tot length toont niet aan dat die ondersteuning aanwezig is.

Voorbeelden

const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);

console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);

Resultaat

3
6
12

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