KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.append(): queryparameters toevoegen

append(name, value) voegt een paar toe aan het einde van de queryparameters en behoudt eerdere waarden met dezelfde naam.

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

params.append(name, value) wijzigt het object en retourneert undefined, dus je kunt aanroepen niet aan elkaar koppelen. Beide argumenten zijn verplicht.

append() behoudt duplicaten en de volgorde. get() leest de eerste waarde; getAll() leest alle waarden. set() vervangt daarentegen de eerste waarde en verwijdert de overige waarden met die naam.

Geef niet-gecodeerde tekst door. toString() gebruikt de codering application/x-www-form-urlencoded: een spatie wordt + en een letterlijk + wordt %2B; het resultaat bevat geen ?. Een aanroep via url.searchParams werkt de bijbehorende URL-instantie bij. Deze Web API is vastgelegd in de URL Standard, niet in ECMAScript zelf.

Voorbeelden

const params = new URLSearchParams("tag=web");
const result = params.append("tag", "JavaScript basics");
console.log(params.toString());
console.log(JSON.stringify(params.getAll("tag")));
console.log(result);

Resultaat

tag=web&tag=JavaScript+basics
["web","JavaScript basics"]
undefined

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