CKTIS / JavaScript
Binárne údaje a prúdy
ArrayBuffer ukladá bajty, zatiaľ čo typované polia a DataView ich interpretujú. Zistite viac o zdieľanej pamäti, poradí bajtov a rozdiele medzi vyrovnávacou pamäťou a prúdom.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new ArrayBuffer(byteLength)
new Uint8Array(buffer, byteOffset, length)
new DataView(buffer, byteOffset, byteLength)
view.setUint16(byteOffset, value, littleEndian)
view.getUint16(byteOffset, littleEndian)ArrayBuffer ukladá binárne údaje, ale neposkytuje indexovaný prístup k bajtom. Prístup umožňujú pohľady: Uint8Array interpretuje každý bajt ako číslo od 0 do 255, zatiaľ čo iné typované polia zoskupujú bajty do prvkov určitého typu. length typovaného poľa počíta prvky; byteLength počíta bajty.
DataView číta a zapisuje hodnoty rôznych typov na posunoch vyjadrených v bajtoch. Pri viacbajtových hodnotách umožňuje výslovne vybrať poradie bajtov: false znamená big-endian a true little-endian. Typované polia používajú poradie bajtov daného prostredia, preto pre formáty so stanoveným poradím bajtov použite DataView.
Pohľady vytvorené nad tým istým bufferom (buffer) môžu pokrývať rôzne rozsahy bajtov. Zápis cez jeden pohľad sa v inom pohľade prejaví len pri dotknutých bajtoch, ktoré tento iný pohľad pokrýva. subarray() vytvorí ďalší pohľad, zatiaľ čo slice() typovaného poľa skopíruje prvky. Príklad zapíše dve čísla a zobrazí tie isté údaje ako bajty.
Vyrovnávacia pamäť predstavuje údaje v pamäti; prúd poskytuje alebo prijíma postupné bloky údajov. Hranica bloku nemusí byť zároveň hranicou záznamu. API prúdov patria do prostredia, nie do jadra ECMAScriptu. Príklad používa funkcie dostupné od ES2015, bez API prúdov; fungovanie v Node.js 24 nepotvrdzuje podporu API prehliadačov.
Prí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ýsledok
18,52,171,205 4660
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.