KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.prototype.toString — queryparameters serialiseren

Met `params.toString()` krijg je de queryparameters terug als tekst, zonder een `?` aan het begin. De methode gebruikt formuliercodering en behoudt de volgorde en herhaalde namen.

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.toString()

URLSearchParams.prototype.toString is de instantiemethode die queryparameters serialiseert. Roep de methode zonder argumenten aan met params.toString(). De eigenschap URLSearchParams.toString van de constructor verwijst daarentegen naar de overgeërfde methode Function.prototype.toString, die geen parameters serialiseert.

De instantiemethode geeft de parametertekst terug zonder een ? aan het begin, niet een volledige URL. Een lege lijst levert "" op.

De serialisatie gebruikt application/x-www-form-urlencoded en UTF-8: een spatie wordt + en een letterlijke + wordt %2B. Geef niet-gecodeerde waarden op om te voorkomen dat % opnieuw wordt gecodeerd.

Paren worden samengevoegd met &, namen en waarden met =. De volgorde en herhaalde namen blijven behouden; een lege waarde levert name= op. De methode sorteert de parameters niet en verandert ze niet. Dit is een web-API uit de URL Standard, geen functie die door ECMAScript is gedefinieerd.

Voorbeelden

const params = new URLSearchParams([
  ["q", "a b+c"],
  ["tag", "js"],
  ["tag", "web"],
  ["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));

Resultaat

q=a+b%2Bc&tag=js&tag=web&empty=
""

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