CKTIS / JavaScript
ArrayBuffer: vyrovnávací paměť surových bajtů
ArrayBuffer rezervuje nulami naplněnou bajtovou paměť, ke které se přistupuje přes typed array nebo DataView a která může měnit velikost.
Verze: ECMAScript 2024 onward for resizable and transferable ArrayBuffer; example target: Node.js 24.22.2
Syntaxe
new ArrayBuffer(byteLength[, { maxByteLength }])new ArrayBuffer(byteLength, options?) vytvoří blok paměti vyplněný nulami. ArrayBuffer sám nezpřístupňuje indexované bajty; čtení a zápis vyžadují pohled jako Uint8Array nebo DataView. byteLength prochází ToIndex: konečná desetinná část se ořízne směrem k nule, NaN a undefined se změní na 0 a dokonce -0.5 se změní na -0, tedy délku 0. Volání bez new vyvolá TypeError.
options.maxByteLength požádá o měnitelnou velikost, pokud limit není menší než počáteční velikost. resize(newLength) zachová společný prefix, při zmenšení bajty zahodí a při zvětšení doplní nuly; pohledy sledující délku se přizpůsobí. Pevný buffer měnit nelze. slice() zkopíruje rozsah a přenos může zdroj odpojit.
Teprve záporný výsledek po ToIntegerOrInfinity, +Infinity nebo -Infinity, překročení číselného rozsahu či praktického paměťového limitu implementace nebo maximum pod počáteční velikostí vyvolá RangeError. Datové operace nad odpojeným bufferem a resize() pevného bufferu vyvolají TypeError. Chyby převodu se šíří. Změna velikosti a přenos byly standardizovány v ECMAScript 2024.
Označení rozsahu ArrayBuffer.byteLength znamená vlastnost instance používanou jako buffer.byteLength, nikoli statickou vlastnost konstruktoru ArrayBuffer. Tento accessor pouze pro čtení vrací aktuální počet bajtů: výsledek se po resize() měnitelného bufferu změní a po odpojení je 0. Setter neexistuje; použití getteru s nekompatibilním receiverem včetně SharedArrayBuffer vyvolá TypeError.
Příklady
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); }Výsledek
4 8 true 6 10,20,30,40,0,0 3 20,30,40 true