CKTIS / JavaScript
URLSearchParams — paramètres de requête
URLSearchParams lit et modifie les paramètres de requête, en conservant les noms répétés et en gérant l’encodage de type formulaire.
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
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams est une API de la norme WHATWG URL, et non d’ECMAScript. Son constructeur accepte une requête (éventuellement précédée de ?), un enregistrement ou des paires nom-valeur ; il n’analyse pas une URL complète.
get() renvoie la première valeur ou null ; getAll() renvoie toutes les valeurs. append() ajoute une paire. Si le nom indiqué existe déjà, set() modifie la valeur de la première paire portant ce nom et supprime les autres paires du même nom. Sinon, set() ajoute une nouvelle paire à la fin.
toString() omet ? et utilise application/x-www-form-urlencoded : les espaces deviennent + et les signes plus littéraux deviennent %2B. Passez des valeurs non encodées aux méthodes.
Modifier url.searchParams met à jour l’URL associée et peut changer son encodage. La norme n’est pas un tableau de compatibilité des navigateurs ; Node 24 ne prouve pas la prise en charge par les navigateurs.
Exemples
const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());Résultat
js,web tag=api&q=a%2Bb+c
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.