Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.
La proprietà Array.prototype
rappresenta il prototipo per il costruttore Array
.
Property attributes of Array.prototype |
|
---|---|
Writable | no |
Enumerable | no |
Configurable | no |
Descrizione
Le istanze Array
ereditano da Array.prototype
. Come con gli altri costruttori, si può cambiare il prototipo propagando i cambiamenti su tutte le sue istanze.
Piccola curiosità: Array.prototype
è un Array
:
Array.isArray(Array.prototype); // true
Proprietà
Array.prototype.constructor
- Restituisce il costruttore.
Array.prototype.length
- Restituisce il numero di elementi in un array.
Metodi
Metodi mutator
Questi metodi modificano l'array:
Array.prototype.copyWithin()
- Copia una sequenza di elementi dell'array all'interno dello stesso.
Array.prototype.fill()
- Riempie le posizioni dell'array contenute tra 2 indici con un valore fisso.
Array.prototype.pop()
- Rimuove e restituisce l'ultimo elemento dell'array.
Array.prototype.push()
- Accoda uno o più elementi all'array e restituisce la lunghezza aggiornata dello stesso.
Array.prototype.reverse()
- Inverte l'ordine delle posizioni degli elementi all'interno dell'array.
Array.prototype.shift()
- Rimuove e resistuisce il primo elemento di un array.
Array.prototype.sort()
- Ordina gli elementi di un array all'interno di esso e restituisce l'array.
Array.prototype.splice()
- Aggiunge e/o rimuove elementi da un array.
Array.prototype.unshift()
- Aggiunge uno o più elementi all'inizio di un array e restituisce la lunghezza aggiornata dello stesso.
Metodi accessor
Questi metodi non modificano l'array e ne restituiscono una sua rappresentazione.
Array.prototype.concat()
- Restituisce un nuovo array costituito dall'array stesso insieme ad altri array/valori.
Array.prototype.includes()
- Restituisce
true
se l'array contiene un certo elemento,false
altrimenti. Array.prototype.join()
- Resituisce i valori dell'array come stringa.
Array.prototype.slice()
- Restituisce un nuovo array cosituito da elementi dell'array originale.
Array.prototype.toSource()
- Returns an array literal representing the specified array; you can use this value to create a new array. Overrides the
Object.prototype.toSource()
method. Array.prototype.toString()
- Returns a string representing the array and its elements. Overrides the
Object.prototype.toString()
method. Array.prototype.toLocaleString()
- Returns a localized string representing the array and its elements. Overrides the
Object.prototype.toLocaleString()
method. Array.prototype.indexOf()
- Returns the first (least) index of an element within the array equal to the specified value, or -1 if none is found.
Array.prototype.lastIndexOf()
- Returns the last (greatest) index of an element within the array equal to the specified value, or -1 if none is found.
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.
Generic methods
Many methods on the JavaScript Array object are designed to be generally applied to all objects which “look like” Arrays. That is, they can be used on any object which has a length
property, and which can usefully be accessed using numeric property names (as with array[5]
indexing). TODO: give examples with Array.prototype.forEach.call, and adding the method to an object like JavaArray
or String
. Some methods, such as join
, only read the length
and numeric properties of the object they are called on. Others, like reverse
, require that the object's numeric properties and length
be mutable; these methods can therefore not be called on objects like String
, which does not permit its length
property or synthesized numeric properties to be set.
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. |
ECMAScript 5.1 (ECMA-262) The definition of 'Array.prototype' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype' in that specification. |
Standard |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |