URLSearchParams: метод has()

Метод has() интерфейса URLSearchParams возвращает логическое значение, указывающее, присутствует ли указанный параметр в параметрах поиска.

Для сопоставления параметров используется имя параметра и необязательное значение. Если указано только имя параметра, метод вернёт true , если в строке запроса есть параметры, соответствующие имени, и false в противном случае. Если указаны имя параметра и значение, метод вернёт true , если параметр соответствует и имени, и значению.

name

Имя параметра для сопоставления.

value

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

Логическое значение.

В этом примере показано, как проверить, содержит ли строка запроса параметры с определенным именем.

const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);

// has() returns true if the parameter is in the query string
console.log(`bar?:\t${params.has("bar")}`);
console.log(`bark?:\t${params.has("bark")}`);
console.log(`foo?:\t${params.has("foo")}`);

В выводе ниже показано, присутствуют ли параметры bar, bark, и foo в строке запроса.

bar?:  true
bark?: false
foo?:  true

В этом примере показано, как проверить, содержит ли строка запроса параметр, соответствующий как определенному имени, так и значению.

const url = new URL("https://example.com?foo=1&bar=2&foo=3");
const params = new URLSearchParams(url.search);

// has() returns true if a parameter with the matching name and value is in the query string
console.log(`bar=1?:\t${params.has("bar", "1")}`);
console.log(`bar=2?:\t${params.has("bar", "2")}`);
console.log(`foo=4?:\t${params.has("foo", "4")}`);

Только второе значение выше должно быть true, так как соответствует только параметру с именем bar и значением 2.

bar=1?: false
bar=2?: true
foo=4?: false

Если ваш браузер не поддерживает опцию value, метод будет осуществлять соответствие по имени, и все результаты должны быть true.

• Полифил для URLSearchParams в core-js