KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.forEach — queryparameters doorlopen

URLSearchParams.forEach roept voor elk parameterpaar een functie aan en behoudt daarbij de volgorde en herhaalde namen. De callbackargumenten zijn de waarde, sleutel en het parameterobject.

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

Syntax

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

URLSearchParams.forEach bezoekt elk paar in de volgorde van de lijst, ook bij herhaalde sleutels. De callback ontvangt (value, key, params), geen index. Sleutels en waarden zijn tekenreeksen.

Het optionele thisArg levert this voor een gewone functie; het verandert this van een pijl functie niet. De methode retourneert undefined; callbackresultaten stoppen de iteratie niet.

De iteratie is synchroon en wacht niet op promises. Wijzigingen in de lijst tijdens het doorlopen kunnen veranderen welke items worden bezocht; vermijd wijzigingen binnen de callback.

Het voorbeeld behoudt beide tag-items; bij het parseren wordt + omgezet in een spatie. Dit is een Web-API uit de URL-standaard, geen functie van een bepaalde ECMAScript-editie. Controleer de beschikbaarheid in je doelomgeving.

Voorbeelden

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

Resultaat

tag: js
tag: web
q: hello world

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen