Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje