DataView.prototype.setUint16()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Methode setUint16() von DataView-Instanzen nimmt eine Zahl und speichert sie als 16-Bit-Integer ohne Vorzeichen in den 2 Bytes, die beim angegebenen Byte-Offset dieses DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können an einer beliebigen Stelle innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setUint16(1, 65535); // Max unsigned 16-bit integer

console.log(view.getUint16(1));
// Expected output: 65535

Syntax

js
setUint16(byteOffset, value)
setUint16(byteOffset, value, littleEndian)

Parameter

byteOffset

Der Offset, in Bytes, ab dem Beginn der Ansicht, um die Daten zu speichern.

value

Der zu setzende Wert. Informationen darüber, wie der Wert in Bytes codiert wird, finden Sie unter Wertcodierung und Normalisierung.

littleEndian Optional

Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert werden. Wenn false oder undefined, wird ein Big-Endian-Wert geschrieben.

Rückgabewert

undefined.

Ausnahmen

RangeError

Wird ausgelöst, wenn der byteOffset so gesetzt ist, dass er über das Ende der Ansicht hinaus speichern würde.

Beispiele

Verwendung von setUint16()

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setUint16(0, 3);
dataview.getUint16(1); // 768

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-dataview.prototype.setuint16

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch