Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes