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

CKTIS / JavaScript

URLSearchParams.get — leer un parámetro de consulta

URLSearchParams.get(name) devuelve el primer valor del parámetro como una cadena, o null si el parámetro no está presente.

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.get(name)

params.get(name) lee el primer valor cuyo nombre coincide exactamente, teniendo en cuenta mayúsculas y minúsculas. No modifica los parámetros. Si un nombre aparece varias veces, usa getAll(name) para obtener todos sus valores.

El resultado es una cadena o null. Un valor vacío, como empty=, produce "", no null.

Al analizar una cadena de consulta, URLSearchParams decodifica la codificación porcentual y convierte + en un espacio; %2B representa un signo más literal. get() lee el valor ya decodificado.

Esta API está definida por el WHATWG URL Standard, no por una edición de ECMAScript. Que esté disponible en Node 24 no demuestra que los navegadores la admitan.

Ejemplos

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}

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