Int16Array
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
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.
Propriedades
Int16Array.BYTES_PER_ELEMENT-
Retorna um valor numérico do tamanho do elemento.
2no caso de umInt16Array. - Int16Array.length
-
Propriedade de comprimento estático cujo valor é 0. Para o comprimento real (número de elementos), consulte
Int16Array.prototype.length. Int16Array.name-
Retorna o valor da string do nome do construtor. No caso do tipo
Int16Array: "Int16Array". Int16Array.prototype-
Protótipo para os objetos TypedArray.
Métodos
Int16Array.from()-
Cria um novo
Int16Arrayde um objeto semelhante a uma matriz ou iterável. Veja tambémArray.from(). Int16Array.of()-
Cria um novo
Int16Arraycom um número variável de argumentos. Veja tambémArray.of().
Int16Array prototype
Todos Int16Array objetos herdam de %TypedArray%.prototype.
Propriedades
Int16Array.prototype.constructor-
Retorna a função que criou o protótipo de uma instância. Este é o construtor
Int16Arraypor padrão. Int16Array.prototype.bufferSomente leitura-
Retorna o
ArrayBufferreferenciado peloInt16ArrayFixado em tempo de construção e apenas leitura. Int16Array.prototype.byteLengthSomente leitura-
Retorna o tamanho (em bytes) de um
Int16Arraydesde o ínicioArrayBuffer. Fixado em tempo de construção e apenas leitura. Int16Array.prototype.byteOffsetSomente leitura-
Retorna o deslocamento (em bytes) de um
Int16Arraydesde o ínicioArrayBuffer. Fixado em tempo de construção e apenas leitura. Int16Array.prototype.lengthSomente leitura-
Retorna o número de elementos em um
Int16Array. Fixado em tempo de construção e apenas leitura.
Métodos
Int16Array.prototype.copyWithin()-
Copia uma sequência de elementos da matriz dentro da matriz. Veja também
Array.prototype.copyWithin(). Int16Array.prototype.entries()-
Retorna um novo
Array Iteratorobjeto 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ém
Array.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ém
Array.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ém
Array.prototype.filter(). Int16Array.prototype.find()-
Retorna o valor encontrado na matriz, se um elemento na matriz satisfizer a função de teste fornecida ou
undefinedse 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ém
Array.prototype.findIndex(). Int16Array.prototype.forEach()-
Chama uma função para cada elemento na matriz. Veja também
Array.prototype.forEach(). Int16Array.prototype.includes()Experimental-
Determina se uma matriz tipificada inclui um determinado elemento, retornando
trueoufalse. 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ém
Array.prototype.indexOf(). Int16Array.prototype.join()-
Junta todos os elementos de um array em uma string. Veja também
Array.prototype.join(). Int16Array.prototype.keys()-
Retorna um novo
Array Iteratorque 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ém
Array.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ém
Array.prototype.map(). Int16Array.prototype.move()Não padrão-
Versão não-padrão anterior de
Int16Array.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ém
Array.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ém
Array.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ém
Array.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ém
Array.prototype.slice(). Int16Array.prototype.some()-
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()-
Retorna um novo
Int16Arraya partir do índice de elemento inicial e final fornecido. Int16Array.prototype.values()-
Retorna um novo objeto
Array Iteratorque 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ém
Array.prototype.toLocaleString(). Int16Array.prototype.toString()-
Retorna uma string representando a matriz e seus elementos. Veja também
Array.prototype.toString(). Int16Array.prototype[@@iterator]()-
Retorna um novo objeto
Array Iteratorque contém os valores para cada índice na lista.
Exemplos
Diferentes opções de criar um Int16Array:
// 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® 2026 Language Specification> # sec-typedarray-objects> |
Compatibilidade com navegadores
Loading…
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.
var dv = Int16Array([1, 2, 3]);
// TypeError: calling a builtin Int16Array constructor
// without new is forbidden
var dv = new Int16Array([1, 2, 3]);