Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

URLSearchParams.delete(): odstranění parametrů dotazu

URLSearchParams.delete() odstraní všechny dvojice s daným názvem, nebo pouze dvojice odpovídající zároveň zadanému názvu i hodnotě.

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

Syntaxe

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

params.delete(name) odstraní všechny dvojice s názvem name, včetně duplicit. params.delete(name, value) odstraní všechny dvojice odpovídající zároveň názvu i hodnotě, nejen první.

Metoda změní objekt a vrátí undefined, nikoli počet odstraněných dvojic. Pokud neexistuje žádná shoda, nedojde k chybě. U objektu získaného přes url.searchParams se aktualizuje také dotaz této URL.

Toto API patří do standardu WHATWG URL, nikoli do konkrétní edice ECMAScriptu. Podporu varianty s value ověřte v cílovém prostředí; samotná přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.

Příklady

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

Výsledek

tag=web&page=2
page=2

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje