CKTIS / JavaScript
Getypeerde arrays: aantal elementen, bytes van de weergave en bufferbytes
Maak onderscheid tussen de buffer (`.buffer`), het aantal elementen (`.length`), het aantal bytes in de weergave (`.byteLength`) en de actuele grootte van de hele buffer (`.buffer.byteLength`).
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const buffer = new ArrayBuffer(byteCount);
const view = new Uint16Array(buffer, byteOffset, elementCount);
view.buffer // backing buffer object
view.length // element count in the view
view.byteLength // byte count in the view
buffer.byteLength // current byte count of the entire bufferview.buffer geeft hetzelfde bufferobject terug, zonder gegevens te kopiëren: een ArrayBuffer of, bij een weergave van gedeeld geheugen, een SharedArrayBuffer. view.length telt elementen, terwijl view.byteLength de bytes in de weergave telt: view.length * view.BYTES_PER_ELEMENT. view.buffer.byteLength geeft het huidige aantal bytes in de hele buffer, niet het maximum. SharedArrayBuffer heeft een eigen getter voor byteLength. Dit zijn alleen-lezen-eigenschappen, geen methoden.
new Uint16Array(n) reserveert ruimte voor n elementen. Daarentegen maakt new Uint16Array(buffer, byteOffset, length) een weergave zonder te kopiëren: de offset is in bytes en de lengte in elementen. Een onjuist uitgelijnde offset of een bereik buiten de buffer leidt tot RangeError. Mag de ontvanger alleen de gegevens van de weergave krijgen? Geef dan een kopie van het bytebereik door, niet view.buffer, want daarmee zijn ook bytes buiten de weergave toegankelijk.
Bij een buffer van het type ArrayBuffer met aanpasbare grootte (ECMAScript 2024) zorgt het weglaten van length ervoor dat de weergave alle volledige elementen omvat die vanaf de offset tot het einde van de buffer passen. Een expliciete length legt het bereik vast. Door de buffer te verkleinen kan de weergave buiten de grenzen vallen: view.length en view.byteLength geven dan 0 terug. Bij opnieuw vergroten kan het bereik weer geldig worden. Controleer vooraf of de doelomgeving het aanpassen van de buffergrootte ondersteunt.
Als je op het web een ArrayBuffer overdraagt, kan de oorspronkelijke buffer van zijn gegevens worden losgekoppeld. view.buffer geeft nog steeds hetzelfde object terug, maar buffer.byteLength, view.length en view.byteLength geven 0. Nul alleen bewijst geen loskoppeling: de buffer of weergave kan gewoon leeg zijn.
Voorbeelden
{
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(`${view.buffer === buffer} | ${view.length} | ${view.byteLength} | ${buffer.byteLength}`);
}Resultaat
true | 3 | 6 | 16
`true | 3 | 6 | 16` bevestigt dat de weergave dezelfde buffer gebruikt: vanaf byteoffset 4 omvat de weergave 3 elementen van elk 2 bytes in een buffer van 16 bytes.
Gerelateerde lessen
- JavaScript · Les 5 · Gevorderd · Versie: 4
Bronnen
- ECMAScript 2024 — get %TypedArray%.prototype.buffer
- ECMAScript 2024 — get %TypedArray%.prototype.length
- ECMAScript 2024 — get %TypedArray%.prototype.byteLength
- ECMAScript 2024 — get ArrayBuffer.prototype.byteLength
- ECMAScript 2024 — get SharedArrayBuffer.prototype.byteLength
- ECMAScript 2024 — InitializeTypedArrayFromArrayBuffer
- ECMAScript 2024 — ArrayBuffer.prototype.resize
- MDN — TypedArray: Behavior when viewing a resizable buffer
- HTML Standard — StructuredSerializeWithTransfer