Esta tradução está incompleta. Ajude atraduzir este artigo.
Resumo
A propriedade Array.prototype
representa o protótipo para o construtor Array
.
Property attributes of Array.prototype |
|
---|---|
Writable | no |
Enumerable | no |
Configurable | no |
Descrição
Instâncias de Array
herdam de Array.prototype
. Como em todos os construtores, você pode mudar o protótipo desse construtor para modificar todas as instâncias de Array
.
Um fato pouco conhecido: O próprio Array.prototype
é um Array
Array.isArray(Array.prototype); // true
Propriedades
-
Array.prototype.constructor
-
Especifica a função que cria um objeto do protótipo.
-
Array.prototype.length
- Reflete o número de elementos em um array.
Métodos
Métodos modificadores
Esses métodos modificam o array:
-
Array.prototype.copyWithin()
- Copia uma sequência de elementos do array dentro do array.
-
Array.prototype.fill()
- Preenche todos os elementos de um array com um elemento estático, começando de um índice inicial até um índice final.
-
Array.prototype.pop()
- Remove e retorna o último elemento de um array.
-
Array.prototype.push()
- Adiciona um ou mais elementos ao fim de um array e retorna o novo comprimeiro do array.
-
Array.prototype.reverse()
- Reverte a ordem dos elementos de um array - o primeiro vira o último e o último vira o primeiro.
-
Array.prototype.shift()
- Remove o primeiro elemento de um array e o retorna.
-
Array.prototype.sort()
- Ordena os elementos do array em questão e retorna o array.
-
Array.prototype.splice()
- Adiciona e/ou remove elementos de um array.
-
Array.prototype.unshift()
- Adiciona um ou mais elementos ao início de um array e retorna o novo comprimento do array.
Métodos de acesso
Esses métodos não modificam o array, mas sim retornam alguma representação dele.
-
Array.prototype.concat()
- Retorna um novo array formado por esse array concatenado com outro(s) array(s) e/ou valores.
-
Array.prototype.contains()
-
Verifica se o array possui cer, retornando
true
oufalse
apropriadamente. -
Array.prototype.join()
- Retorna uma string com todos os elementos do array
-
Array.prototype.slice()
- Retorna um novo array com uma parte do array sobre o qual o método foi chamado
-
Array.prototype.toSource()
-
Retorna um array literal representando o array especificado; você pode usar esse valor para criar um novo array. Esse método sobrescreve o método
Object.prototype.toSource()
. -
Array.prototype.toString()
-
Retonar uma string representando o array e seus elementos. Esse método sobrescreve o método
Object.prototype.toString()
. -
Array.prototype.toLocaleString()
-
Retonar uma string adequada ao idioma do usuário representando o array e seus elementos. Esse método sobrescreve o método
Object.prototype.toLocaleString()
. -
Array.prototype.indexOf()
- Representa o índice da primeira ocorrência de um valor especificado no array, ou -1 se o valor não estiver incluso no array.
-
Array.prototype.lastIndexOf()
- Representa o índice da última ocorrência de um valor especificado no array, ou -1 se o valor não estiver incluso no array
Iteration methods
Several methods take as arguments functions to be called back while processing the array. When these methods are called, the length
of the array is sampled, and any element added beyond this length from within the callback is not visited. Other changes to the array (setting the value of or deleting an element) may affect the results of the operation if the method visits the changed element afterwards. While the specific behavior of these methods in such cases is well-defined, you should not rely upon it so as not to confuse others who might read your code. If you must mutate the array, copy into a new array instead.
-
Array.prototype.forEach()
- Calls a function for each element in the array.
-
Array.prototype.entries()
-
Returns a new
Array Iterator
object that contains the key/value pairs for each index in the array. -
Array.prototype.every()
- Returns true if every element in this array satisfies the provided testing function.
-
Array.prototype.some()
- Returns true if at least one element in this array satisfies the provided testing function.
-
Array.prototype.filter()
- Creates a new array with all of the elements of this array for which the provided filtering function returns true.
-
Array.prototype.find()
-
Returns the found value in the array, if an element in the array satisfies the provided testing function or
undefined
if not found. -
Array.prototype.findIndex()
- Returns the found index in the array, if an element in the array satisfies the provided testing function or -1 if not found.
-
Array.prototype.keys()
-
Returns a new
Array Iterator
that contains the keys for each index in the array. -
Array.prototype.map()
- Creates a new array with the results of calling a provided function on every element in this array.
-
Array.prototype.reduce()
- Apply a function against an accumulator and each value of the array (from left-to-right) as to reduce it to a single value.
-
Array.prototype.reduceRight()
- Apply a function against an accumulator and each value of the array (from right-to-left) as to reduce it to a single value.
-
Array.prototype.values()
-
Returns a new
Array Iterator
object that contains the values for each index in the array. -
Array.prototype[@@iterator]()
-
Returns a new
Array Iterator
object that contains the values for each index in the array.
Métodos genéricos
Vários métodos do objeto Array em Javascript foram feitos para serem aplicados genericamentes em todos os objetos que "pareçam" Arrays. Isso é, eles podem ser usados em qualquer objeto que possuam uma propriedade length
(comprimento), e que possa ser usado a partir de propriedades numéricas (como índices no formato array[5]
). Alguns métodos, como join
, apenas lêem e as propriedades numéricas do objeto sobre o qual eles sãochamados. Outros, como reverse
, exigem que as propriedades numéricas e length
sejam mutáveis; sendo assim, esses métodos não podem ser chamados em objetos como String
, que não permitem que nenhuma das duas propriedades sejam modificadas.
Especifiações
Especificação | Status | Comentário |
---|---|---|
ECMAScript 1st Edition. | Padrão | Definição inicial |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype' in that specification. |
Standard | |
ECMAScript 6 (ECMA-262) The definition of 'Array.prototype' in that specification. |
Release Candidate |
Compatibilidade com Navegadore
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |