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.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

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

js
delete(name)
delete(name, value)

Parameter

name

Der Name der zu löschenden Parameter.

value Optional

Der Wert, den die Parameter zusammen mit dem angegebenen Namen erfüllen müssen, um gelöscht zu werden.

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.

js
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.

js
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
# dom-urlsearchparams-delete

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
delete
value parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Has more compatibility info.

Siehe auch