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

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.

Fontes