Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DataView: explicitní přístup k binárním formátům

DataView čte a zapisuje vícebajtové hodnoty v bufferu se zvoleným pořadím bajtů a bez požadavku na zarovnání.

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

Syntaxe

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

new DataView(buffer, byteOffset?, byteLength?) vytvoří pohled na existující ArrayBuffer nebo SharedArrayBuffer; bajty se nekopírují. Na rozdíl od typed arrays není přístup omezen jedním typem prvku ani zarovnanými offsety. Metody jako getUint16, setFloat32 a getBigInt64 přijímají bajtový offset. Volitelné littleEndian je standardně false, takže vícebajtové hodnoty používají výchozí big-endian.

byteOffset a explicitní byteLength procházejí ToIndex. Záporný výsledek, nekonečno nebo rozsah mimo buffer vyvolá RangeError. Přístup, jehož celá šířka se do pohledu nevejde, také vyvolá RangeError; neplatný receiver, odpojený buffer nebo pohled mimo rozsah po změně velikosti vyvolá TypeError. BigInt metody jako setBigUint64 odmítají běžný Number; předejte například 1n.

Je-li byteLength u měnitelného ArrayBuffer vynechán, pohled sleduje aktuální konec bufferu. Explicitní byteLength vytvoří pohled pevné délky, který se po zmenšení může ocitnout mimo rozsah. DataView je z ECMAScript 2015; měnitelné ArrayBuffer a pohledy sledující délku jsou dostupné od ECMAScript 2024.

Označení rozsahu DataView.getUint16 znamená metodu instance volanou jako view.getUint16(byteOffset, littleEndian?), nikoli statickou metodu konstruktoru DataView. Přečte přesně 2 bajty při libovolném zarovnání a vrátí celé číslo od 0 do 65535. littleEndian s hodnotou false nebo undefined zvolí big-endian, hodnota true zvolí little-endian; čtení za konec pohledu vyvolá RangeError.

Pří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ýsledek

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

Zdroje