URLSearchParams: delete() 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: Dieses Feature ist verfügbar in Web Workers.
Die delete()
Methode des URLSearchParams
Interfaces löscht angegebene Parameter und deren zugehörige(r) Wert(e) aus der Liste aller Suchparameter.
Ein Parametername und optional ein Wert werden verwendet, um Parameter abzugleichen. Wenn nur ein Parametername angegeben wird, werden alle Suchparameter, die dem Namen entsprechen, zusammen mit deren zugehörigen Werten gelöscht. Wenn sowohl ein Parametername als auch ein Wert angegeben werden, werden alle Suchparameter gelöscht, die sowohl dem Parameternamen als auch dem Wert entsprechen.
Syntax
delete(name)
delete(name, value)
Parameter
Rückgabewert
Keiner (undefined
).
Beispiele
Löschen aller Parameter mit angegebenem Namen
Dieses Beispiel zeigt, wie alle Abfrageparameter (und Werte) gelöscht werden, die einen bestimmten Namen haben.
const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);
console.log(`Query string (before):\t ${params}`);
params.delete("foo");
console.log(`Query string (after):\t ${params}`);
Das unten stehende Protokoll zeigt, dass alle Parameter mit dem Namen foo
gelöscht werden.
Query string (before): foo=1&bar=2&foo=3 Query string (after): bar=2
Löschen von Parametern mit angegebenem Namen und Wert
Dieses Beispiel zeigt, wie Abfrageparameter gelöscht werden, die einem bestimmten Namen und Wert entsprechen.
const url = new URL("https://example.com?foo=1&bar=2&foo=3&foo=1");
const params = new URLSearchParams(url.search);
console.log(`Query string (before):\t ${params}`);
params.delete("foo", "1");
console.log(`Query string (after):\t ${params}`);
Alle Parameter, die sowohl dem Parameter name
als auch value
entsprechen, sollten gelöscht werden (es gibt keinen Grund, zwei Parameter mit demselben Namen und Wert anzugeben, wie oben gezeigt).
Query string (before): foo=1&bar=2&foo=3&foo=1 Query string (after): bar=2&foo=3
Wenn Ihr Browser die value
-Option unterstützt, sollte die "nachher"-Zeichenfolge bar=2&foo=3
sein. Andernfalls wird das Ergebnis das gleiche sein wie im vorherigen Beispiel (bar=2
).
Spezifikationen
Specification |
---|
URL Standard # dom-urlsearchparams-delete |
Browser-Kompatibilität
BCD tables only load in the browser