CKTIS / JavaScript
Binární data a proudy
ArrayBuffer ukládá bajty, zatímco typovaná pole a DataView je interpretují. Seznamte se se sdílenou pamětí, pořadím bajtů a rozdílem mezi vyrovnávací pamětí a proudem.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new ArrayBuffer(byteLength)
new Uint8Array(buffer, byteOffset, length)
new DataView(buffer, byteOffset, byteLength)
view.setUint16(byteOffset, value, littleEndian)
view.getUint16(byteOffset, littleEndian)ArrayBuffer ukládá binární data, ale neposkytuje indexovaný přístup k bajtům. Ten umožňují pohledy: Uint8Array interpretuje každý bajt jako číslo od 0 do 255, zatímco jiná typovaná pole seskupují bajty do prvků určitého typu. length typovaného pole počítá prvky; byteLength počítá bajty.
DataView čte a zapisuje hodnoty různých typů na posunech vyjádřených v bajtech. U vícebajtových hodnot umožňuje výslovně zvolit pořadí bajtů: false znamená big-endian a true little-endian. Typovaná pole používají pořadí bajtů daného prostředí, proto pro formáty se stanoveným pořadím bajtů použijte DataView.
Pohledy vytvořené nad stejným bufferem (buffer) mohou pokrývat různé rozsahy bajtů. Zápis přes jeden pohled se v jiném pohledu projeví jen u dotčených bajtů, které tento jiný pohled pokrývá. subarray() vytvoří další pohled, zatímco slice() typovaného pole zkopíruje prvky. Příklad zapíše dvě čísla a zobrazí stejná data jako bajty.
Vyrovnávací paměť představuje data v paměti; proud poskytuje nebo přijímá postupné bloky dat. Hranice bloku nemusí být zároveň hranicí záznamu. Rozhraní API pro proudy jsou součástí prostředí, nikoli jádra ECMAScriptu. Příklad používá funkce dostupné od ES2015 a nepoužívá rozhraní API pro proudy; fungování v Node.js 24 nepotvrzuje podporu rozhraní API prohlížečů.
Příklady
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));Výsledek
18,52,171,205 4660
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.