DataView.prototype.setFloat16()
Baseline 2025Newly available
Since April 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
The setFloat16()
method of DataView
instances takes a number and stores it as a 16-bit floating point number in the 2 bytes starting at the specified byte offset of this DataView
. There is no alignment constraint; multi-byte values may be stored at any offset within bounds.
Try it
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
const view = new DataView(buffer);
view.setFloat16(1, Math.PI);
console.log(view.getFloat16(1));
// Expected output: 3.140625
Syntax
setFloat16(byteOffset, value)
setFloat16(byteOffset, value, littleEndian)
Parameters
byteOffset
-
The offset, in bytes, from the start of the view to store the data in.
value
-
The value to set. For how the value is encoded in bytes, see Value encoding and normalization.
littleEndian
Optional-
Indicates whether the data is stored in little- or big-endian format. If
false
orundefined
, a big-endian value is written.
Return value
Exceptions
RangeError
-
Thrown if the
byteOffset
is set such that it would store beyond the end of the view.
Examples
Using setFloat16()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setFloat16(0, 3);
dataview.getFloat16(1); // 0
Specifications
Specification |
---|
Float16Array # sec-dataview.prototype.setfloat16 |