CKTIS / JavaScript
URL.searchParams — parâmetros de consulta
URL.searchParams expõe os parâmetros de consulta como um objeto URLSearchParams associado ao URL.
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
url.searchParamsURL.searchParams é uma propriedade de uma instância de URL, não um método estático. A propriedade é só de leitura, mas o objeto URLSearchParams devolvido pode ser alterado. As alterações atualizam o URL; leituras repetidas devolvem o mesmo objeto.
get() devolve o primeiro valor ou null; getAll() trata nomes repetidos. set() substitui os valores de um nome por um único valor.
A serialização utiliza application/x-www-form-urlencoded: um espaço passa a +. Esta é uma Web API WHATWG, não uma funcionalidade de uma edição ECMAScript; a compatibilidade dos browsers tem de ser verificada separadamente.
Exemplos
const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);Resultado
js,web https://example.com/?tag=api&q=hello+world
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.