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

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.

Zdroje