XMLHttpRequest.open()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O XMLHttpRequest
método**open()
** inicializa uma nova requisição, ou reinicializa uma requisição já existente.
Nota:
Chamar este método para uma requisição já ativada (uma que open()
já tenha sido chamada) é equivalente a chamar abort()
.
Sintaxe
XMLHttpRequest.open(method, url) XMLHttpRequest.open(method, url, async) XMLHttpRequest.open(method, url, async, user) XMLHttpRequest.open(method, url, async, user, password)
Parâmetros
method
-
O método de requisição HTTP para ser usado, como
"GET"
,"POST"
,"PUT"
,"DELETE"
, etc. Ignorado para URLs não-HTTP(S). url
-
Um
DOMString
representando a URL para enviar a requisição. async
Optional-
Parâmetro booleano opcional, valor padrão
true
, indica quando realizar a operação de forma assíncrona. Se este valor forfalse
, o métodosend()
não retorna nada até que a resposta da requisição seja recebida. Se o valor fortrue
, notificação de uma transação concluída é provida usando event listeners. Isso deve ser verdadeiro se o atributomultipart
étrue
, ou uma exceção será lançada.Nota: 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
Worker
s. user
Optional-
O nome de usuário opcional para ser usado em autenticação; por padrão, isso é o valor
null
. password
Optional-
A senha de usuário opcional para ser usado em autenticação; por padrão, isso é o valor
null
.
Especificações
Specification |
---|
XMLHttpRequest Standard # the-open()-method |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Usando XMLHttpRequest
- Métodos Relacionados ao
XMLHttpRequest
:setRequestHeader()
,send()
, eabort()