Int16Array
==========

A matriz do tipo **`Int16Array`** representa uma matriz de inteiros assinados de 16 bits com dois complementos na ordem de bytes da plataforma. Se o controle sobre a ordem de bytes for necessário, use `DataView`. O conteúdo é inicializado em 0. Uma vez estabelecido, você pode fazer referência a elementos na matriz usando os métodos do objeto ou usando a sintaxe de índice da matriz padrão (ou seja, usando a notação de colchetes).

Sintaxe
-------
```

new Int16Array(); // novo no ES2017
new Int16Array(length);
new Int16Array(typedArray);
new Int16Array(object);
new Int16Array(buffer [, byteOffset [, length]]);
```


Para obter mais informações sobre a sintaxe do construtor e os parâmetros, consulte *TypedArray (en-US)*.

Propriedades
------------

`Int16Array.BYTES_PER_ELEMENT` (en-US)

Retorna um valor numérico do tamanho do elemento. `2` no caso de um `Int16Array`.

Int16Array.length

Propriedade de comprimento estático cujo valor é 0. Para o comprimento real (número de elementos), consulte `Int16Array.prototype.length` (en-US).

`Int16Array.name` (en-US)

Retorna o valor da string do nome do construtor. No caso do tipo `Int16Array`: "Int16Array".

`Int16Array.prototype` (en-US)

Protótipo para os objetos TypedArray.

Métodos
-------

`Int16Array.from()` (en-US)

Cria um novo `Int16Array` de um objeto semelhante a uma matriz ou iterável. Veja também `Array.from()`.

`Int16Array.of()` (en-US)

Cria um novo `Int16Array` com um número variável de argumentos. Veja também `Array.of()`.

`Int16Array` prototype
----------------------

Todos `Int16Array` objetos herdam de `%TypedArray%.prototype` (en-US).

### Propriedades

`Int16Array.prototype.constructor`

Retorna a função que criou o protótipo de uma instância. Este é o construtor `Int16Array` por padrão.

`Int16Array.prototype.buffer` (en-US) Somente leitura 

Retorna o `ArrayBuffer` referenciado pelo `Int16Array` Fixado em tempo de construção e **apenas leitura**.

`Int16Array.prototype.byteLength` (en-US) Somente leitura 

Retorna o tamanho (em bytes) de um `Int16Array` desde o ínicio `ArrayBuffer`. Fixado em tempo de construção e **apenas leitura**.

`Int16Array.prototype.byteOffset` (en-US) Somente leitura 

Retorna o deslocamento (em bytes) de um `Int16Array` desde o ínicio `ArrayBuffer`. Fixado em tempo de construção e **apenas leitura**.

`Int16Array.prototype.length` (en-US) Somente leitura 

Retorna o número de elementos em um `Int16Array`. Fixado em tempo de construção e **apenas leitura**.

### Métodos

`Int16Array.prototype.copyWithin()` (en-US)

Copia uma sequência de elementos da matriz dentro da matriz. Veja também `Array.prototype.copyWithin()`.

`Int16Array.prototype.entries()` (en-US)

Retorna um novo `Array Iterator` objeto que contém os pares de chave / valor para cada índice na matriz. Veja também `Array.prototype.entries()`.

`Int16Array.prototype.every()` (en-US)

Testa se todos os elementos na matriz passam no teste fornecido por uma função. Veja também `Array.prototype.every()`.

`Int16Array.prototype.fill()` (en-US)

Preenche todos os elementos de uma matriz de um índice inicial para um índice final com um valor estático. Veja também `Array.prototype.fill()`.

`Int16Array.prototype.filter()` (en-US)

Cria uma nova matriz com todos os elementos dessa matriz para os quais a função de filtragem fornecida retorna true. Veja também `Array.prototype.filter()`.

`Int16Array.prototype.find()` (en-US)

Retorna o valor encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ou `undefined` se não encontrado. Veja também `Array.prototype.find()`.

`Int16Array.prototype.findIndex()` (en-US)

Retorna o índice encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ou -1, se não for encontrado. Veja também `Array.prototype.findIndex()`.

`Int16Array.prototype.forEach()` (en-US)

Chama uma função para cada elemento na matriz. Veja também `Array.prototype.forEach()`.

`Int16Array.prototype.includes()` (en-US) 
Experimental

Determina se uma matriz tipificada inclui um determinado elemento, retornando `true` ou `false`. Veja também `Array.prototype.includes()`.

`Int16Array.prototype.indexOf()` (en-US)

Retorna o primeiro (menos) índice de um elemento dentro da matriz igual ao valor especificado ou -1 se nenhum for encontrado. Veja também `Array.prototype.indexOf()`.

`Int16Array.prototype.join()` (en-US)

Junta todos os elementos de um array em uma string. Veja também `Array.prototype.join()`.

`Int16Array.prototype.keys()` (en-US)

Retorna um novo `Array Iterator` que contém uma chave para cada índice no array. Veja também `Array.prototype.keys()`.

`Int16Array.prototype.lastIndexOf()` (en-US)

Retorna o último (maior) índice de um elemento dentro da matriz igual ao valor especificado ou -1 se nenhum for encontrado. Veja também `Array.prototype.lastIndexOf()`.

`Int16Array.prototype.map()` (en-US)

Cria uma nova matriz com os resultados da chamada de uma função fornecida em todos os elementos dessa matriz. Veja também `Array.prototype.map()`.

`Int16Array.prototype.move()` 
Non-standard
 Unimplemented

Versão não-padrão anterior de `Int16Array.prototype.copyWithin()` (en-US).

`Int16Array.prototype.reduce()` (en-US)

Aplique uma função contra um acumulador e cada valor da matriz (da esquerda para a direita) para reduzi-lo a um único valor. Veja também `Array.prototype.reduce()`.

`Int16Array.prototype.reduceRight()` (en-US)

Aplique uma função contra um acumulador e cada valor da matriz (da direita para a esquerda) para reduzi-lo a um único valor. Veja também `Array.prototype.reduceRight()`.

`Int16Array.prototype.reverse()` (en-US)

Inverte a ordem dos elementos de um array - o primeiro torna-se o último e o último torna-se o primeiro. Veja também `Array.prototype.reverse()`.

`Int16Array.prototype.set()` (en-US)

Armazena vários valores na matriz tipada, lendo valores de entrada de uma matriz especificada.

`Int16Array.prototype.slice()` (en-US)

Extrai uma seção de uma matriz e retorna uma nova matriz. Veja também `Array.prototype.slice()`.

`Int16Array.prototype.some()` (en-US)

Retorna true se pelo menos um elemento nessa matriz satisfizer a função de teste fornecida. Veja também `Array.prototype.some()`.

`Int16Array.prototype.sort()`

Classifica os elementos de uma matriz e retorna a matriz. Veja também `Array.prototype.sort()`.

`Int16Array.prototype.subarray()` (en-US)

Retorna um novo `Int16Array` a partir do índice de elemento inicial e final fornecido.

`Int16Array.prototype.values()` (en-US)

Retorna um novo objeto `Array Iterator` que contém os valores para cada índice na matriz. Veja também `Array.prototype.values()`.

`Int16Array.prototype.toLocaleString()` (en-US)

Retorna uma string localizada representando a matriz e seus elementos. Veja também `Array.prototype.toLocaleString()`.

`Int16Array.prototype.toString()` (en-US)

Retorna uma string representando a matriz e seus elementos. Veja também `Array.prototype.toString()`.

`Int16Array.prototype[@@iterator]()` (en-US)

Retorna um novo objeto `Array Iterator` que contém os valores para cada índice na lista.

Exemplos
--------

Diferentes opções de criar um `Int16Array`:


```js
// De um tamanho
var int16 = new Int16Array(2);
int16[0] = 42;
console.log(int16[0]); // 42
console.log(int16.length); // 2
console.log(int16.BYTES\_PER\_ELEMENT); // 2

// De uma array
var arr = new Int16Array([21, 31]);
console.log(arr[1]); // 31

// De um outro TypedArray
var x = new Int16Array([21, 31]);
var y = new Int16Array(x);
console.log(y[0]); // 21

// De um ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Int16Array(buffer, 0, 4);

// De um interável
var iterable = (function\* () {
  yield\* [1, 2, 3];
})();
var int16 = new Int16Array(iterable);
// Int16Array[1, 2, 3]
```

Especificações
--------------

| Specification |
| --- |
| ECMAScript Language Specification # table-49 |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Notas de compatibilidade
------------------------

A partir do ECMAScript 2015, os construtores `Int16Array` precisam ser construídos com um operador `new`. Chamar um construtor `Int16Array` como uma função sem o `new`, irá resultar em `TypeError`.


```js
var dv = Int16Array([1, 2, 3]);
// TypeError: calling a builtin Int16Array constructor
// without new is forbidden
```



```js
var dv = new Int16Array([1, 2, 3]);
```

Ver também
----------

* JavaScript typed arrays
* `ArrayBuffer`
* `DataView`