Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

URLSearchParams.delete(): rimuovere i parametri di query

URLSearchParams.delete() rimuove tutte le coppie con un nome specificato oppure solo quelle che corrispondono sia al nome sia al valore indicati.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

params.delete(name)
params.delete(name, value)

params.delete(name) rimuove tutte le coppie con nome name, inclusi i duplicati. params.delete(name, value) rimuove tutte le coppie che corrispondono sia al nome sia al valore, non soltanto la prima.

Il metodo modifica l’oggetto e restituisce undefined, non il numero di coppie rimosse. Se non ci sono corrispondenze, non si verifica alcun errore. Per un oggetto ottenuto tramite url.searchParams, aggiorna anche la query di quell’URL.

Questa API fa parte dello standard WHATWG URL, non di una specifica edizione di ECMAScript. Verifica il supporto della forma con value nell’ambiente di destinazione; la sola presenza di Node 24 in un repository non dimostra il supporto dei browser.

Esempi

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

Risultato

tag=web&page=2
page=2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti