CKTIS / JavaScript
DataView: jawny odczyt i zapis formatu binarnego
DataView odczytuje i zapisuje wielobajtowe wartości w buforze z wybraną kolejnością bajtów i bez wymogu wyrównania.
Wersja: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2
Składnia
new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)new DataView(buffer, byteOffset?, byteLength?) tworzy widok na istniejący ArrayBuffer lub SharedArrayBuffer; bajty nie są kopiowane. W przeciwieństwie do typed arrays dostęp nie jest ograniczony do jednego typu elementu ani wyrównanych przesunięć. Metody takie jak getUint16, setFloat32 i getBigInt64 przyjmują przesunięcie w bajtach. Opcjonalne littleEndian ma domyślnie wartość false, czyli dla wartości wielobajtowych używana jest kolejność big-endian.
byteOffset i jawne byteLength przechodzą ToIndex. Ujemny wynik, nieskończoność lub zakres wychodzący poza bufor powoduje RangeError. Dostęp, którego cały rozmiar nie mieści się w widoku, także powoduje RangeError; niepoprawny receiver, odłączony bufor lub widok będący poza zakresem po zmianie rozmiaru powoduje TypeError. Metody BigInt, na przykład setBigUint64, odrzucają zwykły Number; użyj wartości takiej jak 1n.
Gdy byteLength pominięto dla resizable ArrayBuffer, widok śledzi aktualny koniec bufora. Jawne byteLength tworzy widok o stałej długości, który może stać się poza zakresem po zmniejszeniu bufora. DataView pochodzi z ECMAScript 2015; resizable ArrayBuffer i widoki śledzące długość są dostępne od ECMAScript 2024.
Obowiązek zakresu DataView.getUint16 oznacza metodę instancji wywoływaną jako view.getUint16(byteOffset, littleEndian?), a nie metodę statyczną konstruktora DataView. Odczytuje dokładnie 2 bajty z dowolnego wyrównania i zwraca liczbę całkowitą od 0 do 65535. littleEndian równe false lub undefined wybiera big-endian, a true — little-endian; odczyt wychodzący poza koniec widoku powoduje RangeError.
Przykłady
const buffer = new ArrayBuffer(8);
const view = new DataView(buffer);
view.setUint16(0, 0x1234);
view.setUint16(2, 0x1234, true);
view.setFloat32(4, 1.5, true);
console.log(Array.from(new Uint8Array(buffer)).join(","));
console.log(view.getUint16(0).toString(16), view.getUint16(2, true).toString(16), view.getFloat32(4, true));
console.log(new DataView(buffer, 1, 3).byteOffset);
try { view.getUint32(6); } catch (error) { console.log(error instanceof RangeError); }Wynik
18,52,52,18,0,0,192,63 1234 1234 1.5 1 true