Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DataView: izričit pristup binarnim formatima

DataView čita i zapisuje višebajtne vrijednosti u međuspremniku uz odabrani redoslijed bajtova i bez zahtjeva za poravnanjem.

Verzija: 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?) stvara pogled na postojeći ArrayBuffer ili SharedArrayBuffer; bajtovi se ne kopiraju. Za razliku od typed arrays, pristup nije ograničen na jednu vrstu elementa ni poravnate pomake. Metode poput getUint16, setFloat32 i getBigInt64 primaju pomak u bajtovima. Neobavezni littleEndian zadano je false, pa višebajtne vrijednosti zadano koriste big-endian.

byteOffset i izričiti byteLength prolaze kroz ToIndex. Negativan rezultat, beskonačnost ili raspon izvan međuspremnika baca RangeError. Pristup čija puna širina ne stane u pogled također baca RangeError; nevaljan receiver, odvojen međuspremnik ili pogled izvan granica nakon promjene veličine baca TypeError. BigInt metode poput setBigUint64 odbacuju obični Number; predaj, primjerice, 1n.

Ako je byteLength izostavljen za promjenjivi ArrayBuffer, pogled prati trenutačni kraj međuspremnika. Izričiti byteLength stvara pogled fiksne duljine koji nakon smanjenja može biti izvan granica. DataView je iz ECMAScript 2015; promjenjivi ArrayBuffer i pogledi koji prate duljinu dostupni su od ECMAScript 2024.

Oznaka opsega DataView.getUint16 znači metodu instance koja se poziva kao view.getUint16(byteOffset, littleEndian?), a ne statičku metodu konstruktora DataView. Čita točno 2 bajta pri bilo kojem poravnanju i vraća cijeli broj od 0 do 65535. littleEndian s vrijednošću false ili undefined odabire big-endian, a true little-endian; čitanje preko kraja pogleda baca RangeError.

Primjeri

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

Izvori