URLSearchParams

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

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

for (var p of mySearchParams);
for (var p of mySearchParams.entries());
Примечание: Эта возможность доступна в Web Workers.

Конструктор

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

Свойства

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

Методы

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

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

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
URLSearchParamsChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29
Замечания
Полная поддержка 29
Замечания
Замечания Prior to version 57 single quotes in URLs were escaped (see bug 1386683).
IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка 10.1WebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29
Замечания
Полная поддержка 29
Замечания
Замечания Prior to version 57 single quotes in URLs were escaped (see bug 1386683).
Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
URLSearchParams() constructorChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
appendChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
deleteChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Частичная поддержка Частичная
Замечания
Частичная поддержка Частичная
Замечания
Замечания Removing a non-existent query parameter doesn't remove ? from the URL. See bug 193022.
WebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Частичная поддержка Частичная
Замечания
Частичная поддержка Частичная
Замечания
Замечания Removing a non-existent query parameter doesn't remove ? from the URL. See bug 193022.
Samsung Internet Android Полная поддержка Да
entriesChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 44IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 44Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
forEachChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 44IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 44Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
getAllChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
hasChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
keysChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 44IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 44Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
setChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
sortChrome Полная поддержка 61Edge Полная поддержка 17Firefox Полная поддержка 54IE Нет поддержки НетOpera Полная поддержка 48Safari Полная поддержка ДаWebView Android Полная поддержка 61Chrome Android Полная поддержка 61Firefox Android Полная поддержка 54Opera Android Полная поддержка 45Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
toStringChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 29Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да
valuesChrome Полная поддержка 49Edge Полная поддержка 17Firefox Полная поддержка 44IE Нет поддержки НетOpera Полная поддержка 36Safari Полная поддержка ДаWebView Android Полная поддержка 49Chrome Android Полная поддержка 49Firefox Android Полная поддержка 44Opera Android Полная поддержка 36Safari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Частичная поддержка  
Частичная поддержка
Нет поддержки  
Нет поддержки
Смотрите замечания реализации.
Смотрите замечания реализации.

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