CKTIS / JavaScript
URLSearchParams.has() — sprawdzanie obecności parametru
URLSearchParams.has() sprawdza obecność nazwy parametru albo pary nazwa–wartość. Zwraca true lub false bez zmieniania parametrów.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
params.has(name)
params.has(name, value)params.has(name) zwraca true, jeśli istnieje parametr o podanej nazwie. W środowisku obsługującym dopasowanie wartości wywołanie params.has(name, value) wymaga dopasowania nazwy i wartości w tej samej parze, o ile value nie jest undefined. Jawne przekazanie undefined jako drugiego argumentu jest równoważne jego pominięciu: params.has(name, undefined) sprawdza tylko nazwę. Przy powtórzonych nazwach wystarczy jedna pasująca para; metoda nie zmienia danych.
Porównanie rozróżnia wielkość liter i dotyczy odkodowanych ciągów, nie fragmentów zapytania. Podczas parsowania + oznacza spację. Pusta wartość nadal oznacza obecny parametr: dla empty= wywołanie has("empty") zwraca true.
To Web API z WHATWG URL Standard, nie funkcja konkretnej edycji ECMAScript. Sama specyfikacja nie potwierdza obsługi w docelowej przeglądarce; Node 24 w repozytorium również jej nie dowodzi. Sprawdź osobno działanie wariantu z value.
Przykłady
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"));Wynik
true true false true false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.