WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.get — einen Abfrageparameter auslesen

URLSearchParams.get(name) gibt den ersten Wert eines Parameters als Zeichenfolge zurück oder null, wenn der Parameter nicht vorhanden ist.

Version: 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) liest den ersten Wert mit dem angegebenen, groß- und kleinschreibungssensitiven Namen aus. Die Parameter werden dabei nicht geändert. Bei mehrfach vorkommenden Namen kannst du getAll(name) verwenden, um alle Werte abzurufen.

Das Ergebnis ist eine Zeichenfolge oder null. Ein leerer Wert wie empty= ergibt "", nicht null.

Beim Parsen einer Abfragezeichenfolge dekodiert URLSearchParams die Prozentkodierung und wandelt + in ein Leerzeichen um; %2B steht für ein wörtliches Pluszeichen. get() liest den bereits dekodierten Wert aus.

Diese API ist im WHATWG URL Standard definiert, nicht in einer ECMAScript-Ausgabe. Dass sie in Node 24 verfügbar ist, belegt keine Browserunterstützung.

Beispiele

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')
}));

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen