aboutsummaryrefslogtreecommitdiff
path: root/files/ru/web/api/urlsearchparams/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/ru/web/api/urlsearchparams/index.html')
-rw-r--r--files/ru/web/api/urlsearchparams/index.html109
1 files changed, 109 insertions, 0 deletions
diff --git a/files/ru/web/api/urlsearchparams/index.html b/files/ru/web/api/urlsearchparams/index.html
new file mode 100644
index 0000000000..a72525e018
--- /dev/null
+++ b/files/ru/web/api/urlsearchparams/index.html
@@ -0,0 +1,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&amp;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&amp;topic=api&amp;topic=webdev"
+searchParams.set("topic", "More webdev");
+searchParams.toString(); // "q=URLUtils.searchParams&amp;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>