KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.set(): een queryparameter instellen

URLSearchParams.set() kent een parameter één waarde toe en verwijdert duplicaten of voegt de naam toe als die nog ontbreekt.

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.set(name, value)

params.set(name, value) wijzigt het object en retourneert undefined, dus aanroepen kunnen niet aan elkaar worden gekoppeld. Beide argumenten zijn verplicht en worden omgezet naar tekenreeksen.

De methode vervangt de waarde van het eerste overeenkomende item en behoudt daarbij de positie. Andere items met dezelfde naam worden verwijderd. Als de naam ontbreekt, wordt deze aan het einde toegevoegd. append() behoudt daarentegen duplicaten.

Geef niet-gecodeerde tekst door. Bij serialisatie worden spaties omgezet in + en letterlijke +-tekens in %2B. Een aanroep van url.searchParams.set() werkt het bijbehorende URL-object bij.

Deze Web API maakt deel uit van de WHATWG URL Standard, niet van een bepaalde ECMAScript-editie. Controleer de beschikbaarheid in de doelomgeving; Node 24 bewijst niet dat browsers de API ondersteunen.

Voorbeelden

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Resultaat

q=a%2Bb+c&page=1&lang=pl
true

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