CKTIS / JavaScript
URLSearchParams.set(): definir um parâmetro de consulta
URLSearchParams.set() atribui um valor a um parâmetro, removendo duplicados ou acrescentando o nome se ainda não existir.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
params.set(name, value)params.set(name, value) altera o objeto e devolve undefined, pelo que não é possível encadear chamadas. Ambos os argumentos são obrigatórios e convertidos em cadeias de caracteres.
O método substitui o valor da primeira entrada correspondente, mantendo a sua posição, e remove as restantes entradas com esse nome. Se o nome não existir, acrescenta-o no fim. Em contrapartida, append() mantém os duplicados.
Passa texto não codificado. Durante a serialização, os espaços transformam-se em + e os sinais + literais em %2B. Uma chamada a url.searchParams.set() atualiza o objeto URL associado.
Esta Web API faz parte do WHATWG URL Standard, não de uma edição específica do ECMAScript. Verifica a disponibilidade no ambiente de destino; o Node 24 não comprova o suporte nos browsers.
Exemplos
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);Resultado
q=a%2Bb+c&page=1&lang=pl true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.