Houve um erro de script nesta página. Enquanto este erro é encaminhado para os editores do site, você pode ver o conteúdo parcial abaixo.

Tradução em progresso.

{{APIRef('XMLHttpRequest')}}

O método send(), do {{domxref("XMLHttpRequest")}}, envia uma requisição para o servidor.Se a solicitação for assíncrona (que é o padrão), esse método retornará assim que a solicitação for enviada e o resultado for entregue usando eventos. Se a solicitação for síncrona, esse método não retornará até que a resposta chegue.

send() aceita um parâmetro opcional que permite especificar o corpo da solicitação; isso é usado principalmente para solicitações como {{HTTPMethod ("PUT")}}. Se o método de solicitação for {{HTTPMethod ("GET")}} ou {{HTTPMethod ("HEAD")}}, o parâmetro body será ignorado e o corpo da solicitação será definido como null .

Se nenhum cabeçalho {{HTTPHeader ("Accept")}} tiver sido definido usando {{domxref ("XMLHttpRequest.setRequestHeader", "setRequestHeader ()")}}, um cabeçalho
Accept com o tipo "*/*" (qualquer tipo) é enviado.

Sintáxe

XMLHttpRequest.send(body)

Parameters

body {{optional_inline}}
Um corpo de dados a ser enviado na solicitação XHR. Isso pode ser:
  • Um {{domxref ("Document")}}, caso em que é serializado antes de ser enviado.
  • Um BodyInit, que conforme a espeficicação Fetch, pode ser um objeto {{domxref ("Blob")}}, {{domxref ("BufferSource")}}, {{domxref ("FormData")}}, {{domxref (" URLSearchParams ")}}, {{domxref (" ReadableStream ")}} ou {{domxref (" USVString ")}}.

Se nenhum valor for  espeficicado para o corpo, o valor padrão de null é usado.

A melhor maneira de enviar conteúdo binário (por exemplo, em uploads de arquivos) é usando um {{domxref ("ArrayBufferView")}} ou {{domxref ("Blob")}} em conjunto com o método send ().

Valor retornado

undefined.

Exemplo: GET

var xhr = new XMLHttpRequest();
xhr.open('GET', '/server', true);

xhr.onload = function () {
  // Requisição finalizada. Faça o processamento aqui.
};

xhr.send(null);
// xhr.send('string');
// xhr.send(new Blob());
// xhr.send(new Int8Array());
// xhr.send(document);

Example: POST

var xhr = new XMLHttpRequest();
xhr.open("POST", '/server', true);

//Envia o cabeçalho informativo adequado junto com a requisição.
xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");

xhr.onreadystatechange = function() {//Call a function when the state changes.
    if(xhr.readyState == XMLHttpRequest.DONE && xhr.status == 200) {
        // Requisição finalizada. Faça o processamento aqui.
    }
}
xhr.send("foo=bar&lorem=ipsum"); 
// xhr.send(new Blob()); 
// xhr.send(new Int8Array()); 
// xhr.send(document);

Especificações

Especificação Estado Comentário
{{SpecName('XMLHttpRequest', '#the-send()-method', 'send()')}} {{Spec2('XMLHttpRequest')}} WHATWG living standard

Browser compatibility

{{Compat("api.XMLHttpRequest.send")}}

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: EduardoFerr
Última atualização por: EduardoFerr,