KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

URLSearchParams.delete(): queryparameters verwijderen

URLSearchParams.delete() verwijdert alle paren met een opgegeven naam, of alleen de paren die overeenkomen met zowel de opgegeven naam als de waarde.

Versie: 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) verwijdert alle paren met de naam name, inclusief duplicaten. params.delete(name, value) verwijdert alle paren die overeenkomen met zowel de naam als de waarde, niet alleen het eerste paar.

De methode wijzigt het object en retourneert undefined, niet het aantal verwijderde paren. Geen overeenkomst veroorzaakt geen fout. Bij een object dat via url.searchParams is verkregen, werkt de methode ook de query van die URL bij.

Deze API hoort bij de WHATWG URL-standaard, niet bij een bepaalde ECMAScript-editie. Controleer in de doelomgeving of de vorm met value wordt ondersteund; alleen Node 24 in een repository is geen bewijs voor browserondersteuning.

Voorbeelden

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());

Resultaat

tag=web&page=2
page=2

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen