KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams — queryparameters

URLSearchParams leest queryparameters en past ze aan, waarbij herhaalde namen behouden blijven en formuliercodering wordt verwerkt.

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

new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()

URLSearchParams is een API uit de WHATWG URL-standaard, niet uit ECMAScript. De constructor accepteert een query (eventueel voorafgegaan door ?), een record of een reeks naam-waardeparen; een volledige URL wordt niet geparseerd.

get() retourneert de eerste waarde of null; getAll() retourneert alle waarden. append() voegt een paar toe. Als de opgegeven naam al voorkomt, wijzigt set() de waarde van het eerste paar met die naam en verwijdert het de overige paren met dezelfde naam. Anders voegt set() achteraan een nieuw paar toe.

toString() laat ? weg en gebruikt application/x-www-form-urlencoded: spaties worden + en letterlijke plustekens worden %2B. Geef de methoden niet-gecodeerde waarden door.

Wijzigingen aan url.searchParams werken de bijbehorende URL bij en kunnen de codering ervan veranderen. De standaard is geen browsercompatibiliteitstabel; Node 24 bewijst geen ondersteuning in browsers.

Voorbeelden

const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());

Resultaat

js,web
tag=api&q=a%2Bb+c

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