Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

URLSearchParams.forEach — parcourir les paramètres de requête

URLSearchParams.forEach appelle une fonction pour chaque paire de paramètres, en conservant l’ordre et les noms répétés. Les arguments du callback sont la valeur, la clé et l’objet de paramètres.

Version : 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 parcourt chaque paire dans l’ordre de la liste, y compris les clés répétées. Le callback reçoit (value, key, params), et non un index. Les clés et les valeurs sont des chaînes de caractères.

L’argument facultatif thisArg fournit la valeur de this à une fonction ordinaire ; il ne modifie pas le this d’une fonction fléchée. La méthode renvoie undefined ; les résultats du callback n’interrompent pas l’itération.

L’itération est synchrone et n’attend pas les promesses. Modifier la liste pendant le parcours peut changer les entrées visitées ; évitez de la modifier dans le callback.

L’exemple conserve les deux entrées tag ; l’analyse convertit + en espace. Il s’agit d’une API Web de la norme URL, et non d’une fonctionnalité propre à une édition d’ECMAScript. Vérifiez sa disponibilité dans votre environnement cible.

Exemples

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

Résultat

tag: js
tag: web
q: hello world

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources