CKTIS / JavaScript
URLSearchParams.has() — verificar a presença de um parâmetro
URLSearchParams.has() verifica se existe um nome de parâmetro ou um par nome-valor. Devolve true ou false sem alterar os parâmetros.
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.has(name)
params.has(name, value)params.has(name) devolve true se existir um parâmetro com esse nome. Num ambiente de execução que suporta a comparação de valores, params.has(name, value) exige que o nome e o valor correspondam no mesmo par, desde que value não seja undefined. Passar explicitamente undefined como segundo argumento equivale a omiti-lo: params.has(name, undefined) verifica apenas o nome. Se houver nomes repetidos, basta que um dos pares corresponda; o método não altera os dados.
A comparação distingue maiúsculas de minúsculas e é feita com cadeias descodificadas, não com partes da consulta. Durante a análise, + é tratado como um espaço. Um valor vazio continua a significar que o parâmetro existe: para empty=, has("empty") devolve true.
Esta é uma API Web do WHATWG URL Standard, não uma funcionalidade de uma edição específica do ECMAScript. A especificação, por si só, não comprova o suporte no navegador de destino; o Node 24 no repositório também não o comprova. Verifique separadamente a variante com value.
Exemplos
const params = new URLSearchParams("tag=js&tag=web&empty=&q=a+b");
console.log(params.has("tag"));
console.log(params.has("tag", "web"));
console.log(params.has("tag", "css"));
console.log(params.has("empty"));
console.log(params.has("missing"));
console.log(params.has("q", "a b"));Resultado
true true false true false 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.