WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.getAll(): alle Werte eines Parameters

getAll(name) gibt ein Array aller Werte des Abfrageparameters mit dem angegebenen Namen zurück und behält dabei Reihenfolge und Duplikate bei.

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.getAll(name)

params.getAll(name) gibt ein Array von Zeichenfolgen für den angegebenen Parameternamen zurück. Die Reihenfolge und Duplikate bleiben erhalten; beim Abgleich der Namen wird zwischen Groß- und Kleinschreibung unterschieden.

Ist der Name nicht vorhanden, wird [] zurückgegeben. Ein vorhandener Parameter mit leerem Wert ergibt dagegen [""]. Im Gegensatz dazu gibt get(name) nur den ersten Wert oder null zurück.

Das Ergebnis ist ein separates Array: Änderungen daran verändern die Parameter nicht. Diese Methode ist eine Web-API, die im URL Standard definiert ist, und keine Funktion einer bestimmten ECMAScript-Edition. Prüfe, ob sie in deiner Zielumgebung verfügbar ist; Node 24 belegt nicht, dass sie auch von Browsern unterstützt wird.

Beispiele

const params = new URLSearchParams('tag=js&tag=web&tag=js&empty=');
console.log(JSON.stringify(params.getAll('tag')));
console.log(JSON.stringify(params.getAll('missing')));
console.log(JSON.stringify(params.getAll('empty')));

Ergebnis

["js","web","js"]
[]
[""]

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