WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.delete(): Abfrageparameter entfernen

URLSearchParams.delete() entfernt alle Paare mit einem bestimmten Namen oder nur die Paare, die sowohl dem angegebenen Namen als auch dem Wert entsprechen.

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.delete(name)
params.delete(name, value)

params.delete(name) entfernt alle Paare mit dem Namen name, einschließlich Duplikaten. params.delete(name, value) entfernt alle Paare, die sowohl dem Namen als auch dem Wert entsprechen, nicht nur das erste.

Die Methode ändert das Objekt und gibt undefined zurück, keine Anzahl entfernter Paare. Wenn es keine Übereinstimmung gibt, tritt kein Fehler auf. Bei einem Objekt, das über url.searchParams abgerufen wurde, wird auch die Abfrage dieser URL aktualisiert.

Diese API gehört zum WHATWG-URL-Standard und nicht zu einer bestimmten ECMAScript-Ausgabe. Prüfe die Unterstützung der Variante mit value in der Zielumgebung; Node 24 allein in einem Repository belegt keine Browserunterstützung.

Beispiele

const params = new URLSearchParams('tag=js&tag=web&tag=js&page=2');
params.delete('tag', 'js');
console.log(params.toString());
params.delete('tag');
console.log(params.toString());

Ergebnis

tag=web&page=2
page=2

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