Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

ArrayBuffer: bufor surowych bajtów

ArrayBuffer rezerwuje zerowaną pamięć bajtową, którą odczytuje się przez typed array lub DataView, opcjonalnie z możliwością zmiany rozmiaru.

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

Składnia

new ArrayBuffer(byteLength[, { maxByteLength }])

new ArrayBuffer(byteLength, options?) tworzy blok pamięci wypełniony zerami. Sam ArrayBuffer nie udostępnia indeksowanych bajtów; do zapisu i odczytu potrzebny jest widok, np. Uint8Array albo DataView. byteLength przechodzi operację ToIndex: skończona część ułamkowa jest obcinana w stronę zera, NaN i undefined dają 0, a nawet -0.5 staje się -0 i daje długość 0. Wywołanie bez new powoduje TypeError.

options.maxByteLength tworzy bufor resizable, jeżeli limit nie jest mniejszy od rozmiaru początkowego. resize(newLength) zachowuje wspólny prefiks, odcina bajty przy zmniejszeniu i dopisuje zera przy zwiększeniu; widoki śledzące długość dostosowują się. Bufor stały nie może być zmieniany. slice() tworzy kopię wybranego zakresu, a transfer może odłączyć bufor źródłowy.

Dopiero ujemny wynik po ToIntegerOrInfinity, +Infinity lub -Infinity, przekroczenie zakresu albo praktycznego limitu pamięci implementacji, bądź limit mniejszy od rozmiaru początkowego, powoduje RangeError. Operacje wymagające danych na odłączonym buforze oraz resize() na buforze stałym powodują TypeError. Błędy konwersji argumentów są propagowane. Resizable ArrayBuffer i transfer zostały ustandaryzowane w ECMAScript 2024.

Obowiązek zakresu ArrayBuffer.byteLength oznacza właściwość instancji używaną jako buffer.byteLength, a nie statyczną właściwość konstruktora ArrayBuffer. Ten tylko do odczytu accessor zwraca bieżącą liczbę bajtów: wynik zmienia się po resize() bufora resizable, a po odłączeniu wynosi 0. Setter nie istnieje; użycie gettera z niezgodnym receiverem, w tym SharedArrayBuffer, powoduje TypeError.

Przykłady

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); }

Wynik

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

Źródła