CKTIS / JavaScript
ArrayBuffer: medpomnilnik surovih bajtov
ArrayBuffer rezervira z ničlami napolnjen bajtni pomnilnik, do katerega dostopamo prek typed array ali DataView in je lahko spremenljive velikosti.
Različica: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2
Sintaksa
new ArrayBuffer(byteLength[, { maxByteLength }])new ArrayBuffer(byteLength, options?) ustvari z ničlami napolnjen blok pomnilnika. ArrayBuffer sam ne izpostavi indeksiranih bajtov; branje in pisanje zahtevata pogled, kot je Uint8Array ali DataView. byteLength gre skozi ToIndex: končni ulomljeni del se odreže proti ničli, NaN in undefined postaneta 0, celo -0.5 pa postane -0 in zato dolžina 0. Klic brez new sproži TypeError.
options.maxByteLength zahteva spremenljivo velikost, če meja ni manjša od začetne velikosti. resize(newLength) ohrani skupno predpono, pri zmanjšanju zavrže bajte in pri povečanju doda ničle; pogledi, ki sledijo dolžini, se prilagodijo. Fiksnega medpomnilnika ni mogoče spremeniti. slice() kopira obseg, prenos pa lahko odklopi izvor.
Šele negativen rezultat po ToIntegerOrInfinity, +Infinity ali -Infinity, prekoračitev številskega obsega ali praktične pomnilniške meje izvedbe oziroma maksimum pod začetno velikostjo sproži RangeError. Podatkovne operacije na odklopljenem medpomnilniku in resize() fiksnega sprožijo TypeError. Napake pretvorbe se širijo. Spreminjanje velikosti in prenosi so bili standardizirani v ECMAScript 2024.
Oznaka obsega ArrayBuffer.byteLength pomeni lastnost primerka, uporabljeno kot buffer.byteLength, in ne statične lastnosti konstruktorja ArrayBuffer. Ta accessor samo za branje vrne trenutno število bajtov: rezultat se po resize() medpomnilnika spremenljive velikosti spremeni, po odklopu pa je 0. Setter ne obstaja; uporaba getterja z nezdružljivim receiverjem, tudi SharedArrayBuffer, sproži TypeError.
Primeri
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); }Rezultat
4 8 true 6 10,20,30,40,0,0 3 20,30,40 true