Traduzione in corso.

Il metodo forEach() esegue una funzione fornita come argomento una volta per ogni coppia key/value nell'oggetto Map, secondo l'ordine dell'inseriemento dei valori.

Sintassi

myMap.forEach(callback[, thisArg])

Parametri

callback
Funzione da eseguire per ogni elemento.
thisArg
Valore da usare come this quando si esegue callback.

Descrizione

Il metodo forEach esegue il callback passato come parametro una volta per ogni key della map esistente. Non è invocato per key che sono state cancellate. Comunque, è invocato per valori che sono presenti ma hanno valore undefined.

callback è invocato con tre argomenti:

  • il valore dell'elemento
  • la chiave dell'elemento
  • l'oggetto Map su cui si sta eseguendo il ciclo

Se il parametro thisArg è fornito al forEach, sarà passato al callback quando viene invocato, per essere usato come suo valore this.  In caso contrario, sarà passato il valore undefined per essere usato come valore this. Il valore this visibile definitivamente dal callbackè determinato secondo le normali regole per determinare il this visibile da una funzione.

Il range di elementi processati da forEach è determinato anteriormente alla prima invocazione del callback. Gli elementi che sono aggiunti all'oggetto Map dopo che la chiamata a forEach inizi non saranno visitati dal callback. Se eleemnti esistenti dell'oggetto Map vengono cambiati, o cancellati, il loro valore passato al callback sarà il valore nel momento in cui il forEach li visita; elementi che vengono cancellati non sono visitati.

forEach esegue la funzione callback una volta per ogni elemento nell'oggetto Map; non restituisce alcun valore.

Esempi

Stampare il contenuto di un oggetto Map

Il seguente codice stampa nella console una riga per ogni elemento in un oggetto Map:

function logMapElements(value, key, map) {
    console.log("m[" + key + "] = " + value);
}
Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements);
// logs:
// "m[foo] = 3"
// "m[bar] = [object Object]"
// "m[baz] = undefined"

Specifiche

Specification Stato Commento
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Map.prototype.forEach' in that specification.
Standard Definizione iniziale.

Compatibilità dei browser

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support 38Edge Full support 12Firefox Full support 25IE Full support 11Opera Full support 25Safari Full support 8WebView Android Full support 38Chrome Android Full support 38Edge Mobile Full support 12Firefox Android Full support 25Opera Android Full support 25Safari iOS Full support 8Samsung Internet Android Full support Yesnodejs Full support 0.12

Legend

Full support  
Full support

Vedi anche

Tag del documento e collaboratori

Hanno collaborato alla realizzazione di questa pagina: azzar1, SphinxKnight, Andreaf
Ultima modifica di: azzar1,