KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

ArrayBuffer: buffer voor ruwe bytes

ArrayBuffer reserveert met nul gevulde bytegeheugenruimte die via typed array of DataView wordt benaderd en optioneel groter of kleiner kan worden.

Versie: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2

Syntax

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) maakt een met nullen gevuld geheugenblok. Een ArrayBuffer zelf biedt geen geïndexeerde bytes; lezen en schrijven vereist een view zoals Uint8Array of DataView. byteLength doorloopt ToIndex: een eindig breukdeel wordt naar nul afgekapt, NaN en undefined worden 0, en zelfs -0.5 wordt -0 en dus lengte 0. Aanroepen zonder new werpt TypeError.

options.maxByteLength vraagt een aanpasbare buffer als de limiet niet kleiner is dan de begingrootte. resize(newLength) bewaart het gemeenschappelijke voorstuk, verwijdert bytes bij krimpen en voegt nullen toe bij groeien; lengtevolgende views passen zich aan. Een vaste buffer kan niet worden aangepast. slice() kopieert een bereik en overdracht kan de bron loskoppelen.

Pas een negatief resultaat na ToIntegerOrInfinity, +Infinity of -Infinity, overschrijding van het numerieke bereik of de praktische geheugenlimiet van de implementatie, of een maximum onder de begingrootte werpt RangeError. Gegevensbewerkingen op een losgekoppelde buffer en resize() op een vaste buffer werpen TypeError. Conversiefouten worden doorgegeven. Aanpasbaarheid en overdracht zijn in ECMAScript 2024 gestandaardiseerd.

Het bereiklabel ArrayBuffer.byteLength duidt de instantie-eigenschap aan die als buffer.byteLength wordt gebruikt, niet een statische eigenschap van de constructor ArrayBuffer. Deze alleen-lezen accessor geeft het actuele aantal bytes: het resultaat verandert na resize() van een aanpasbare buffer en is 0 na loskoppeling. Er is geen setter; de getter toepassen op een incompatibele receiver, waaronder een SharedArrayBuffer, werpt TypeError.

Voorbeelden

const buffer = new ArrayBuffer(4, { maxByteLength: 8 });
const bytes = new Uint8Array(buffer);
bytes.set([10, 20, 30, 40]);
console.log(buffer.byteLength, buffer.maxByteLength, buffer.resizable);

buffer.resize(6);
console.log(buffer.byteLength, Array.from(new Uint8Array(buffer)).join(","));

const copy = buffer.slice(1, 4);
console.log(copy.byteLength, Array.from(new Uint8Array(copy)).join(","));

try { new ArrayBuffer(4).resize(2); } catch (error) { console.log(error instanceof TypeError); }

Resultaat

4 8 true
6 10,20,30,40,0,0
3 20,30,40
true

Bronnen