1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
---
title: URLSearchParams
slug: Web/API/URLSearchParams
translation_of: Web/API/URLSearchParams
---
<p>{{ApiRef("URL API")}}</p>
<p><strong><code>URLSearchParams</code></strong> интерфейс определяет служебные методы для работы со строкой запроса URL.</p>
<p>Объект, реализующий <code>URLSearchParams</code>, может непосредственно использоваться в структуре {{jsxref('Statements/for...of', 'for...of')}}, например, следующие две строки идентичны:</p>
<pre><code>for (var p of mySearchParams);
for (var p of mySearchParams.entries());</code>
</pre>
<p>{{availableinworkers}}</p>
<h2 id="Конструктор">Конструктор</h2>
<dl>
<dt>{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}</dt>
<dd>Конструктор возвращает объект <code>URLSearchParams</code>.</dd>
</dl>
<h2 id="Свойства">Свойства</h2>
<p><em>Наследование свойств отсутствует.</em></p>
<h2 id="Методы">Методы</h2>
<p><em>Отсутствует наследование методов</em></p>
<dl>
<dt>{{domxref("URLSearchParams.append()")}}</dt>
<dd>Добавляет указанную пару key/value в качестве нового параметра поиска.</dd>
<dt>{{domxref("URLSearchParams.delete()")}}</dt>
<dd>Удаляет заданный параметр поиска и связанное с ним значение из списка всех параметров поиска.</dd>
<dt>{{domxref("URLSearchParams.entries()")}}</dt>
<dd>Возвращает {{jsxref ("Iteration_protocols", "iterator")}}, позволяющий пройти через все пары key/value, содержащиеся в этом объекте.</dd>
<dt>{{domxref("URLSearchParams.get()")}}</dt>
<dd>Возвращает первое значение, связанное с заданным параметром поиска.</dd>
<dt>{{domxref("URLSearchParams.getAll()")}}</dt>
<dd>Возвращает все значения ассоциации с заданным параметром поиска.</dd>
<dt>{{domxref("URLSearchParams.has()")}}</dt>
<dd>Возвращает {{jsxref ("Boolean")}}, указывающий, существует ли такой параметр поиска.</dd>
<dt>{{domxref("URLSearchParams.keys()")}}</dt>
<dd>Возвращает {{jsxref ("Iteration_protocols", "iterator")}}, позволяющий пройти все ключи пары key/value, содержащиеся в этом объекте.</dd>
<dt>{{domxref("URLSearchParams.set()")}}</dt>
<dd>Устанавливает значение, связанное с заданным параметром поиска, с заданным значением. Если было несколько значений, удалите остальные.</dd>
<dt>{{domxref("URLSearchParams.toString()")}}</dt>
<dd>Возвращает строку, содержащую строку запроса, подходящую для использования в URL-адресе.</dd>
<dt>{{domxref("URLSearchParams.values()")}}</dt>
<dd>Возвращает {{jsxref ("Iteration_protocols", "iterator")}}, позволяющий пройти через все значения пар key/value, содержащихся в этом объекте.</dd>
</dl>
<h2 id="Пример">Пример</h2>
<pre class="brush: js">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"
</pre>
<h2 id="Спецификации">Спецификации</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Спецификации</th>
<th scope="col">Статус</th>
<th scope="col">Комментарий</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}</td>
<td>{{Spec2('URL')}}</td>
<td>Исходное определение</td>
</tr>
</tbody>
</table>
<h2 id="Совместимость_с_браузером">Совместимость с браузером</h2>
<div id="compat-mobile">{{Compat("api.URLSearchParams")}}</div>
<h2 id="Смотрите_также">Смотрите также</h2>
<ul>
<li>Other URL-related interfaces: {{domxref("URL")}}, {{domxref("URLUtils")}}.</li>
<li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: Easy URL manipulation with URLSearchParams</a></li>
</ul>
<dl>
</dl>
|
