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

CKTIS / JavaScript

URLSearchParams.forEach — recorrer los parámetros de consulta

URLSearchParams.forEach llama a una función para cada par de parámetros y conserva el orden y los nombres repetidos. Los argumentos del callback son el valor, la clave y el objeto de 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.forEach(callbackFn[, thisArg])
callbackFn(value, key, params)

URLSearchParams.forEach visita cada par en el orden de la lista, incluidas las claves repetidas. El callback recibe (value, key, params), no un índice. Las claves y los valores son cadenas.

El argumento opcional thisArg proporciona el valor de this para una función normal; no cambia el this de una función flecha. El método devuelve undefined; los resultados del callback no detienen la iteración.

La iteración es síncrona y no espera a las promesas. Modificar la lista durante el recorrido puede cambiar qué entradas se visitan; evita modificarla dentro del callback.

El ejemplo conserva las dos entradas tag; el análisis convierte + en un espacio. Esta es una API Web del estándar URL, no una característica de una edición concreta de ECMAScript. Comprueba su disponibilidad en tu entorno de destino.

Ejemplos

const params = new URLSearchParams('tag=js&tag=web&q=hello+world');
const lines = [];
params.forEach((value, key) => {
  lines.push(`${key}: ${value}`);
});
console.log(lines.join('\n'));

Resultado

tag: js
tag: web
q: hello world

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