Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.forEach — scorrere i parametri di query

URLSearchParams.forEach chiama una funzione per ogni coppia di parametri, mantenendo l’ordine e i nomi ripetuti. Gli argomenti del callback sono il valore, la chiave e l’oggetto dei parametri.

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

Sintassi

params.forEach(callbackFn[, thisArg])
callbackFn(value, key, params)

URLSearchParams.forEach visita ogni coppia nell’ordine dell’elenco, comprese le chiavi ripetute. Il callback riceve (value, key, params), non un indice. Le chiavi e i valori sono stringhe.

L’argomento facoltativo thisArg fornisce this a una funzione ordinaria; non modifica il this di una funzione freccia. Il metodo restituisce undefined; i risultati del callback non interrompono l’iterazione.

L’iterazione è sincrona e non attende le promesse. Modificare l’elenco durante lo scorrimento può cambiare le voci visitate; evita di modificarlo all’interno del callback.

L’esempio conserva entrambe le voci tag; l’analisi converte + in uno spazio. Questa è una Web API dello standard URL, non una funzionalità di una specifica edizione di ECMAScript. Verifica la disponibilità nell’ambiente di destinazione.

Esempi

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'));

Risultato

tag: js
tag: web
q: hello world

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti