This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The Body
mixin of the Fetch API represents the body of the response/request, allowing you to declare what its content type is and how it should be handled.
Body
is implemented by both Request
and Response
— this provides these objects with an associated body (a byte stream), a used flag (initially unset), and a MIME type (initially the empty byte sequence).
Body.bodyUsed
Read only
Boolean
that indicates whether the body has been read.Body.arrayBuffer()
Response
stream and reads it to completion. It returns a promise that resolves with an ArrayBuffer
.Body.blob()
Response
stream and reads it to completion. It returns a promise that resolves with a Blob
.Body.formData()
Response
stream and reads it to completion. It returns a promise that resolves with a FormData
object.Body.json()
Response
stream and reads it to completion. It returns a promise that resolves with a JSON
object.Body.text()
Response
stream and reads it to completion. It returns a promise that resolves with a USVString
(text).In our basic fetch example we use a simple fetch call to grab an image and display it in an <img>
tag. You'll notice that since we are requesting an image, we need to run Body.blob
(Response
implements body) to give the response its correct MIME type.
<img class="my-image" src="https://wikipedia.org/static/images/project-logos/frwiki-1.5x.png">
var myImage = document.querySelector('.my-image'); fetch('https://upload.wikimedia.org/wikipedia/commons/7/77/Delete_key1.jpg').then(function(response) { return response.blob(); }).then(function(response) { var objectURL = URL.createObjectURL(response); myImage.src = objectURL; });
Specification | Status | Comment |
---|---|---|
Fetch The definition of 'Body' in that specification. | Living Standard |
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 42 [1] | (Yes) | 39 (39) [2] | No support | 29 [3] | No support |
Feature | Android | Edge | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | (Yes) | No support | No support | No support | No support | No support | No support |
[1] Behind a preference in version 41.
[2] Behind a preference starting with version 34.
[3] Behind a preference in version 28.
© 2005–2017 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Body