CKTIS / JavaScript
Dane binarne i strumienie
ArrayBuffer przechowuje bajty, a tablice typowane i DataView udostępniają ich interpretację. Poznaj współdzielenie pamięci, kolejność bajtów oraz różnicę między buforem a strumieniem.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new ArrayBuffer(byteLength)
new Uint8Array(buffer, byteOffset, length)
new DataView(buffer, byteOffset, byteLength)
view.setUint16(byteOffset, value, littleEndian)
view.getUint16(byteOffset, littleEndian)ArrayBuffer przechowuje dane binarne, ale nie udostępnia indeksowanego dostępu do bajtów. Służą do tego widoki: Uint8Array interpretuje każdy bajt jako liczbę 0–255, a inne tablice typowane grupują bajty w elementy określonego typu. length tablicy typowanej liczy elementy; byteLength liczy bajty.
DataView odczytuje i zapisuje wartości różnych typów pod przesunięciami wyrażonymi w bajtach. Dla wartości wielobajtowych pozwala jawnie wybrać kolejność bajtów: false oznacza big-endian, a true little-endian. Tablice typowane używają kolejności bajtów środowiska, więc do formatów o ustalonej kolejności używaj DataView.
Widoki utworzone z tego samego bufora (buffer) mogą obejmować różne zakresy bajtów. Zapis przez jeden widok jest widoczny przez drugi tylko w zakresie, w jakim drugi widok obejmuje zmienione bajty. subarray() tworzy kolejny widok, natomiast slice() tablicy typowanej kopiuje elementy. Przykład zapisuje dwie liczby i pokazuje te same dane jako bajty.
Bufor reprezentuje dane w pamięci; strumień dostarcza lub odbiera kolejne porcje danych. Granica porcji nie musi być granicą rekordu. API strumieni należą do środowiska, nie do podstawowego ECMAScript. Przykład używa mechanizmów dostępnych od ES2015, bez API strumieni; działanie w Node.js 24 nie potwierdza obsługi API przeglądarkowych.
Przykłady
const buffer = new ArrayBuffer(4);
const view = new DataView(buffer);
view.setUint16(0, 0x1234, false);
view.setUint16(2, 0xABCD, false);
const bytes = new Uint8Array(buffer);
console.log(Array.from(bytes).join(","));
console.log(view.getUint16(0, false));Wynik
18,52,171,205 4660
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.