Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.searchParams

URL.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.

Fontes