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
|
---
title: XMLHttpRequest.open()
slug: Web/API/XMLHttpRequest/open
tags:
- Referencia
- metodo
translation_of: Web/API/XMLHttpRequest/open
---
<div>{{APIRef('XMLHttpRequest')}}</div>
<p>O {{domxref("XMLHttpRequest")}} método<code><strong>open()</strong></code> inicializa uma nova requisição, ou reinicializa uma requisição já existente.</p>
<div class="note"><strong>Note:</strong> Chamar este método para uma requisição já ativada (uma que <code>open()</code> já tenha sido chamada) é equivalente a chamar {{domxref("XMLHttpRequest.abort", "abort()")}}.</div>
<h2 id="Sintaxe">Sintaxe</h2>
<pre class="syntaxbox"><em>XMLHttpRequest</em>.open(<var>method</var>,<var> url</var>)
<em>XMLHttpRequest</em>.open(<var>method</var>,<var> url</var>,<var> async)</var>
<em>XMLHttpRequest</em>.open(<var>method</var>,<var> url</var>,<var> async</var>,<var> user</var>)
<em>XMLHttpRequest</em>.open(<var>method</var>,<var> url</var>,<var> async</var>,<var> user</var>,<var> password</var>)
</pre>
<h3 id="Parâmetros">Parâmetros</h3>
<dl>
<dt><code>method</code></dt>
<dd>O <a href="/en-US/docs/Web/HTTP/Methods">método de requisição HTTP</a> para ser usado, como <code>"GET"</code>, <code>"POST"</code>, <code>"PUT"</code>, <code>"DELETE"</code>, etc. Ignorado para URLs não-HTTP(S).</dd>
<dt><code>url</code></dt>
<dd>Um {{domxref("DOMString")}} representando a URL para enviar a requisição.</dd>
<dt><code>async</code> {{optional_inline}}</dt>
<dd>Parâmetro booleano opcional, valor padrão <code>true</code>, indica quando realizar a operação de forma assíncrona. Se este valor for <code>false</code>, o método <code>send()</code> não retorna nada até que a resposta da requisição seja recebida. Se o valor for <code>true</code>, notificação de uma transação concluída é provida usando event listeners. Isso <em>deve</em> ser verdadeiro se o atributo <code>multipart</code> é <code>true</code>, ou uma exceção será lançada.
<div class="note"><strong>Nota:</strong> Requisições Síncronas no thread principal podem ser facilmente disruptivas para a experiência de usuário e devem ser evitadas; de fato, muitos navegadores descontinuaram inteiramente o suporte para XHR síncrono no thread principal. Requisições síncronas são permitidas nos {{domxref("Worker")}}s.</div>
</dd>
<dt><code>user</code> {{optional_inline}}</dt>
<dd>O nome de usuário opcional para ser usado em autenticação; por padrão, isso é o valor <code>null</code>.</dd>
<dt><code>password</code> {{optional_inline}}</dt>
<dd>A senha de usuário opcional para ser usado em autenticação; por padrão, isso é o valor <code>null</code>.</dd>
</dl>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Especificação</th>
<th scope="col">Status</th>
<th scope="col">Comentário</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('XMLHttpRequest', '#the-open()-method', 'open()')}}</td>
<td>{{Spec2('XMLHttpRequest')}}</td>
<td>
<p>Padrão WHATWG</p>
</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidade_de_Navegador">Compatibilidade de Navegador</h2>
<p class="hidden">A tabela de compatibilidade nessa página é gerada por dados estruturados. Se voce gostaria de contribuir para os dados, favor verificar <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos envie um <em>pull request</em>.</p>
<p>{{Compat("api.XMLHttpRequest.open")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Usando XMLHttpRequest</a></li>
<li>Métodos Relacionados ao {{domxref("XMLHttpRequest")}}: {{domxref("XMLHttpRequest.setRequestHeader", "setRequestHeader()")}},{{domxref("XMLHttpRequest.send", "send()")}}, e {{domxref("XMLHttpRequest.abort", "abort()")}}</li>
</ul>
|
