From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/xmlhttprequest/send/index.html | 133 ------------------------ files/fr/web/api/xmlhttprequest/send/index.md | 133 ++++++++++++++++++++++++ 2 files changed, 133 insertions(+), 133 deletions(-) delete mode 100644 files/fr/web/api/xmlhttprequest/send/index.html create mode 100644 files/fr/web/api/xmlhttprequest/send/index.md (limited to 'files/fr/web/api/xmlhttprequest/send') diff --git a/files/fr/web/api/xmlhttprequest/send/index.html b/files/fr/web/api/xmlhttprequest/send/index.html deleted file mode 100644 index 26f77bf14a..0000000000 --- a/files/fr/web/api/xmlhttprequest/send/index.html +++ /dev/null @@ -1,133 +0,0 @@ ---- -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

- - diff --git a/files/fr/web/api/xmlhttprequest/send/index.md b/files/fr/web/api/xmlhttprequest/send/index.md new file mode 100644 index 0000000000..26f77bf14a --- /dev/null +++ b/files/fr/web/api/xmlhttprequest/send/index.md @@ -0,0 +1,133 @@ +--- +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