URLSearchParams

URLSearchParams интерфейс определяет служебные методы для работы со строкой запроса URL.

Объект, реализующий URLSearchParams, может непосредственно использоваться в структуре for...of, например, следующие две строки идентичны:

for (var p of mySearchParams);
for (var p of mySearchParams.entries());

Примечание: Эта возможность доступна в Web Workers

Конструктор

URLSearchParams() (en-US)
Конструктор возвращает объект URLSearchParams.

Свойства

Наследование свойств отсутствует.

Методы

Отсутствует наследование методов

URLSearchParams.append() (en-US)
Добавляет указанную пару key/value в качестве нового параметра поиска.
URLSearchParams.delete()
Удаляет заданный параметр поиска и связанное с ним значение из списка всех параметров поиска.
URLSearchParams.entries() (en-US)
Возвращает iterator, позволяющий пройти через все пары key/value, содержащиеся в этом объекте.
URLSearchParams.get() (en-US)
Возвращает первое значение, связанное с заданным параметром поиска.
URLSearchParams.getAll() (en-US)
Возвращает все значения ассоциации с заданным параметром поиска.
URLSearchParams.has() (en-US)
Возвращает Boolean, указывающий, существует ли такой параметр поиска.
URLSearchParams.keys() (en-US)
Возвращает iterator, позволяющий пройти все ключи пары key/value, содержащиеся в этом объекте.
URLSearchParams.set() (en-US)
Устанавливает значение, связанное с заданным параметром поиска, с заданным значением. Если было несколько значений, удалите остальные.
URLSearchParams.toString() (en-US)
Возвращает строку, содержащую строку запроса, подходящую для использования в URL-адресе.
URLSearchParams.values() (en-US)
Возвращает iterator, позволяющий пройти через все значения пар key/value, содержащихся в этом объекте.

Пример

var paramsString = "q=URLUtils.searchParams&topic=api"
var searchParams = new URLSearchParams(paramsString);

// Итерируем параметры поиска.
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

Спецификации

Спецификации Статус Комментарий
URL
Определение 'URLSearchParams' в этой спецификации.
Живой стандарт Исходное определение

Совместимость с браузером

BCD tables only load in the browser

Смотрите также