Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti