Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

URLSearchParams.forEach — procházení parametrů dotazu

URLSearchParams.forEach zavolá funkci pro každou dvojici parametrů a zachová pořadí i opakované názvy. Argumenty callbacku jsou hodnota, klíč a objekt parametrů.

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

Syntaxe

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

URLSearchParams.forEach prochází každou dvojici v pořadí seznamu, včetně opakovaných klíčů. Callback dostává (value, key, params), nikoli index. Klíče a hodnoty jsou řetězce.

Volitelný thisArg určuje this běžné funkce; this šipkové funkce nemění. Metoda vrací undefined; výsledky callbacku iteraci nezastaví.

Iterace je synchronní a nečeká na promises. Změny seznamu během procházení mohou ovlivnit, které položky budou navštíveny; neměňte jej uvnitř callbacku.

Příklad zachovává obě položky tag; při parsování se + převede na mezeru. Jde o Web API standardu URL, nikoli o funkci konkrétní edice ECMAScriptu. Ověřte dostupnost v cílovém prostředí.

Příklady

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

Výsledek

tag: js
tag: web
q: hello world

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje