aboutsummaryrefslogtreecommitdiff
path: root/files/ru/web/api/xmlhttprequest/open/index.html
blob: 935dcb6442b3f5020b9f4a7cc4d88ef36da020f2 (plain)
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
---
title: XMLHttpRequest.open()
slug: Web/API/XMLHttpRequest/open
translation_of: Web/API/XMLHttpRequest/open
---
<p>{{APIRef('XMLHttpRequest')}}</p>

<p>Метод <strong>XMLHttpRequest.open()</strong> инициализирует новый запрос или повторно инициализирует уже созданный.</p>

<div class="note"><strong>Примечание:</strong> Вызов этого метода для уже активного запроса (для которого уже был вызван  <code>open()</code>) эквивалентно вызову <code>abort()</code>.</div>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox"><var>XMLHttpRequest</var>.open(<var>method</var>, <var>url</var>[, <var>async</var>[, <var>user</var>[, <var>password</var>]]])
</pre>

<h3 id="Параметры">Параметры</h3>

<dl>
 <dt><code>method</code></dt>
 <dd>Для HTTP-запроса используются такие методы как "GET", "POST", "PUT", "DELETE", и т. д. Игнорируется для URL, отличных от HTTP(S)-запросов.</dd>
 <dt><code>url</code></dt>
 <dd>{{domxref("DOMString")}} представляет URL для отправки запроса.</dd>
 <dt><code>async</code> {{optional_inline}}</dt>
 <dd>
 <p>Необязательный логический параметр со значением по умолчанию <code>true</code>, указывающим, выполнять ли операцию асинхронно или нет. Если это значение равно <code>false</code>, метод <code>send()</code> не возвращается, пока не будет получен ответ. Если <code>true</code>, уведомление о получении ответа осуществляется с помощью обработчика события. Должен быть <code>true</code>, если атрибут <code>multipart</code> равен <code>true</code>, иначе будет выброшено исключение.</p>

 <div class="note"><strong>Примечание:</strong> Синхронные запросы в основном потоке могут нарушить работу пользователя, их следует избегать. Фактически большинство браузеров полностью отказались от поддержки синхронных XHR в основном потоке. Синхронные запросы можно использовать в {{domxref("Worker")}}.</div>
 </dd>
 <dt><code>user</code> {{optional_inline}}</dt>
 <dd>Опционально: имя пользователя, использующееся для аутентификации; по умолчанию имеет значение <code>null</code>.</dd>
 <dt><code>password</code> {{optional_inline}}</dt>
 <dd>Опционально: пароль, использующийся для аутентификации; по умолчанию имеет значение <code>null</code>.</dd>
</dl>

<h2 id="Спецификации">Спецификации</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Спецификация</th>
   <th scope="col">Статус</th>
   <th scope="col">Комментарии</th>
  </tr>
  <tr>
   <td>{{SpecName('XMLHttpRequest', '#the-open()-method', 'open()')}}</td>
   <td>{{Spec2('XMLHttpRequest')}}</td>
   <td>WHATWG живой стандарт</td>
  </tr>
 </tbody>
</table>

<h2 id="Браузерная_совместимость">Браузерная совместимость</h2>
<p>{{Compat("api.XMLHttpRequest.open")}}</p>

<h2 id="Смотрите_также">Смотрите также</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Использование XMLHttpRequest</a></li>
 <li>{{domxref("XMLHttpRequest.setRequestHeader", "setRequestHeader()")}}</li>
 <li>{{domxref("XMLHttpRequest.send", "send()")}}</li>
 <li>{{domxref("XMLHttpRequest.abort", "abort()")}}</li>
</ul>