CKTIS / JavaScript
URLSearchParams.has() — ověření přítomnosti parametru
URLSearchParams.has() ověřuje, zda existuje název parametru nebo dvojice název–hodnota. Vrací true nebo false, aniž by parametry měnila.
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.has(name)
params.has(name, value)params.has(name) vrátí true, pokud existuje parametr s daným názvem. V běhovém prostředí, které podporuje porovnávání hodnot, musí při volání params.has(name, value) název i hodnota odpovídat v téže dvojici, pokud value není undefined. Výslovné předání undefined jako druhého argumentu má stejný účinek jako jeho vynechání: params.has(name, undefined) kontroluje pouze název. U opakovaných názvů stačí jedna odpovídající dvojice; metoda data nemění.
Porovnávání rozlišuje velká a malá písmena a pracuje s dekódovanými řetězci, nikoli s částmi dotazu. Při parsování se + považuje za mezeru. I prázdná hodnota znamená, že parametr existuje: pro empty= vrátí has("empty") hodnotu true.
Jde o Web API ze standardu WHATWG URL Standard, nikoli o funkci konkrétní edice ECMAScriptu. Samotná specifikace nepotvrzuje podporu v cílovém prohlížeči; nedokazuje ji ani Node 24 v repozitáři. Variantu s value ověřte samostatně.
Příklady
const params = new URLSearchParams("tag=js&tag=web&empty=&q=a+b");
console.log(params.has("tag"));
console.log(params.has("tag", "web"));
console.log(params.has("tag", "css"));
console.log(params.has("empty"));
console.log(params.has("missing"));
console.log(params.has("q", "a b"));Výsledek
true true false true false true
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.