Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

URLSearchParams.has() — comprobar si existe un parámetro

URLSearchParams.has() comprueba si existe un nombre de parámetro o un par nombre-valor. Devuelve true o false sin modificar los parámetros.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

params.has(name)
params.has(name, value)

params.has(name) devuelve true si existe un parámetro con ese nombre. En un entorno de ejecución que admite la comparación de valores, params.has(name, value) exige que el nombre y el valor coincidan dentro del mismo par, siempre que value no sea undefined. Pasar explícitamente undefined como segundo argumento equivale a omitirlo: params.has(name, undefined) solo comprueba el nombre. Si hay nombres repetidos, basta con que coincida uno de los pares; el método no modifica los datos.

La comparación distingue entre mayúsculas y minúsculas y se realiza con cadenas decodificadas, no con fragmentos de la consulta. Al analizarla, + se interpreta como un espacio. Un valor vacío sigue indicando que el parámetro existe: para empty=, has("empty") devuelve true.

Esta es una API web del WHATWG URL Standard, no una característica de una edición concreta de ECMAScript. La especificación por sí sola no demuestra que sea compatible con el navegador de destino; Node 24 del repositorio tampoco lo demuestra. Comprueba por separado la variante con value.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes