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/response/index.md | 181 +++++++++++++++++-------------------- 1 file changed, 81 insertions(+), 100 deletions(-) (limited to 'files/fr/web/api/response/index.md') diff --git a/files/fr/web/api/response/index.md b/files/fr/web/api/response/index.md index d1b5aea198..64c7126651 100644 --- a/files/fr/web/api/response/index.md +++ b/files/fr/web/api/response/index.md @@ -11,116 +11,97 @@ tags: - Response translation_of: Web/API/Response --- -
{{APIRef("Fetch API")}}
- -

L'interface Response de l'API de fetch représente la réponse d'une requête initialisée.

- -

Vous pouvez créer un nouvel objet Response en utilisant le constructeur {{domxref("Response.Response()")}}. Cependant, vous rencontrerez plus fréquemment l'objet Response comme étant le résultat d'une opération de l'API, par exemple, un service worker {{domxref("Fetchevent.respondWith")}}, ou un simple {{domxref("GlobalFetch.fetch()")}}.

- -

Constructeur

- -
-
{{domxref("Response.Response","Response()")}}
-
Crée un nouvel objet Response.
-
- -

Propriétés

- -
-
{{domxref("Response.headers")}} {{readonlyinline}}
-
Contient les objets {{domxref("Headers")}} associés à la réponse.
-
{{domxref("Response.ok")}} {{readonlyinline}}
-
Contient un booléen statuant s'il s'agit d'une réponse indiquant un succès (statut HTTP entre 200 et 299) ou non.
-
{{domxref("Response.redirected")}} {{ReadOnlyInline}}
-
Indique si oui ou non la réponse est le résultat d'une (ou plusieurs) redirection(s), c'est-à-dire que sa liste d'URLs a plus d'une entrée.
-
{{domxref("Response.status")}} {{readonlyinline}}
-
Contient le status code de la réponse (par exemple 200 en cas de réussite).
-
{{domxref("Response.statusText")}} {{readonlyinline}}
-
Contient le message du statut correspondant au status code (à savoir : OK pour le code 200 par exemple).
-
{{domxref("Response.type")}} {{readonlyinline}}
-
Contient le type de la réponse (par exemple, basic, cors).
-
{{domxref("Response.url")}} {{readonlyinline}}
-
Contient l'URL de la réponse.
-
{{domxref("Response.useFinalURL")}}
-
Contient un booléen statuant s'il s'agit de l'URL finale de la réponse.
-
- -

Par ailleurs, Response implémente également une propriété {{domxref("Body")}}, voici les propriétés qui lui sont propres :

- -
-
{{domxref("Body.body")}} {{readonlyInline}}
-
Un simple getter utilisé afin d'exposer un {{domxref("ReadableStream")}} permettant de lire le contenu du body.
-
{{domxref("Body.bodyUsed")}} {{readonlyInline}}
-
Stocke un {{domxref("Boolean")}} qui indique si le body a déjà été utilisé dans la réponse ou non.
-
- -

Méthodes

- -
-
{{domxref("Response.clone()")}}
-
Crée un clone de l'objet Response.
-
{{domxref("Response.error()")}}
-
Retourne un nouvel objet Response associé à une erreur réseau.
-
{{domxref("Response.redirect()")}}
-
Crée une nouvelle réponse avec une URL différente permettant de rediriger l'utilisateur.
-
- -

Response implémente {{domxref("Body")}}, voici les différentes méthodes qui sont disponibles:

- -
-
{{domxref("Body.arrayBuffer()")}}
-
Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("ArrayBuffer")}} lorsqu'elle est résolue.
-
{{domxref("Body.blob()")}}
-
Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("Blob")}} lorsqu'elle est résolue.
-
{{domxref("Body.formData()")}}
-
Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("FormData")}} lorsqu'elle est résolue.
-
{{domxref("Body.json()")}}
-
Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne le résultat du parsing du body text, comme {{jsxref("JSON")}} ,lorsqu'elle est résolue.
-
{{domxref("Body.text()")}}
-
Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui est résolue avec un {{domxref("USVString")}} (text).
-
- -

Exemples

- -

Dans notre exemple basique d'utilisation de fetch (exemple), nous utilisons un simple appel fetch() pour récupérer une image et l'afficher dans un tag {{htmlelement("img")}}. L'appel fetch() retourne une promise qui est résolue avec un objet Response associé à l'opération de récupération de la ressource. Vous remarquerez que puisque nous récupérons une image, nous avons besoin d'utiliser {{domxref("Body.blob")}} (disponible dans le body de la {{domxref("Response")}}) pour attribuer le bon MIME type à la réponse.

- -
var myImage = document.querySelector('.my-image');
+{{APIRef("Fetch API")}}
+
+L'interface **`Response`** de l'API de [fetch](/en-US/docs/Web/API/Fetch_API) représente la réponse d'une requête initialisée.
+
+Vous pouvez créer un nouvel objet `Response` en utilisant le constructeur {{domxref("Response.Response()")}}. Cependant, vous rencontrerez plus fréquemment l'objet Response comme étant le résultat d'une opération de l'API, par exemple, un service worker {{domxref("Fetchevent.respondWith")}}, ou un simple {{domxref("GlobalFetch.fetch()")}}.
+
+## Constructeur
+
+- {{domxref("Response.Response","Response()")}}
+  - : Crée un nouvel objet `Response`.
+
+## Propriétés
+
+- {{domxref("Response.headers")}} {{readonlyinline}}
+  - : Contient les objets {{domxref("Headers")}} associés à la réponse.
+- {{domxref("Response.ok")}} {{readonlyinline}}
+  - : Contient un booléen statuant s'il s'agit d'une réponse indiquant un succès (statut HTTP entre 200 et 299) ou non.
+- {{domxref("Response.redirected")}} {{ReadOnlyInline}}
+  - : Indique si oui ou non la réponse est le résultat d'une (ou plusieurs) redirection(s), c'est-à-dire que sa liste d'URLs a plus d'une entrée.
+- {{domxref("Response.status")}} {{readonlyinline}}
+  - : Contient le status code de la réponse (par exemple `200` en cas de réussite).
+- {{domxref("Response.statusText")}} {{readonlyinline}}
+  - : Contient le message du statut correspondant au status code (à savoir : `OK` pour le code `200` par exemple).
+- {{domxref("Response.type")}} {{readonlyinline}}
+  - : Contient le type de la réponse (par exemple, `basic`, `cors`).
+- {{domxref("Response.url")}} {{readonlyinline}}
+  - : Contient l'URL de la réponse.
+- {{domxref("Response.useFinalURL")}}
+  - : Contient un booléen statuant s'il s'agit de l'URL finale de la réponse.
+
+Par ailleurs, `Response` implémente également une propriété {{domxref("Body")}}, voici les propriétés qui lui sont propres :
+
+- {{domxref("Body.body")}} {{readonlyInline}}
+  - : Un simple getter utilisé afin d'exposer un {{domxref("ReadableStream")}} permettant de lire le contenu du body.
+- {{domxref("Body.bodyUsed")}} {{readonlyInline}}
+  - : Stocke un {{domxref("Boolean")}} qui indique si le body a déjà été utilisé dans la réponse ou non.
+
+## Méthodes
+
+- {{domxref("Response.clone()")}}
+  - : Crée un clone de l'objet `Response`.
+- {{domxref("Response.error()")}}
+  - : Retourne un nouvel objet `Response` associé à une erreur réseau.
+- {{domxref("Response.redirect()")}}
+  - : Crée une nouvelle réponse avec une URL différente permettant de rediriger l'utilisateur.
+
+`Response` implémente {{domxref("Body")}}, voici les différentes méthodes qui sont disponibles:
+
+- {{domxref("Body.arrayBuffer()")}}
+  - : Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("ArrayBuffer")}} lorsqu'elle est résolue.
+- {{domxref("Body.blob()")}}
+  - : Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("Blob")}} lorsqu'elle est résolue.
+- {{domxref("Body.formData()")}}
+  - : Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne un {{domxref("FormData")}} lorsqu'elle est résolue.
+- {{domxref("Body.json()")}}
+  - : Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui retourne le résultat du parsing du body text, comme {{jsxref("JSON")}} ,lorsqu'elle est résolue.
+- {{domxref("Body.text()")}}
+  - : Prend le stream de la {{domxref("Response")}} et le lit jusqu'à la fin. Renvoie une promise qui est résolue avec un {{domxref("USVString")}} (text).
+
+## Exemples
+
+Dans notre [exemple basique d'utilisation de fetch ](https://github.com/mdn/fetch-examples/tree/gh-pages/basic-fetch)([exemple](http://mdn.github.io/fetch-examples/basic-fetch/)), nous utilisons un simple appel `fetch()` pour récupérer une image et l'afficher dans un tag {{htmlelement("img")}}. L'appel `fetch()` retourne une promise qui est résolue avec un objet `Response` associé à l'opération de récupération de la ressource. Vous remarquerez que puisque nous récupérons une image, nous avons besoin d'utiliser {{domxref("Body.blob")}} (disponible dans le body de la {{domxref("Response")}}) pour attribuer le bon MIME type à la réponse.
+
+```js
+var myImage = document.querySelector('.my-image');
 fetch('flowers.jpg').then(function(response) {
   return response.blob();
 }).then(function(blob) {
   var objectURL = URL.createObjectURL(blob);
   myImage.src = objectURL;
-});
+}); +``` -

Vous pouvez également utiliser le constructeur {{domxref("Response.Response()")}} pour créer votre propre objet Response:

+Vous pouvez également utiliser le constructeur {{domxref("Response.Response()")}} pour créer votre propre objet `Response`: -
var myResponse = new Response();
+```js +var myResponse = new Response(); +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('Fetch','#response-class','Response')}}{{Spec2('Fetch')}}Définition initiale
+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | ------------------------ | ------------------- | +| {{SpecName('Fetch','#response-class','Response')}} | {{Spec2('Fetch')}} | Définition initiale | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Response")}}

+{{Compat("api.Response")}} -

Voir aussi

+## Voir aussi - +- [ServiceWorker API](/en-US/docs/Web/API/ServiceWorker_API) +- [HTTP access control (CORS)](/en-US/docs/Web/HTTP/Access_control_CORS) +- [HTTP](/en-US/docs/Web/HTTP) -- cgit v1.2.3-54-g00ecf