Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.has() — verificare la presenza di un parametro

URLSearchParams.has() verifica se esiste un nome di parametro o una coppia nome-valore. Restituisce true o false senza modificare i parametri.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

params.has(name)
params.has(name, value)

params.has(name) restituisce true se esiste un parametro con quel nome. In un ambiente di esecuzione che supporta il confronto dei valori, params.has(name, value) richiede che nome e valore corrispondano nella stessa coppia, purché value non sia undefined. Passare esplicitamente undefined come secondo argomento equivale a ometterlo: params.has(name, undefined) controlla solo il nome. Se i nomi sono ripetuti, è sufficiente una sola coppia corrispondente; il metodo non modifica i dati.

Il confronto distingue tra maiuscole e minuscole e riguarda stringhe decodificate, non frammenti della query. Durante l’analisi, + viene trattato come uno spazio. Anche un valore vuoto indica che il parametro esiste: per empty=, has("empty") restituisce true.

Questa è una Web API del WHATWG URL Standard, non una funzionalità di una specifica edizione di ECMAScript. La sola specifica non dimostra il supporto nel browser di destinazione; neanche Node 24 nel repository lo dimostra. Verifica separatamente la variante con value.

Esempi

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"));

Risultato

true
true
false
true
false
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti