WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.forEach — Abfrageparameter durchlaufen

URLSearchParams.forEach ruft für jedes Parameterpaar eine Funktion auf und bewahrt dabei Reihenfolge und wiederholte Namen. Die Callback-Argumente sind Wert, Schlüssel und das Parameterobjekt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

params.forEach(callbackFn[, thisArg])
callbackFn(value, key, params)

URLSearchParams.forEach durchläuft jedes Paar in der Reihenfolge der Liste, auch wiederholte Schlüssel. Der Callback erhält (value, key, params), keinen Index. Schlüssel und Werte sind Zeichenfolgen.

Das optionale thisArg legt this für eine gewöhnliche Funktion fest; das this einer Pfeilfunktion ändert es nicht. Die Methode gibt undefined zurück; Callback-Ergebnisse beenden die Iteration nicht.

Die Iteration ist synchron und wartet nicht auf Promises. Änderungen an der Liste während des Durchlaufens können beeinflussen, welche Einträge besucht werden; vermeide Änderungen innerhalb des Callbacks.

Das Beispiel behält beide tag-Einträge bei; beim Parsen wird + in ein Leerzeichen umgewandelt. Dies ist eine Web-API des URL-Standards und keine Funktion einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit in deiner Zielumgebung.

Beispiele

const params = new URLSearchParams('tag=js&tag=web&q=hello+world');
const lines = [];
params.forEach((value, key) => {
  lines.push(`${key}: ${value}`);
});
console.log(lines.join('\n'));

Ergebnis

tag: js
tag: web
q: hello world

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen