CKTIS / JavaScript
URLSearchParams.has() — Vorhandensein eines Parameters prüfen
URLSearchParams.has() prüft, ob ein Parametername oder ein Name-Wert-Paar vorhanden ist. Die Methode gibt true oder false zurück, ohne die Parameter zu verändern.
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.has(name)
params.has(name, value)params.has(name) gibt true zurück, wenn ein Parameter mit diesem Namen vorhanden ist. In einer Laufzeitumgebung, die den Wertabgleich unterstützt, müssen bei params.has(name, value) Name und Wert im selben Paar übereinstimmen, sofern value nicht undefined ist. Wird undefined ausdrücklich als zweites Argument übergeben, ist das gleichbedeutend damit, es wegzulassen: params.has(name, undefined) prüft nur den Namen. Bei wiederholten Namen genügt ein passendes Paar; die Methode verändert die Daten nicht.
Der Vergleich unterscheidet Groß- und Kleinschreibung und erfolgt anhand dekodierter Zeichenfolgen, nicht anhand von Teilen der Abfrage. Beim Parsen wird + als Leerzeichen behandelt. Auch ein leerer Wert bedeutet, dass der Parameter vorhanden ist: Für empty= gibt has("empty") true zurück.
Dies ist eine Web API aus dem WHATWG URL Standard und keine Funktion einer bestimmten ECMAScript-Ausgabe. Die Spezifikation allein belegt nicht, dass die API im Zielbrowser unterstützt wird; auch Node 24 im Repository ist dafür kein Nachweis. Prüfe die Variante mit value gesondert.
Beispiele
const params = new URLSearchParams("tag=js&tag=web&empty=&q=a+b");
console.log(params.has("tag"));
console.log(params.has("tag", "web"));
console.log(params.has("tag", "css"));
console.log(params.has("empty"));
console.log(params.has("missing"));
console.log(params.has("q", "a b"));Ergebnis
true true false true false true
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.