diff options
Diffstat (limited to 'files/fr/web/api/xmlhttprequest/response/index.md')
| -rw-r--r-- | files/fr/web/api/xmlhttprequest/response/index.md | 225 |
1 files changed, 117 insertions, 108 deletions
diff --git a/files/fr/web/api/xmlhttprequest/response/index.md b/files/fr/web/api/xmlhttprequest/response/index.md index afbad2c4f1..d07b064c06 100644 --- a/files/fr/web/api/xmlhttprequest/response/index.md +++ b/files/fr/web/api/xmlhttprequest/response/index.md @@ -7,88 +7,112 @@ tags: - XMLHttpRequest translation_of: Web/API/XMLHttpRequest/response --- -<div>{{draft}}</div> - -<div>{{APIRef('XMLHttpRequest')}}</div> - -<div>La propriété <code>XMLHttpRequest.response</code> contient le corps de la réponse. Elle peut être de type ArrayBuffer, Blob, Document, un objet JavaScript ou une DOMString en fonction de la valeur de la propriété <code>XMLHttpRequest.responseType</code>. La réponse ( <code>Value of response</code> ) est nulle si la requête est incomplète ou n'as pas été effectué avec succès. Cependant, si <code>responseType</code> est "text" ou une chaine vide et tant que la requête est en cours ( dans l'état <em>loading</em> ), <code>response</code> peut contenir la réponse partielle.</div> - -<div> </div> +{{draft}}{{APIRef('XMLHttpRequest')}}La propriété `XMLHttpRequest.response` contient le corps de la réponse. Elle peut être de type ArrayBuffer, Blob, Document, un objet JavaScript ou une DOMString en fonction de la valeur de la propriété `XMLHttpRequest.responseType`. La réponse ( `Value of response` ) est nulle si la requête est incomplète ou n'as pas été effectué avec succès. Cependant, si `responseType` est "text" ou une chaine vide et tant que la requête est en cours ( dans l'état _loading_ ), `response` peut contenir la réponse partielle. <table class="standard-table"> - <tbody> - <tr> - <td class="header">Valeur de <code>responseType</code></td> - <td class="header">Type de donnée de la propriété <code>response</code></td> - </tr> - <tr> - <td><code>""</code></td> - <td>{{domxref("DOMString")}} (valeur par défaut)</td> - </tr> - <tr> - <td><code>"arraybuffer"</code></td> - <td>{{domxref("ArrayBuffer")}}</td> - </tr> - <tr> - <td><code>"blob"</code></td> - <td>{{domxref("Blob")}}</td> - </tr> - <tr> - <td><code>"document"</code></td> - <td>{{domxref("Document")}}</td> - </tr> - <tr> - <td><code>"json"</code></td> - <td> - <p>Objet JavaScript depuis une réponse JSON.</p> - </td> - </tr> - <tr> - <td><code>"text"</code></td> - <td>{{domxref("DOMString")}}</td> - </tr> - <tr> - <td><code>"moz-blob"</code> {{non-standard_inline}}</td> - <td> - <p>Used by Firefox to allow retrieving partial {{domxref("Blob")}} data from progress events. This lets your progress event handler start processing data while it's still being received. {{gecko_minversion_inline("12.0")}}</p> - </td> - </tr> - <tr> - <td><code>"moz-chunked-text"</code>{{non-standard_inline}}</td> - <td> - <p>Similar to <code>"text"</code>, but is streaming. This means that the value in <code>response</code> is only available during dispatch of the <code>"progress"</code> event and only contains the data received since the last <code>"progress"</code> event.</p> - - <p>When <code>response</code> is accessed during a <code>"progress"</code> event it contains a string with the data. Otherwise it returns <code>null</code>.</p> - - <p>This mode currently only works in Firefox. {{gecko_minversion_inline("9.0")}}</p> - </td> - </tr> - <tr> - <td><code>"moz-chunked-arraybuffer"</code>{{non-standard_inline}}</td> - <td> - <p>Similar to <code>"arraybuffer"</code>, but is streaming. This means that the value in <code>response</code> is only available during dispatch of the <code>"progress"</code> event and only contains the data received since the last <code>"progress"</code> event.</p> - - <p>When <code>response</code> is accessed during a <code>"progress"</code> event it contains a string with the data. Otherwise it returns <code>null</code>.</p> - - <p>This mode currently only works in Firefox. {{gecko_minversion_inline("9.0")}}</p> - </td> - </tr> - <tr> - <td>"ms-stream"{{non-standard_inline}}</td> - <td> - <p>Indique que la réponse est une partie d'un téléchargement d'un flux (?). Supporté uniquement pour les requêtes des téléchargements et disponible uniquement dans Internet Explorer.</p> - </td> - </tr> - </tbody> + <tbody> + <tr> + <td class="header">Valeur de <code>responseType</code></td> + <td class="header"> + Type de donnée de la propriété <code>response</code> + </td> + </tr> + <tr> + <td><code>""</code></td> + <td>{{domxref("DOMString")}} (valeur par défaut)</td> + </tr> + <tr> + <td><code>"arraybuffer"</code></td> + <td>{{domxref("ArrayBuffer")}}</td> + </tr> + <tr> + <td><code>"blob"</code></td> + <td>{{domxref("Blob")}}</td> + </tr> + <tr> + <td><code>"document"</code></td> + <td>{{domxref("Document")}}</td> + </tr> + <tr> + <td><code>"json"</code></td> + <td><p>Objet JavaScript depuis une réponse JSON.</p></td> + </tr> + <tr> + <td><code>"text"</code></td> + <td>{{domxref("DOMString")}}</td> + </tr> + <tr> + <td><code>"moz-blob"</code> {{non-standard_inline}}</td> + <td> + <p> + Used by Firefox to allow retrieving partial {{domxref("Blob")}} + data from progress events. This lets your progress event handler start + processing data while it's still being received. + {{gecko_minversion_inline("12.0")}} + </p> + </td> + </tr> + <tr> + <td><code>"moz-chunked-text"</code>{{non-standard_inline}}</td> + <td> + <p> + Similar to <code>"text"</code>, but is streaming. This means that the + value in <code>response</code> is only available during dispatch of + the <code>"progress"</code> event and only contains the data received + since the last <code>"progress"</code> event. + </p> + <p> + When <code>response</code> is accessed during a + <code>"progress"</code> event it contains a string with the data. + Otherwise it returns <code>null</code>. + </p> + <p> + This mode currently only works in Firefox. + {{gecko_minversion_inline("9.0")}} + </p> + </td> + </tr> + <tr> + <td> + <code>"moz-chunked-arraybuffer"</code>{{non-standard_inline}} + </td> + <td> + <p> + Similar to <code>"arraybuffer"</code>, but is streaming. This means + that the value in <code>response</code> is only available during + dispatch of the <code>"progress"</code> event and only contains the + data received since the last <code>"progress"</code> event. + </p> + <p> + When <code>response</code> is accessed during a + <code>"progress"</code> event it contains a string with the data. + Otherwise it returns <code>null</code>. + </p> + <p> + This mode currently only works in Firefox. + {{gecko_minversion_inline("9.0")}} + </p> + </td> + </tr> + <tr> + <td>"ms-stream"{{non-standard_inline}}</td> + <td> + <p> + Indique que la réponse est une partie d'un téléchargement d'un flux + (?). Supporté uniquement pour les requêtes des téléchargements et + disponible uniquement dans Internet Explorer. + </p> + </td> + </tr> + </tbody> </table> -<div class="note"> -<p><strong>Note:</strong> À partir de Gecko 11.0 {{geckoRelease("11.0")}} et de WebKit build 528, ces navigateurs ne permettent plus l'utilisation de l'attribut <code>responseType</code> lors des requêtes synchrones. Cela renvoi l'erreur <code>NS_ERROR_DOM_INVALID_ACCESS_ERR</code>. Ce changement a été proposé au W3C afin d'être standardisé. </p> -</div> +> **Note :** À partir de Gecko 11.0 {{geckoRelease("11.0")}} et de WebKit build 528, ces navigateurs ne permettent plus l'utilisation de l'attribut `responseType` lors des requêtes synchrones. Cela renvoi l'erreur `NS_ERROR_DOM_INVALID_ACCESS_ERR`. Ce changement a été proposé au W3C afin d'être standardisé. -<h2 id="Example">Example</h2> +## Example -<pre class="brush: js">var url = 'somePage.html'; // une page locale +```js +var url = 'somePage.html'; // une page locale function load(url, callback) { var xhr = new XMLHttpRequest(); @@ -102,42 +126,27 @@ function load(url, callback) { xhr.open('GET', url, true); xhr.send(''); } +``` -</pre> +## Specifications -<h2 id="Specifications">Specifications</h2> +| Specification | Status | Comment | +| ---------------------------------------------------------------------------- | ------------------------------------ | ---------------------- | +| {{SpecName('XMLHttpRequest', '#the-response-attribute')}} | {{Spec2('XMLHttpRequest')}} | WHATWG living standard | -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('XMLHttpRequest', '#the-response-attribute')}}</td> - <td>{{Spec2('XMLHttpRequest')}}</td> - <td>WHATWG living standard</td> - </tr> - </tbody> -</table> +## Compatibilité des navigateurs + +{{Compat("api.XMLHttpRequest")}} -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Voir aussi -<div>{{Compat("api.XMLHttpRequest")}}</div> +- {{domxref("XMLSerializer")}} : Sérialisation d'un arbre DOM en XML +- Tutoriels MDN couvrant le `XMLHttpRequest` : -<h2 id="See_also">Voir aussi</h2> + - [Ajax — Pour commencer](/fr/docs/Web/Guide/AJAX/Getting_Started) + - [Utilisation de XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest) + - [HTML dans XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest) + - [Fetch API](/fr/docs/Web/API/Fetch_API) -<ul> - <li>{{domxref("XMLSerializer")}} : Sérialisation d'un arbre DOM en XML</li> - <li>Tutoriels MDN couvrant le <code>XMLHttpRequest</code> : - <ul> - <li><a href="/fr/docs/Web/Guide/AJAX/Getting_Started">Ajax — Pour commencer</a></li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Utilisation de XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/XMLHttpRequest/HTML_in_XMLHttpRequest">HTML dans XMLHttpRequest</a></li> - <li><a href="/fr/docs/Web/API/Fetch_API">Fetch API</a></li> - </ul> - </li> - <li><a href="http://www.html5rocks.com/en/tutorials/file/xhr2/">HTML5 Rocks — New Tricks in XMLHttpRequest2</a></li> - <li>Directive Feature-Policy {{httpheader("Feature-Policy/sync-xhr", "sync-xhr")}}</li> -</ul> +- [HTML5 Rocks — New Tricks in XMLHttpRequest2](http://www.html5rocks.com/en/tutorials/file/xhr2/) +- Directive Feature-Policy {{httpheader("Feature-Policy/sync-xhr", "sync-xhr")}} |