URLSearchParams

На этой странице возникла скриптовая ошибка. Хотя она адресуется редакторам сайта, вы можете просмотреть частичное содержимое ниже.

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

{{ApiRef("URL API")}}

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

Объект, реализующий URLSearchParams, может непосредственно использоваться в структуре {{jsxref ("Statements / for ... of", "for ... of")}} вместо {{domxref ('URLSearchParams.entries ()', 'Entries ()')}}: for (var p of mySearchParams) эквивалентно для (var p mySearchParams.entries ()).

Конструктор

{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}
Конструктор возвращает объект URLSearchParams.

Свойства

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

Методы

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

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

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

Спецификации Статус Комментраий
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}} {{Spec2('URL')}} Исходное определение

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

{{ CompatibilityTable() }}

Особенность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка {{CompatChrome(49)}} {{CompatGeckoDesktop("29.0")}} {{CompatNo}} 36 10.1
entries(), keys(), values(), and support of for...of {{CompatChrome(49)}} {{CompatGeckoDesktop("44.0")}} {{CompatNo}} 36 {{CompatUnknown}}
USVString for constructor init object {{CompatVersionUnknown}} {{CompatGeckoDesktop("53.0")}} {{CompatNo}} {{CompatVersionUnknown}} {{CompatUnknown}}
Record for constructor init object {{CompatUnknown}} {{CompatGeckoDesktop("54.0")}} {{CompatNo}} {{CompatUnknown}} {{CompatUnknown}}
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support {{CompatNo}} {{CompatChrome(49)}} {{CompatGeckoMobile("29.0")}} {{CompatNo}} {{CompatUnknown}} {{CompatNo}} {{CompatChrome(49)}}
entries(), keys(), values(), and support of for...of {{CompatNo}} {{CompatChrome(49)}} {{CompatGeckoMobile("44.0")}} {{CompatNo}} {{CompatUnknown}} {{CompatNo}} {{CompatChrome(49)}}
USVString for constructor init object {{CompatNo}} {{CompatVersionUnknown}} {{CompatGeckoMobile("53.0")}} {{CompatNo}} {{CompatUnknown}} {{CompatUnknown}} {{CompatVersionUnknown}}
Record for constructor init object {{CompatNo}} {{CompatUnknown}} {{CompatGeckoMobile("54.0")}} {{CompatNo}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}

See also

Метки документа и участники

 Внесли вклад в эту страницу: Daikity
 Обновлялась последний раз: Daikity,