Revision 672155 of Int8Array

<div>
 {{JSRef("Global_Objects", "TypedArray", "Int8Array,Uint8Array,Uint8ClampedArray,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array")}}</div>
<h2 id="Summary">Summary</h2>
<p>The <strong><code>Int8Array</code></strong> typed array represents an array of twos-complement 8-bit signed integers. The contents are initialized to <code>0</code>. Once established, you can reference elements in the array using the object's methods, or using standard array index syntax (that is, using bracket notation).</p>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox">
Int8Array(length);
Int8Array(typedArray);
Int8Array(object);
Int8Array(buffer [, byteOffset [, length]]);</pre>
<p>For more information about the constructor syntax and the parameters, see <em><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#Syntax">TypedArray</a></em>.</p>
<h2 id="Properties">Properties</h2>
<dl>
 <dt>
  {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int8Array.BYTES_PER_ELEMENT")}}</dt>
 <dd>
  Returns a number value of the element size. <code>1</code> in the case of an <code>Int8Array</code>.</dd>
 <dt>
  Int8Array.length</dt>
 <dd>
  Length property whose value is 3.</dd>
 <dt>
  {{jsxref("TypedArray.name", "Int8Array.name")}}</dt>
 <dd>
  Returns the string value of the constructor name. In the case of the <code>Int8Array</code> type: "Int8Array".</dd>
 <dt>
  {{jsxref("TypedArray.prototype", "Int8Array.prototype")}}</dt>
 <dd>
  Prototype for the <em>TypedArray</em> objects.</dd>
</dl>
<h2 id="Methods">Methods</h2>
<dl>
 <dt>
  Int8Array.from()</dt>
 <dd>
  See {{jsxref("Array.from()")}}. Not implemented, see {{bug(896608)}}.</dd>
 <dt>
  Int8Array.of()</dt>
 <dd>
  See {{ jsxref("Array.of()")}}. Not implemented, see {{bug(896608)}}.</dd>
</dl>
<h2 id="Boolean_instances" name="Boolean_instances"><code>Int8Array</code> prototype</h2>
<p>All <code>Int8Array</code> objects inherit from {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}}.</p>
<h3 id="Properties_2">Properties</h3>
<dl>
 <dt>
  <code>Int8Array.prototype.constructor</code></dt>
 <dd>
  Returns the function that created an instance's prototype. This is the <code>Int8Array</code> constructor by default.</dd>
 <dt>
  {{jsxref("TypedArray.prototype.buffer", "Int8Array.prototype.buffer")}} {{readonlyInline}}</dt>
 <dd>
  Returns the {{jsxref("ArrayBuffer")}} referenced by the <code>Int8Array</code> Fixed at construction time and thus <strong>read only</strong>.</dd>
 <dt>
  {{jsxref("TypedArray.prototype.byteLength", "Int8Array.prototype.byteLength")}} {{readonlyInline}}</dt>
 <dd>
  Returns the length (in bytes) of the <code>Int8Array</code> from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus <strong>read only.</strong></dd>
 <dt>
  {{jsxref("TypedArray.prototype.byteOffset", "Int8Array.prototype.byteOffset")}} {{readonlyInline}}</dt>
 <dd>
  Returns the offset (in bytes) of the <code>Int8Array</code> from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus <strong>read only.</strong></dd>
 <dt>
  {{jsxref("TypedArray.prototype.length", "Int8Array.prototype.length")}} {{readonlyInline}}</dt>
 <dd>
  Returns the number of elements hold in the <code>Int8Array</code>. Fixed at construction time and thus <strong>read only.</strong></dd>
</dl>
<h3 id="Methods_2">Methods</h3>
<dl>
 <dt>
  {{jsxref("TypedArray.prototype.copyWithin()", "Int8Array.prototype.copyWithin()")}}</dt>
 <dd>
  See {{jsxref("Array.prototype.copyWithin()")}}.</dd>
 <dt>
  {{jsxref("TypedArray.prototype.move()", "Int8Array.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}</dt>
 <dd>
  Former non-standard version of {{jsxref("TypedArray.prototype.copyWithin()", "Int8Array.prototype.copyWithin()")}}.</dd>
 <dt>
  {{jsxref("TypedArray.prototype.set()", "Int8Array.prototype.set()")}}</dt>
 <dd>
  Stores multiple values in the <code>Int8Array</code>, reading input values from a specified array.</dd>
 <dt>
  {{jsxref("TypedArray.prototype.subarray()", "Int8Array.prototype.subarray()")}}</dt>
 <dd>
  Returns a new <code>Int8Array</code> from the given start and end element index.</dd>
</dl>
<h2 id="Examples">Examples</h2>
<pre class="brush: js">
// From a length
var int8 = new Int8Array(2);
int8[0] = 42;
console.log(int8[0]); // 42
console.log(int8.length); // 2
console.log(int8.BYTES_PER_ELEMENT); // 1

// From an array
var arr = new Int8Array([21,31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Int8Array([21, 31]);
var y = new Int8Array(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = Int8Array(buffer, 1, 4);
</pre>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td><a href="https://www.khronos.org/registry/typedarray/specs/latest/#7">Typed Array Specification</a></td>
   <td>Obsolete</td>
   <td><span><span>Superseded by ECMAScript 6.</span></span></td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#table-45', 'TypedArray constructors')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td>Initial definition in an ECMA standard.</td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>7.0</td>
    <td>{{ CompatGeckoDesktop("2") }}</td>
    <td>10</td>
    <td>11.6</td>
    <td>5.1</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Android</th>
    <th>Chrome for Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Mobile</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>4.0</td>
    <td>{{ CompatVersionUnknown() }}</td>
    <td>{{ CompatGeckoMobile("2") }}</td>
    <td>10</td>
    <td>11.6</td>
    <td>4.2</td>
   </tr>
  </tbody>
 </table>
</div>
<h2 id="See_also">See also</h2>
<ul>
 <li><a href="/en-US/docs/Web/JavaScript/Typed_arrays" title="en/JavaScript typed arrays">JavaScript typed arrays</a></li>
 <li>{{jsxref("ArrayBuffer")}}</li>
 <li>{{jsxref("DataView")}}</li>
</ul>