From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/xmlhttprequest/send/index.html | 135 ++++++++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 files/fr/web/api/xmlhttprequest/send/index.html (limited to 'files/fr/web/api/xmlhttprequest/send/index.html') diff --git a/files/fr/web/api/xmlhttprequest/send/index.html b/files/fr/web/api/xmlhttprequest/send/index.html new file mode 100644 index 0000000000..507b4b7731 --- /dev/null +++ b/files/fr/web/api/xmlhttprequest/send/index.html @@ -0,0 +1,135 @@ +--- +title: XMLHttpRequest.send() +slug: Web/API/XMLHttpRequest/send +tags: + - AJAX + - API + - Besoin d'exemples + - Besoin de Contenu + - Method + - References + - Requête XMLHttp + - XHR + - requête HTTP + - requête XHR + - send +translation_of: Web/API/XMLHttpRequest/send +--- +
{{APIRef('XMLHttpRequest')}}
+ +

La méthode  {{domxref("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  {{HTTPMethod("PUT")}}. Si la méthode est {{HTTPMethod("GET")}} ou {{HTTPMethod("HEAD")}}, le paramètre body est ignoré et le corps de la requête est fixé à null.

+ +

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

+ +

Syntaxe

+ +
XMLHttpRequest.send(body)
+
+ +

Paramètres

+ +
+
body {{optional_inline}}
+
Le corps des données à envoyer dans la requête XHR. Cela peut être : +
    +
  • Un {{domxref("Document")}}, dans quel cas il est sérialisé avant d'être envoyé.
    • +
  • Un XMLHttpRequestBodyInit , dont le which standard Fetch peut être un  {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, ou un objet  {{domxref("USVString")}} .
    • +
  • null
    • +
+ Si la valeur du corps n'est pas 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 d'utiliser un {{domxref("ArrayBufferView")}} ou  {{domxref("Blob")}} en conjonction avec la méthode send().

+ +

Valeur de retour

+ +

undefined.

+ +

Exceptions

+ + + + + + + + + + + + + + + + + + +
ExceptionDescription
InvalidStateErrorsend() a déjà été invoquée pour la requête, et/ou celle-ci est incomplète.
NetworkErrorLe 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éStatutCommentaire
{{SpecName('XMLHttpRequest', '#the-send()-method', 'send()')}}{{Spec2('XMLHttpRequest')}}WHATWG living standard
+ +

Compatibilité navigateur

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

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf