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

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.

Fontes