Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ArrayBuffer: vyrovnávacia pamäť surových bajtov

ArrayBuffer rezervuje nulami vyplnenú bajtovú pamäť, ku ktorej sa pristupuje cez typed array alebo DataView a ktorá môže meniť veľkosť.

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

Syntax

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) vytvorí blok pamäte vyplnený nulami. ArrayBuffer sám nesprístupňuje indexované bajty; čítanie a zápis vyžadujú pohľad ako Uint8Array alebo DataView. byteLength prechádza ToIndex: konečná desatinná časť sa odreže smerom k nule, NaN a undefined sa zmenia na 0 a dokonca -0.5 sa zmení na -0, teda dĺžku 0. Volanie bez new vyvolá TypeError.

options.maxByteLength požiada o meniteľnú veľkosť, ak limit nie je menší než počiatočná veľkosť. resize(newLength) zachová spoločný prefix, pri zmenšení bajty zahodí a pri zväčšení doplní nuly; pohľady sledujúce dĺžku sa prispôsobia. Pevný buffer meniť nemožno. slice() skopíruje rozsah a prenos môže zdroj odpojiť.

Až záporný výsledok po ToIntegerOrInfinity, +Infinity alebo -Infinity, prekročenie číselného rozsahu či praktického pamäťového limitu implementácie alebo maximum pod počiatočnou veľkosťou vyvolá RangeError. Dátové operácie nad odpojeným bufferom a resize() pevného bufferu vyvolajú TypeError. Chyby prevodu sa šíria. Zmena veľkosti a prenos boli štandardizované v ECMAScript 2024.

Označenie rozsahu ArrayBuffer.byteLength znamená vlastnosť inštancie používanú ako buffer.byteLength, nie statickú vlastnosť konštruktora ArrayBuffer. Tento accessor len na čítanie vracia aktuálny počet bajtov: výsledok sa po resize() meniteľného buffera zmení a po odpojení je 0. Setter neexistuje; použitie gettera s nekompatibilným receiverom vrátane SharedArrayBuffer vyvolá TypeError.

Prí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ýsledok

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

Zdroje