CKTIS / JavaScript
URLSearchParams.delete(): remover parâmetros de consulta
URLSearchParams.delete() remove todos os pares com um nome indicado ou apenas os pares que correspondem simultaneamente ao nome e ao valor fornecidos.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
params.delete(name)
params.delete(name, value)params.delete(name) remove todos os pares com o nome name, incluindo duplicados. params.delete(name, value) remove todos os pares que correspondem simultaneamente ao nome e ao valor, e não apenas o primeiro.
O método altera o objeto e devolve undefined, não o número de pares removidos. A ausência de correspondências não provoca um erro. No caso de um objeto obtido através de url.searchParams, também atualiza a consulta desse URL.
Esta API pertence à norma WHATWG URL, não a uma edição específica do ECMAScript. Verifique o suporte da forma com value no ambiente de destino; a presença isolada do Node 24 num repositório não comprova o suporte dos navegadores.
Exemplos
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());Resultado
tag=web&page=2 page=2
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.