diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:41:15 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:41:15 -0500 |
| commit | 4b1a9203c547c019fc5398082ae19a3f3d4c3efe (patch) | |
| tree | d4a40e13ceeb9f85479605110a76e7a4d5f3b56b /files/de/web/javascript/reference/global_objects/map/foreach | |
| parent | 33058f2b292b3a581333bdfb21b8f671898c5060 (diff) | |
| download | translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.tar.gz translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.tar.bz2 translated-content-4b1a9203c547c019fc5398082ae19a3f3d4c3efe.zip | |
initial commit
Diffstat (limited to 'files/de/web/javascript/reference/global_objects/map/foreach')
| -rw-r--r-- | files/de/web/javascript/reference/global_objects/map/foreach/index.html | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/files/de/web/javascript/reference/global_objects/map/foreach/index.html b/files/de/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..017fa9b069 --- /dev/null +++ b/files/de/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,104 @@ +--- +title: Map.prototype.forEach() +slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +<div>{{JSRef}}</div> + +<p>Die <code><strong>forEach()</strong></code> Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem <code>Map</code> Objekt in der Einfügereihenfolge aus.</p> + +<div>{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}}</div> + + + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox"><code><em>myMap</em>.forEach(<em>callback</em>[, <em>thisArg</em>])</code></pre> + +<h3 id="Parameter">Parameter</h3> + +<dl> + <dt><code>callback</code></dt> + <dd>Funktion, die für jedes Schlüssel/Werte-Paar aufgerufen wird.</dd> + <dt><code>thisArg</code></dt> + <dd>Wert, der bei der Ausführung der <code>callback</code>-Funktion als <code>this</code> genutzt wird.</dd> +</dl> + +<h3 id="Rückgabewert">Rückgabewert</h3> + +<p>{{jsxref("undefined")}}.</p> + +<h2 id="Beschreibung">Beschreibung</h2> + +<p>Die <code>forEach</code> Methode ruft die übergebene Funktion für jedes Schlüssel/Wert Paar in dem <code>Map</code> Objekt aus. Die <code>callback</code> Funktion wird nicht aufgerufen, wenn der Schlüssel gelöscht wurde. Sie wird aber aufgerufen, wenn der aktuelle Wert <code>undefined</code> ist.</p> + +<p>Die <code>callback</code> Funktion wird mit <strong>drei Parametern</strong> aufgerufen:</p> + +<ul> + <li>der <strong>Wert des Elements</strong></li> + <li>der <strong>Schlüssel des Elements</strong></li> + <li>das <strong><code>Map</code> Objekt, das durchlaufen wird</strong></li> +</ul> + +<p>Wenn der <code>thisArg</code>-Parameter an <code>forEach</code> übergeben wird, wird er auch an die <code>callback-Funktion</code> als deren <code>this</code> Wert weitergegeben. Andernfalls wird dafür <code>undefined</code> genutzt. <code>Der this</code>-Wert, der in der <code>callback-Funktion</code> wahrgenommen wird, ist festgelegt durch <a href="/de/docs/Web/JavaScript/Reference/Operators/this">die generellen Regeln für die Nutzung von <code>this</code> in einer Funktion.</a></p> + +<p>Jeder Wert wird einmal besucht, mit Außnahme von Fällen, in denen ein Wert glöscht und neu hinzugefügt wird, bevor <code>forEach</code> fertig ist. Die <code>callback</code> Funktion wird nicht für Wert aufgerufen, die vorher gelöscht wurden. Neue Werte, die vor der Beendigung von <code>forEach</code> hinzugefügt werden, werden berücksichtigt.</p> + +<p>Die <code>forEach</code> Methode ruft <code>callback</code> für jedes Element in dem <code>Map</code> Objekt aus. <code>forEach</code> gibt keinen Wert zurück.</p> + +<h2 id="Beispiele">Beispiele</h2> + +<h3 id="Ausgabe_der_Inhalte_eines_Map_Objekts">Ausgabe der Inhalte eines <code>Map</code> Objekts</h3> + +<p>Der folgende Code gibt für jedes Element in der Map eine Nachricht in der Konsole aus.</p> + +<pre class="brush:js">function logMapElements(value, key, map) { + console.log(`m[${key}] = ${value}`); +} +new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements); +// logs: +// "m[foo] = 3" +// "m[bar] = [object Object]" +// "m[baz] = undefined" +</pre> + +<h2 id="Spezifikationen">Spezifikationen</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spezifikation</th> + <th scope="col">Status</th> + <th scope="col">Kommentar</th> + </tr> + <tr> + <td>{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}</td> + <td>{{Spec2('ES2015')}}</td> + <td>Initiale Definition.</td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browserkompatibilität">Browserkompatibilität</h2> + + + +<p>{{Compat("javascript.builtins.Map.forEach")}}</p> + +<h2 id="Siehe_auch">Siehe auch</h2> + +<ul> + <li>{{jsxref("Array.prototype.forEach()")}}</li> + <li>{{jsxref("Set.prototype.forEach()")}}</li> +</ul> |
