CKTIS / JavaScript
TypedArray: groottes, indexering, weergaven en kopieën
Leer het verschil tussen aantallen elementen en bytes in TypedArray. Bekijk hoe buffer en byteOffset een weergave beschrijven en waarom subarray() gegevens deelt, terwijl slice() een onafhankelijke kopie maakt.
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
const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);TypedArray is de gemeenschappelijke interface voor getypeerde weergaven van binaire gegevens, geen wereldwijd beschikbare constructor. Gebruik een concreet type zoals Uint16Array. Deze API’s behoren tot ECMAScript en vereisen geen DOM. Hier verwijzen TypedArray.length, TypedArray.byteLength, TypedArray.buffer en TypedArray.byteOffset naar instantie-eigenschappen zoals view.length, niet naar statische eigenschappen.
length telt elementen, byteLength telt de bytes van de weergave, buffer verwijst naar de volledige onderliggende ArrayBuffer of SharedArrayBuffer, en byteOffset geeft het begin van de weergave in bytes ten opzichte van de buffer aan. Voor een geldige weergave geldt byteLength === length * BYTES_PER_ELEMENT. Een weergave kan slechts een deel van de buffer beslaan. In new Uint16Array(buffer, byteOffset, length) moet de offset een veelvoud van 2 zijn, terwijl length nog steeds elementen telt. Deze eigenschappen zijn alleen-lezen; het wijzigen van de buffergrootte kan de gerapporteerde groottes echter veranderen. Een weergave buiten de grenzen rapporteert groottes en offset als nul.
TypedArray.indexing verwijst naar de syntaxis view[index], niet naar een methode. Indexen beginnen bij nul en verwijzen naar elementen vanaf het begin van de weergave. Bij toewijzing wordt de waarde omgezet naar het elementtype. Lezen buiten de grenzen geeft undefined terug; schrijven buiten de grenzen vergroot de weergave niet en slaat geen waarde op. view[-1] leest niet het laatste element.
TypedArray.prototype.subarray(begin, end) maakt een nieuwe weergave die de buffer deelt: wijzigingen aan overlappende elementen zijn in beide weergaven zichtbaar. TypedArray.prototype.slice(start, end) kopieert de geselecteerde elementen naar een onafhankelijke buffer. Beide methoden geven grenzen op in elementen, nemen het begin wel en het einde niet mee; negatieve grenzen tellen vanaf het einde, en een weggelaten einde betekent het einde van de weergave. Deze regels beschrijven gewone ingebouwde typen; aangepaste subklassen kunnen de constructie van resultaten wijzigen via Symbol.species.
Voorbeelden
const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);Resultaat
4 8 2 12 4 true false 10,99,30,40 99,30 20,30 undefined 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.