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

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.searchParams

URL.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.

Sources