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 for false, o método send() não retorna nada até que a resposta da requisição seja recebida. Se o valor for true, notificação de uma transação concluída é provida usando event listeners. Isso deve ser verdadeiro se o atributo multipart é 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 Workers.

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
# the-open()-method

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Veja também