CKTIS / JavaScript
DataView: izrecni dostop do binarnih formatov
DataView bere in zapisuje večbajtne vrednosti v medpomnilniku z izbranim vrstnim redom bajtov in brez zahteve po poravnavi.
Različica: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2
Sintaksa
new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)new DataView(buffer, byteOffset?, byteLength?) ustvari pogled na obstoječi ArrayBuffer ali SharedArrayBuffer; bajti se ne kopirajo. Za razliko od typed arrays dostop ni omejen na eno vrsto elementa ali poravnane odmike. Metode, kot so getUint16, setFloat32 in getBigInt64, sprejmejo odmik v bajtih. Izbirni littleEndian je privzeto false, zato večbajtne vrednosti privzeto uporabljajo big-endian.
byteOffset in izrecni byteLength gresta skozi ToIndex. Negativen rezultat, neskončnost ali obseg zunaj medpomnilnika sproži RangeError. Dostop, katerega celotna širina se ne prilega pogledu, prav tako sproži RangeError; neveljaven receiver, odklopljen medpomnilnik ali pogled zunaj meja po spremembi velikosti sproži TypeError. Metode BigInt, kot je setBigUint64, zavrnejo navaden Number; podajte na primer 1n.
Če je byteLength pri razširljivem ArrayBuffer izpuščen, pogled sledi trenutnemu koncu medpomnilnika. Izrecni byteLength ustvari pogled s fiksno dolžino, ki lahko po zmanjšanju ostane zunaj meja. DataView je iz ECMAScript 2015; razširljivi ArrayBuffer in pogledi s sledenjem dolžine so na voljo od ECMAScript 2024.
Oznaka obsega DataView.getUint16 pomeni metodo primerka, klicano kot view.getUint16(byteOffset, littleEndian?), in ne statične metode konstruktorja DataView. Prebere natanko 2 bajta pri poljubni poravnavi in vrne celo število od 0 do 65535. littleEndian z vrednostjo false ali undefined izbere big-endian, vrednost true pa little-endian; branje čez konec pogleda sproži RangeError.
Primeri
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); }Rezultat
18,52,52,18,0,0,192,63 1234 1234 1.5 1 true