URLSearchParams: has() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die has()-Methode des URLSearchParams Interfaces gibt einen booleschen Wert zurück, der anzeigt, ob der angegebene Parameter in den Suchparametern vorhanden ist.
Ein Parametername und ein optionaler Wert werden verwendet, um Parameter abzugleichen.
Wenn nur ein Parametername angegeben ist, gibt die Methode true zurück, wenn irgendwelche Parameter in der Abfragezeichenfolge den Namen entsprechen, und false ansonsten.
Wenn sowohl ein Parametername als auch ein Wert angegeben sind, gibt die Methode true zurück, wenn ein Parameter sowohl den Namen als auch den Wert entspricht.
Syntax
has(name)
has(name, value)
Parameter
Rückgabewert
Ein boolescher Wert.
Beispiele
Überprüfung eines Parameters mit angegebenem Namen
Dieses Beispiel zeigt, wie überprüft wird, ob die Abfragezeichenfolge Parameter mit einem bestimmten Namen hat.
const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
// has() returns true if the parameter is in the query string
console.log(`bar?:\t${params.has("bar")}`);
console.log(`bark?:\t${params.has("bark")}`);
console.log(`foo?:\t${params.has("foo")}`);
Das untenstehende Protokoll zeigt, ob die Parameter bar, bark und foo in der Abfragezeichenfolge vorhanden sind.
bar?: true bark?: false foo?: true
Überprüfung eines Parameters mit angegebenem Namen und Wert
Dieses Beispiel zeigt, wie überprüft wird, ob die Abfragezeichenfolge einen Parameter hat, der sowohl einem bestimmten Namen als auch einem Wert entspricht.
const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
// has() returns true if a parameter with the matching name and value is in the query string
console.log(`bar=1?:\t${params.has("bar", "1")}`);
console.log(`bar=2?:\t${params.has("bar", "2")}`);
console.log(`foo=4?:\t${params.has("foo", "4")}`);
Nur der zweite Wert sollte true sein, da nur der Parametername bar mit dem Wert 2 übereinstimmt.
bar=1?: false bar=2?: true foo=4?: false
Wenn Ihr Browser die value-Option nicht unterstützt, wird die Methode den Namen abgleichen, und alle Ergebnisse sollten true sein.
Spezifikationen
| Specification |
|---|
| URL Standard # dom-urlsearchparams-has |
Browser-Kompatibilität
BCD tables only load in the browser