KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.get — een queryparameter uitlezen

URLSearchParams.get(name) geeft de eerste parameterwaarde als tekenreeks terug, of null als de parameter 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.get(name)

params.get(name) leest de eerste waarde met de opgegeven naam. Hierbij wordt onderscheid gemaakt tussen hoofdletters en kleine letters. De parameters worden niet gewijzigd. Gebruik bij herhaalde namen getAll(name) om alle waarden op te halen.

Het resultaat is een tekenreeks of null. Een lege waarde, zoals empty=, levert "" op en geen null.

Bij het parsen van een querytekenreeks decodeert URLSearchParams procentcodering en zet het + om in een spatie; %2B staat voor een letterlijk plusteken. get() leest de al gedecodeerde waarde.

Deze API is vastgelegd in de WHATWG URL Standard, niet in een ECMAScript-editie. Dat de API beschikbaar is in Node 24 bewijst niet dat browsers deze ondersteunen.

Voorbeelden

const params = new URLSearchParams('tag=web&tag=api&q=hello+world&empty=');
console.log(JSON.stringify({
  tag: params.get('tag'),
  q: params.get('q'),
  empty: params.get('empty'),
  missing: params.get('missing')
}));

Resultaat

{"tag":"web","q":"hello world","empty":"","missing":null}

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