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