База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DataView: явен достъп до двоични формати

DataView чете и записва многобайтови стойности в буфер с избран ред на байтовете и без изискване за подравняване.

Версия: ECMAScript 2015 onward; resizable ArrayBuffer behavior from ECMAScript 2024; example target: Node.js 24.22.2

Синтаксис

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

new DataView(buffer, byteOffset?, byteLength?) създава изглед към съществуващ ArrayBuffer или SharedArrayBuffer; байтовете не се копират. За разлика от typed arrays достъпът не е ограничен до един тип елемент или подравнени отмествания. Методи като getUint16, setFloat32 и getBigInt64 приемат отместване в байтове. Незадължителното littleEndian по подразбиране е false, затова многобайтовите стойности първоначално използват big-endian.

byteOffset и явно byteLength преминават през ToIndex. Отрицателен резултат, безкрайност или диапазон извън буфера хвърля RangeError. Достъп, чиято пълна ширина не се побира в изгледа, също хвърля RangeError; невалиден receiver, отделен буфер или изглед извън граници след преоразмеряване хвърля TypeError. BigInt методи като setBigUint64 отхвърлят обикновен Number; подайте например 1n.

Когато byteLength е пропуснат за преоразмерим ArrayBuffer, изгледът следва текущия край на буфера. Явно byteLength създава изглед с фиксирана дължина, който може да излезе извън граници след намаляване. DataView е от ECMAScript 2015; преоразмеримите ArrayBuffer и изгледите, следящи дължината, са налични от ECMAScript 2024.

Етикетът за обхват DataView.getUint16 означава метод на екземпляр, извикван като view.getUint16(byteOffset, littleEndian?), а не статичен метод на конструктора DataView. Той чете точно 2 байта при всякакво подравняване и връща цяло число от 0 до 65535. littleEndian със стойност false или undefined избира big-endian, а true — little-endian; четене след края на изгледа хвърля RangeError.

Примери

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

Резултат

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

Източници