JavaScript DataView setInt16() Method

The JavaScript DataView setInt16() method stores a number value as a 16-bit signed integer in the 2 bytes, starting at a specified byte offset of this DataView. Multiple bytes can be stored at any offset within the bounds.

If the number value is not in the range of -32768 to 32767, it will not store the value in this DataView, and if the byteOffset parameter value is outside the bounds of this DataView, it will throw a 'RangeError' exception.

Syntax

Following is the syntax of the JavaScript DataView setInt16() method −

setInt16(byteOffset, value, littleEndian)

Parameters

This method aceepts three parameters named 'byteOffset', 'value', and 'littleEndian', which are described below −

• byteOffset − The position in the DataView where the byte will be stored.
• value − A signed 16-bit integer that needs to be stored.
• littleEndian − It indicates whether the data value is stored in little- or big-endian format.

Return value

This method returns'undefined', as it only stores a byte value.

Example 1

The following program demonstrates the usage of the JavaScript DataView setInt16() method.

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 255;
   const byteOffset = 1;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //using the setInt16() method
   document.write("<br>The data_view.setInt16() method returns: ",  data_view.setInt16(byteOffset, value));
</script>
</body>
</html>

Output

The above program returns 'undefined' −

Value: 255
The byte offset: 1
The data_view.setInt16() method returns: undefined

Example 2

If the data value falls outside the range of-32768 to 32767, thesetInt16()method will not store the specified value as it exceeds the range for an 8-bit signed integer.

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 327678;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //using the setInt16() method
   data_view.setInt16(byteOffset, value);
   document.write("<br>The store value: ", data_view.getInt32(1));
</script>
</body>
</html>

Output

After executing the program, the data value will not be stored since it is outside the range of acceptable values −

Value: 327678
The byte offset: 0
The store value: -33554432

Example 3

If the value of the byteOffset parameter is outside the bounds of this data view, it will throw a 'RangeError' exception.

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 300;
   const byteOffset = -2;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   try {
      //using the setInt16() method
      data_view.setInt16(byteOffset, value);
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

Output

Once the above program is executed, it will throw a 'RangeError' exception as −

Value: 300
The byte offset: -2
RangeError: Offset is outside the bounds of the DataView