Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła