CKTIS / JavaScript
URLSearchParams.get — ler um parâmetro de consulta
URLSearchParams.get(name) devolve o primeiro valor do parâmetro como uma cadeia de caracteres, ou null se o parâmetro 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.get(name)params.get(name) lê o primeiro valor com o nome indicado, distinguindo maiúsculas de minúsculas. Não altera os parâmetros. Se um nome se repetir, use getAll(name) para obter todos os valores.
O resultado é uma cadeia de caracteres ou null. Um valor vazio, como empty=, produz "", não null.
Ao analisar uma cadeia de consulta, URLSearchParams descodifica a codificação percentual e converte + num espaço; %2B representa um sinal de mais literal. get() lê o valor já descodificado.
Esta API é definida pelo WHATWG URL Standard, não por uma edição de ECMAScript. A sua disponibilidade no Node 24 não comprova o suporte nos navegadores.
Exemplos
const params = new URLSearchParams('tag=web&tag=api&q=hello+world&empty=');
console.log(JSON.stringify({
tag: params.get('tag'),
q: params.get('q'),
empty: params.get('empty'),
missing: params.get('missing')
}));Resultado
{"tag":"web","q":"hello world","empty":"","missing":null}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.