База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

URLSearchParams.has() — проверка за наличие на параметър

URLSearchParams.has() проверява дали съществува име на параметър или двойка име-стойност. Връща true или false, без да променя параметрите.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

params.has(name)
params.has(name, value)

params.has(name) връща true, ако съществува параметър с това име. В среда за изпълнение, която поддържа сравняване на стойности, params.has(name, value) изисква името и стойността да съвпадат в една и съща двойка, ако value не е undefined. Изричното подаване на undefined като втори аргумент е равносилно на пропускането му: params.has(name, undefined) проверява само името. При повтарящи се имена е достатъчна една съвпадаща двойка; методът не променя данните.

Сравнението различава главни и малки букви и се извършва върху декодирани низове, а не върху части от заявката. При парсване + се третира като интервал. Празната стойност също означава, че параметърът съществува: за empty= извикването has("empty") връща true.

Това е Web API от стандарта WHATWG URL Standard, а не функция от конкретно издание на ECMAScript. Самата спецификация не доказва поддръжка в целевия браузър; Node 24 в хранилището също не я доказва. Проверете отделно варианта с value.

Примери

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

Резултат

true
true
false
true
false
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници