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

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.

Fontes