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

CKTIS / JavaScript

URLSearchParams.get — lire un paramètre de requête

URLSearchParams.get(name) renvoie la première valeur du paramètre sous forme de chaîne, ou null si le paramètre est absent.

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.get(name)

params.get(name) lit la première valeur dont le nom correspond à celui indiqué, en tenant compte des majuscules et des minuscules. La méthode ne modifie pas les paramètres. Pour les noms répétés, utilisez getAll(name) afin de récupérer toutes les valeurs.

Le résultat est une chaîne ou null. Une valeur vide, telle que empty=, produit "", et non null.

Lorsqu’il analyse une chaîne de requête, URLSearchParams décode le codage en pourcentage et convertit + en espace ; %2B représente un signe plus littéral. get() lit la valeur déjà décodée.

Cette API est définie par le WHATWG URL Standard, et non par une édition d’ECMAScript. Sa disponibilité dans Node 24 ne prouve pas sa prise en charge par les navigateurs.

Exemples

const params = new URLSearchParams('tag=web&tag=api&q=hello+world&empty=');
console.log(JSON.stringify({
  tag: params.get('tag'),
  q: params.get('q'),
  empty: params.get('empty'),
  missing: params.get('missing')
}));

Résultat

{"tag":"web","q":"hello world","empty":"","missing":null}

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