From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/xmlhttprequest/send/index.md | 133 ++++++++++---------------- 1 file changed, 52 insertions(+), 81 deletions(-) (limited to 'files/fr/web/api/xmlhttprequest/send') diff --git a/files/fr/web/api/xmlhttprequest/send/index.md b/files/fr/web/api/xmlhttprequest/send/index.md index 26f77bf14a..55257c79e2 100644 --- a/files/fr/web/api/xmlhttprequest/send/index.md +++ b/files/fr/web/api/xmlhttprequest/send/index.md @@ -15,62 +15,47 @@ tags: - send translation_of: Web/API/XMLHttpRequest/send --- -
{{APIRef('XMLHttpRequest')}}
+{{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.

+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.

+`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é.

+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

+## Syntaxe -
XMLHttpRequest.send(body)
-
+ XMLHttpRequest.send(body) -

Paramètres

+### 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.
-
+- `body` {{optional_inline}} -

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().

+ - : Le corps des données à envoyer dans la requête XHR. Cela peut être : -

Valeur de retour

+ - Un {{domxref("Document")}}, dans quel cas il est sérialisé avant d'être envoyé. + - Un `XMLHttpRequestBodyInit` , dont le which [standard ](https://fetch.spec.whatwg.org/#bodyinit)[Fetch](https://fetch.spec.whatwg.org/#bodyinit) peut être un  {{domxref("Blob")}}, {{domxref("BufferSource")}}, {{domxref("FormData")}}, {{domxref("URLSearchParams")}}, ou un objet  {{domxref("USVString")}} . + - `null` -

undefined.

+ Si la valeur du corps n'est pas spécifiée, la valeur par défaut `null` est employée. -

Exceptions

+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()`. - - - - - - - - - - - - - - - - - -
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.
+### Valeur de retour -

Exemple: GET

+`undefined`. -
var xhr = new XMLHttpRequest();
+### Exceptions
+
+| Exception           | Description                                                                                                |
+| ------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `InvalidStateError` | `send()` a déjà été invoquée pour la requête, et/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
+
+```js
+var xhr = new XMLHttpRequest();
 xhr.open('GET', '/server', true);
 
 xhr.onload = function () {
@@ -79,55 +64,41 @@ xhr.onload = function () {
 
 xhr.send(null);
 // xhr.send('string');
-// xhr.send(new Blob());
+// xhr.send(new Blob());
 // xhr.send(new Int8Array());
-// xhr.send(document);
-
+// xhr.send(document); +``` -

Example: POST

+## Example: POST -
var xhr = new XMLHttpRequest();
+```js
+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) {
+    if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
 // Requête finie, traitement ici.
     }
 }
-xhr.send("foo=bar&lorem=ipsum");
+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

- - +// xhr.send(document); +``` + +## Spécificités + +| Specificité | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------------------ | ---------------------- | +| {{SpecName('XMLHttpRequest', '#the-send()-method', 'send()')}} | {{Spec2('XMLHttpRequest')}} | WHATWG living standard | + +## Compatibilité navigateur + +{{Compat("api.XMLHttpRequest.send")}} + +## Voir aussi + +- [L'utilisation de XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [HTML dans XMLHttpRequest](/en-US/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest) -- cgit v1.2.3-54-g00ecf