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/response/index.html | 224 +++++++++++++++++++++++++++++++++++ 1 file changed, 224 insertions(+) create mode 100644 files/fr/web/api/response/index.html (limited to 'files/fr/web/api/response') diff --git a/files/fr/web/api/response/index.html b/files/fr/web/api/response/index.html new file mode 100644 index 0000000000..8721ef0493 --- /dev/null +++ b/files/fr/web/api/response/index.html @@ -0,0 +1,224 @@ +--- +title: Response +slug: Web/API/Response +tags: + - API + - Experimental + - Fetch + - Fetch API + - Interface + - Reference + - 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');
+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:

+ +
var myResponse = new Response();
+ +

Spécifications

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

Compatibilité des navigateurs

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatChrome(42)}}{{CompatVersionUnknown}}{{CompatGeckoDesktop(34)}} [1]
+ {{CompatGeckoDesktop(39)}}		{{CompatNo}}{{CompatOpera(29)}}10.1
Body.formData attribute{{CompatChrome(60)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatNo}}{{CompatOpera(47)}}{{CompatUnknown}}
redirected attribute{{CompatChrome(57)}}{{CompatUnknown}}{{CompatGeckoDesktop(49)}}{{CompatNo}}{{CompatOpera(44)}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroid WebviewChrome pour AndroidEdgeFirefox Mobile (Gecko)Firefox OS (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{CompatChrome(42)}}{{CompatChrome(42)}}{{CompatVersionUnknown}}{{CompatGeckoMobile(34)}} [1]
+ {{CompatGeckoMobile(39)}}		{{CompatUnknown}}{{CompatNo}}{{CompatOperaMobile(29)}}{{CompatNo}}
Body.formData attribute{{CompatChrome(60)}}{{CompatChrome(60)}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatNo}}{{CompatOperaMobile(47)}}{{CompatNo}}
redirected attribute{{CompatChrome(57)}}{{CompatChrome(57)}}{{CompatUnknown}}{{CompatGeckoMobile(49)}}{{CompatUnknown}}{{CompatNo}}{{CompatOperaMobile(44)}}{{CompatNo}}
+
+ +

[1] Disponible comme préférence jusqu'à Firefox 39.

+ +

Voir aussi

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