CKTIS / JavaScript
URLSearchParams.set(): impostare un parametro di query
URLSearchParams.set() assegna un valore a un parametro, eliminandone i duplicati oppure aggiungendone il nome se manca.
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.set(name, value)params.set(name, value) modifica l’oggetto e restituisce undefined, quindi non è possibile concatenare le chiamate. Entrambi gli argomenti sono obbligatori e vengono convertiti in stringhe.
Il metodo sostituisce il valore della prima voce corrispondente, mantenendone la posizione, e rimuove le altre voci con lo stesso nome. Se il nome non è presente, lo aggiunge alla fine. append(), invece, mantiene i duplicati.
Passa testo non codificato. Durante la serializzazione, gli spazi diventano + e i caratteri + letterali diventano %2B. Una chiamata a url.searchParams.set() aggiorna l’oggetto URL associato.
Questa Web API appartiene al WHATWG URL Standard, non a una specifica edizione di ECMAScript. Verifica la disponibilità nell’ambiente di destinazione; Node 24 non dimostra il supporto nei browser.
Esempi
const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);Risultato
q=a%2Bb+c&page=1&lang=pl 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.