CKTIS / JavaScript
URLSearchParams.forEach — percorrer os parâmetros de consulta
URLSearchParams.forEach chama uma função para cada par de parâmetros, preservando a ordem e os nomes repetidos. Os argumentos do callback são o valor, a chave e o objeto de 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.forEach(callbackFn[, thisArg])
callbackFn(value, key, params)URLSearchParams.forEach visita cada par pela ordem da lista, incluindo chaves repetidas. O callback recebe (value, key, params), não um índice. As chaves e os valores são cadeias de caracteres.
O argumento opcional thisArg fornece o valor de this a uma função normal; não altera o this de uma função seta. O método devolve undefined; os resultados do callback não interrompem a iteração.
A iteração é síncrona e não aguarda promessas. Alterar a lista durante o percurso pode mudar as entradas visitadas; evite modificá-la dentro do callback.
O exemplo preserva ambas as entradas tag; a análise converte + num espaço. Esta é uma API Web do padrão URL, não uma funcionalidade de uma edição específica de ECMAScript. Verifique a disponibilidade no seu ambiente de destino.
Exemplos
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
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.