CKTIS / JavaScript
URL.searchParams — paramètres de requête
URL.searchParams expose les paramètres de requête sous la forme d’un objet URLSearchParams lié à l’URL.
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
url.searchParamsURL.searchParams est une propriété d’une instance de URL, et non une méthode statique. La propriété est en lecture seule, mais l’objet URLSearchParams renvoyé est modifiable. Les modifications mettent à jour l’URL ; les lectures répétées renvoient le même objet.
get() renvoie la première valeur ou null ; getAll() gère les noms répétés. set() remplace les valeurs d’un nom par une seule valeur.
La sérialisation utilise application/x-www-form-urlencoded : une espace devient +. Il s’agit d’une API Web WHATWG, et non d’une fonctionnalité d’une édition d’ECMAScript ; la compatibilité des navigateurs doit être vérifiée séparément.
Exemples
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Résultat
js,web https://example.com/?tag=api&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.