CKTIS / JavaScript
TypedArray.byteLength — lengte van de weergave in bytes
De eigenschap byteLength geeft aan hoeveel bytes een getypeerde-arrayweergave beslaat, niet hoeveel elementen deze bevat of hoe groot de volledige buffer is. Je leest de eigenschap van een instantie; er is geen setter.
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.byteLengthTypedArray.byteLength verwijst hier naar de instantie-eigenschap, formeel TypedArray.prototype.byteLength genoemd. Je leest deze als typedArray.byteLength, zonder haakjes. TypedArray is geen globale constructor; gebruik een concreet type, zoals Uint16Array. De eigenschap heeft geen setter: een waarde eraan toewijzen verandert de grootte van de weergave niet.
length telt elementen, terwijl byteLength bytes telt: typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. typedArray.buffer.byteLength beschrijft daarentegen de volledige buffer, en byteOffset geeft het begin van de weergave in bytes aan. Een weergave kan slechts een deel van een buffer beslaan; de byteLength ervan is geen maat voor het totale geheugengebruik van het object.
Bij een aanpasbare buffer kan de byteLength van een weergave die de lengte volgt veranderen. Een weergave met vaste lengte groeit niet mee met de buffer. Als het verkleinen van de buffer het bereik van de weergave ongeldig maakt, wordt byteLength 0.
De basiseigenschap is sinds juli 2015 breed beschikbaar in browsers; ondersteuning voor aanpasbare buffers moet afzonderlijk worden gecontroleerd. In het voorbeeld betekent het derde argument van Uint16Array 3 elementen, geen 3 bytes: de weergave beslaat 6 bytes binnen een buffer van 16 bytes.
Voorbeelden
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);Resultaat
3 2 6 4 16
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.