XMLHttpRequest.send()

La méthode  XMLHttpRequest send() envoie la requête au serveur.  Si la requête est asynchrone (elle l'est par défaut), la méthode envoie un retour dés que la requête est partie et le résultat est intégré en utilisant les évènements.En cas de requête synchrone, elle ne renvoie rien tant que la réponse n'est pas retournée.

send() accepte un paramètre optionnel qui qui vous permet de spécifier le corps de la requête; c'est principalement utilisé pour les requêtes comme  PUT. Si la méthode est GET ou HEAD, le paramètre body est ignoré et le corps de la requête est fixé à null.

Si aucun "header"Accept n'a été paramétré dans setRequestHeader(), un "header" Accept avec le type "*/*" (tous types) est envoyé.

Syntaxe

XMLHttpRequest.send(body)

Paramètres

body Facultatif
Le corps des données à envoyer dans la requête XHR. Cela peut être : Si la valeur du corps n'est apas spécifiée, la valeur par défaut null est employée.

La meilleure manière d'envoyer du contenu binaire (par exemple dans l'upload de fichiers) est de servir un ArrayBufferView ou  Blob en conjonction avec la méthode send().

Valeur de retour

undefined.

Exceptions

Exception Description
InvalidStateError send() a déjà été invoquée pour la requête ou celle-ci est incomplète.
NetworkError Le type de ressource à récupérer est un BLOB, (binary large object) , et la méthode n'est pas GET.

Exemple: GET

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

xhr.onload = function () {
  // Requête finie, traitement ici.
};

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);

//Envoie les informations du header adaptées avec la requête
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xhr.onreadystatechange = function() { //Appelle une fonction au changement d'état.
    if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
// Requête finie, traitement ici.
    }
}
xhr.send("foo=bar&lorem=ipsum");
// xhr.send(new Int8Array()); 
// xhr.send(document);

Spécificités

Specificité Statut Commentaire
XMLHttpRequest
La définition de 'send()' dans cette spécification.
Standard évolutif WHATWG living standard

Compatibilité navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
sendChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 7
Support complet 7
Support complet 5
Notes
Notes Implemented via ActiveXObject
Opera Support complet OuiSafari Support complet 1.2WebView Android Support complet OuiChrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
ArrayBuffer as parameter to send()Chrome Support complet 9Edge Support complet OuiFirefox Support complet 9IE Support complet 10Opera Support complet 11.6Safari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 9Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet Oui
ArrayBufferView as parameter to send()Chrome Support complet 22Edge ? Firefox Support complet 20IE ? Opera Support complet OuiSafari ? WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 20Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet Oui
Blob as parameter to send()Chrome Support complet 22Edge Support complet OuiFirefox Support complet 2IE Support complet 10Opera Support complet 12Safari ? WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet Oui
FormData as parameter to send()Chrome Support complet 6Edge Support complet OuiFirefox Support complet 2IE Support complet 10Opera Support complet 12Safari ? WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet Oui
URLSearchParams as parameter to send()Chrome Support complet 59Edge ? Firefox Support complet 44IE ? Opera Support complet 12Safari ? WebView Android Support complet OuiChrome Android Support complet 59Firefox Android Support complet 44Opera Android Support complet OuiSafari iOS ? Samsung Internet Android Support complet 7.0

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir aussi