WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen