A matriz do tipoInt16Array 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, useDataView. 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 ES2017new 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, consulteTypedArray.

Propriedades

Int16Array.BYTES_PER_ELEMENT

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

Int16Array.length

Propriedade de comprimento estático cujo valor é 0. Para o comprimento real (número de elementos), consulteInt16Array.prototype.length.

Int16Array.name

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

Int16Array.prototype

Protótipo para os objetos TypedArray.

Métodos

Int16Array.from()

Cria um novoInt16Array de um objeto semelhante a uma matriz ou iterável. Veja tambémArray.from().

Int16Array.of()

Cria um novoInt16Array com um número variável de argumentos. Veja tambémArray.of().

Int16Array prototype

TodosInt16Array objetos herdam de%TypedArray%.prototype.

Propriedades

Int16Array.prototype.constructor

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

Int16Array.prototype.bufferSomente leitura

Retorna oArrayBuffer referenciado peloInt16Array Fixado em tempo de construção eapenas leitura.

Int16Array.prototype.byteLengthSomente leitura

Retorna o tamanho (em bytes) de umInt16Array desde o ínicioArrayBuffer. Fixado em tempo de construção eapenas leitura.

Int16Array.prototype.byteOffsetSomente leitura

Retorna o deslocamento (em bytes) de umInt16Array desde o ínicioArrayBuffer. Fixado em tempo de construção eapenas leitura.

Int16Array.prototype.lengthSomente leitura

Retorna o número de elementos em umInt16Array. Fixado em tempo de construção eapenas leitura.

Métodos

Int16Array.prototype.copyWithin()

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

Int16Array.prototype.entries()

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

Int16Array.prototype.every()

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

Int16Array.prototype.fill()

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

Int16Array.prototype.filter()

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

Int16Array.prototype.find()

Retorna o valor encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ouundefined se não encontrado. Veja tambémArray.prototype.find().

Int16Array.prototype.findIndex()

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émArray.prototype.findIndex().

Int16Array.prototype.forEach()

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

Int16Array.prototype.includes()Experimental

Determina se uma matriz tipificada inclui um determinado elemento, retornandotrue oufalse. Veja tambémArray.prototype.includes().

Int16Array.prototype.indexOf()

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

Int16Array.prototype.join()

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

Int16Array.prototype.keys()

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

Int16Array.prototype.lastIndexOf()

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

Int16Array.prototype.map()

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

Int16Array.prototype.move()Não padrão

Versão não-padrão anterior deInt16Array.prototype.copyWithin().

Int16Array.prototype.reduce()

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émArray.prototype.reduce().

Int16Array.prototype.reduceRight()

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émArray.prototype.reduceRight().

Int16Array.prototype.reverse()

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

Int16Array.prototype.set()

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

Int16Array.prototype.slice()

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

Int16Array.prototype.some()

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

Int16Array.prototype.sort()

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

Int16Array.prototype.subarray()

Retorna um novoInt16Array a partir do índice de elemento inicial e final fornecido.

Int16Array.prototype.values()

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

Int16Array.prototype.toLocaleString()

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

Int16Array.prototype.toString()

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

Int16Array.prototype[@@iterator]()

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

Exemplos

Diferentes opções de criar umInt16Array:

// De um tamanhovar int16 = new Int16Array(2);int16[0] = 42;console.log(int16[0]); // 42console.log(int16.length); // 2console.log(int16.BYTES_PER_ELEMENT); // 2// De uma arrayvar arr = new Int16Array([21, 31]);console.log(arr[1]); // 31// De um outro TypedArrayvar x = new Int16Array([21, 31]);var y = new Int16Array(x);console.log(y[0]); // 21// De um ArrayBuffervar buffer = new ArrayBuffer(8);var z = new Int16Array(buffer, 0, 4);// De um interávelvar iterable = (function* () {  yield* [1, 2, 3];})();var int16 = new Int16Array(iterable);// Int16Array[1, 2, 3]

Especificações

Compatibilidade com navegadores

Notas de compatibilidade

A partir do ECMAScript 2015, os construtoresInt16Array precisam ser construídos com um operadornew. Chamar um construtorInt16Array como uma função sem onew, irá resultar emTypeError.

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

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

Ver também

• JavaScript typed arrays
• ArrayBuffer
• DataView