Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.get — leggere un parametro di query

URLSearchParams.get(name) restituisce il primo valore del parametro come stringa, oppure null se il parametro non è presente.

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

params.get(name) legge il primo valore con il nome indicato, distinguendo tra maiuscole e minuscole. Non modifica i parametri. Se un nome è ripetuto, usa getAll(name) per recuperare tutti i valori.

Il risultato è una stringa oppure null. Un valore vuoto, come empty=, produce "", non null.

Quando analizza una stringa di query, URLSearchParams decodifica la codifica percentuale e converte + in uno spazio; %2B rappresenta un segno più letterale. get() legge il valore già decodificato.

Questa API è definita dal WHATWG URL Standard, non da un’edizione di ECMAScript. La disponibilità in Node 24 non dimostra il supporto nei browser.

Esempi

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')
}));

Risultato

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

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