diff options
Diffstat (limited to 'files/ru/web/api/urlsearchparams/index.html')
-rw-r--r-- | files/ru/web/api/urlsearchparams/index.html | 109 |
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&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> |