Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DataView: explicitný prístup k binárnym formátom

DataView číta a zapisuje viacbajtové hodnoty v bufferi so zvoleným poradím bajtov a bez požiadavky na zarovnanie.

Verzia: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2

Syntax

new DataView(buffer); new DataView(buffer, byteOffset); new DataView(buffer, byteOffset, byteLength)

new DataView(buffer, byteOffset?, byteLength?) vytvorí pohľad na existujúci ArrayBuffer alebo SharedArrayBuffer; bajty sa nekopírujú. Na rozdiel od typed arrays nie je prístup obmedzený jedným typom prvku ani zarovnanými offsetmi. Metódy ako getUint16, setFloat32 a getBigInt64 prijímajú bajtový offset. Voliteľné littleEndian je predvolene false, takže viacbajtové hodnoty používajú big-endian.

byteOffset a explicitné byteLength prechádzajú ToIndex. Záporný výsledok, nekonečno alebo rozsah mimo buffer vyvolá RangeError. Prístup, ktorého celá šírka sa do pohľadu nezmestí, tiež vyvolá RangeError; neplatný receiver, odpojený buffer alebo pohľad mimo rozsahu po zmene veľkosti vyvolá TypeError. BigInt metódy ako setBigUint64 odmietajú bežný Number; odovzdajte napríklad 1n.

Ak je byteLength pri meniteľnom ArrayBuffer vynechaný, pohľad sleduje aktuálny koniec buffera. Explicitné byteLength vytvorí pohľad pevnej dĺžky, ktorý sa po zmenšení môže ocitnúť mimo rozsahu. DataView je z ECMAScript 2015; meniteľné ArrayBuffer a pohľady sledujúce dĺžku sú dostupné od ECMAScript 2024.

Označenie rozsahu DataView.getUint16 znamená metódu inštancie volanú ako view.getUint16(byteOffset, littleEndian?), nie statickú metódu konštruktora DataView. Prečíta presne 2 bajty pri ľubovoľnom zarovnaní a vráti celé číslo od 0 do 65535. littleEndian s hodnotou false alebo undefined zvolí big-endian, hodnota true zvolí little-endian; čítanie za koniec pohľadu vyvolá RangeError.

Príklady

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); }

Výsledok

18,52,52,18,0,0,192,63
1234 1234 1.5
1
true

Zdroje