Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.forEach — przechodzenie po parametrach zapytania

URLSearchParams.forEach wywołuje funkcję dla każdej pary parametrów, zachowując kolejność i powtarzające się nazwy. Argumenty funkcji to wartość, klucz i obiekt parametrów.

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

Składnia

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

URLSearchParams.forEach odwiedza każdą parę w kolejności listy, także powtarzające się klucze. Callback otrzymuje (value, key, params), nie indeks. Klucze i wartości są ciągami znaków.

Opcjonalny thisArg określa this zwykłej funkcji; nie zmienia this funkcji strzałkowej. Metoda zwraca undefined; wynik callbacku nie zatrzymuje iteracji.

Iteracja jest synchroniczna i nie czeka na obietnice. Zmiany listy podczas przechodzenia mogą zmienić odwiedzane elementy; unikaj modyfikowania jej w callbacku.

Przykład zachowuje oba tag; parser zamienia + na spację. To Web API ze standardu URL, nie funkcja konkretnej edycji ECMAScript. Sprawdź dostępność w docelowym środowisku.

Przykłady

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'));

Wynik

tag: js
tag: web
q: hello world

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła