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

CKTIS / JavaScript

URLSearchParams.has() — vérifier la présence d’un paramètre

URLSearchParams.has() vérifie si un nom de paramètre ou une paire nom-valeur existe. La méthode renvoie true ou false sans modifier les 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.has(name)
params.has(name, value)

params.has(name) renvoie true si un paramètre portant ce nom existe. Dans un environnement d’exécution qui prend en charge la comparaison des valeurs, params.has(name, value) exige que le nom et la valeur correspondent dans une même paire, à condition que value ne soit pas undefined. Passer explicitement undefined comme second argument revient à l’omettre : params.has(name, undefined) ne vérifie que le nom. Lorsque les noms sont répétés, une seule paire correspondante suffit ; la méthode ne modifie pas les données.

La comparaison distingue les majuscules et les minuscules et porte sur des chaînes décodées, pas sur des fragments de la requête. Lors de l’analyse, + est interprété comme une espace. Une valeur vide signifie tout de même que le paramètre existe : pour empty=, has("empty") renvoie true.

Il s’agit d’une API Web du WHATWG URL Standard, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. La spécification ne suffit pas à établir la prise en charge dans le navigateur cible ; Node 24 dans le dépôt ne le prouve pas non plus. Vérifiez séparément la variante avec value.

Exemples

const params = new URLSearchParams("tag=js&tag=web&empty=&q=a+b");
console.log(params.has("tag"));
console.log(params.has("tag", "web"));
console.log(params.has("tag", "css"));
console.log(params.has("empty"));
console.log(params.has("missing"));
console.log(params.has("q", "a b"));

Résultat

true
true
false
true
false
true

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