CKTIS / JavaScript
Binarni podatki in tokovi
ArrayBuffer shranjuje bajte, tipizirana polja in DataView pa jih interpretirajo. Spoznajte skupni pomnilnik, vrstni red bajtov ter razliko med medpomnilnikom v pomnilniku in tokom.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new ArrayBuffer(byteLength)
new Uint8Array(buffer, byteOffset, length)
new DataView(buffer, byteOffset, byteLength)
view.setUint16(byteOffset, value, littleEndian)
view.getUint16(byteOffset, littleEndian)ArrayBuffer shranjuje binarne podatke, vendar ne omogoča indeksiranega dostopa do bajtov. Dostop omogočajo pogledi: Uint8Array vsak bajt interpretira kot število od 0 do 255, druga tipizirana polja pa bajte združujejo v elemente določene vrste. length tipiziranega polja šteje elemente; byteLength šteje bajte.
DataView bere in zapisuje vrednosti različnih vrst na odmikih, izraženih v bajtih. Pri večbajtnih vrednostih lahko izrecno izberete vrstni red bajtov: false pomeni big-endian, true pa little-endian. Tipizirana polja uporabljajo vrstni red bajtov okolja, zato za oblike z določenim vrstnim redom bajtov uporabite DataView.
Pogledi na isti medpomnilnik (buffer) lahko zajemajo različne obsege bajtov. Zapis prek enega pogleda je v drugem viden le pri tistih spremenjenih bajtih, ki jih ta drugi pogled zajema. subarray() ustvari še en pogled, medtem ko slice() tipiziranega polja kopira elemente. Primer zapiše dve števili in iste podatke prikaže kot bajte.
Medpomnilnik predstavlja podatke v pomnilniku; tok zaporedno dostavlja ali prejema bloke podatkov. Meja bloka ni nujno tudi meja zapisa. API-ji za tokove so del okolja, ne jedra ECMAScript. Primer uporablja funkcije, ki so na voljo od ES2015, brez API-jev za tokove; delovanje v Node.js 24 ne potrjuje podpore za API-je brskalnikov.
Primeri
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));Rezultat
18,52,171,205 4660
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.