Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ArrayBuffer: međuspremnik sirovih bajtova

ArrayBuffer rezervira nulama ispunjenu bajtovnu memoriju kojoj se pristupa preko typed array ili DataView i koja može biti promjenjive veličine.

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

Sintaksa

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) stvara memorijski blok ispunjen nulama. ArrayBuffer sam ne izlaže indeksirane bajtove; čitanje i pisanje zahtijevaju pogled kao Uint8Array ili DataView. byteLength prolazi kroz ToIndex: konačni razlomljeni dio odsijeca se prema nuli, NaN i undefined postaju 0, a čak -0.5 postaje -0 i zato duljina 0. Poziv bez new baca TypeError.

options.maxByteLength traži promjenjivu veličinu ako granica nije manja od početne veličine. resize(newLength) čuva zajednički prefiks, pri smanjenju odbacuje bajtove, a pri povećanju dodaje nule; pogledi koji prate duljinu prilagođavaju se. Fiksni međuspremnik ne može se mijenjati. slice() kopira raspon, a prijenos može odvojiti izvor.

Tek negativan rezultat nakon ToIntegerOrInfinity, +Infinity ili -Infinity, prekoračenje brojčanog raspona ili praktičnog memorijskog ograničenja implementacije, odnosno maksimum ispod početne veličine baca RangeError. Operacije nad podacima odvojenog međuspremnika i resize() fiksnog bacaju TypeError. Pogreške pretvorbe šire se. Promjena veličine i prijenosi standardizirani su u ECMAScript 2024.

Oznaka opsega ArrayBuffer.byteLength znači svojstvo instance koje se koristi kao buffer.byteLength, a ne statičko svojstvo konstruktora ArrayBuffer. Taj accessor samo za čitanje vraća trenutačan broj bajtova: rezultat se mijenja nakon resize() međuspremnika promjenjive veličine, a nakon odvajanja iznosi 0. Setter ne postoji; primjena gettera na nekompatibilan receiver, uključujući SharedArrayBuffer, baca TypeError.

Primjeri

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

Izvori