Body

Diese Übersetzung ist unvollständig. Bitte helfen Sie uns, diesen Artikel aus dem Englischen zu übersetzen

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 stream), a used flag (initially unset), and a MIME type (initially the empty byte sequence).

Properties

Body.body Schreibgeschützt
A simple getter used to expose a ReadableStream of the body contents.
Body.bodyUsed Schreibgeschützt
A Boolean that indicates whether the body has been read.

Methods

Body.arrayBuffer()
Takes a Response stream and reads it to completion. It returns a promise that resolves with an ArrayBuffer.
Body.blob()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a Blob.
Body.formData()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a FormData object.
Body.json()
Takes a Response stream and reads it to completion. It returns a promise that resolves with the result of parsing the body text as JSON.
Body.text()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a USVString (text). The response is always decoded using UTF-8.

Examples

The example below uses 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.

HTML Content

<img class="my-image" src="https://wikipedia.org/static/images/project-logos/frwiki-1.5x.png">

JS Content

const myImage = document.querySelector('.my-image');
fetch('https://upload.wikimedia.org/wikipedia/commons/7/77/Delete_key1.jpg')
	.then(res => res.blob())
	.then(res => {
		const objectURL = URL.createObjectURL(res);
		myImage.src = objectURL;
});

Specifications

Specification Status Comment
Fetch
Die Definition von 'Body' in dieser Spezifikation.
Lebender Standard  

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
BodyChrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Vollständige Unterstützung 42Chrome Android Vollständige Unterstützung 42Firefox Android ? Opera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Vollständige Unterstützung 4.0
arrayBuffer
Experimentell
Chrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Keine Unterstützung NeinChrome Android Vollständige Unterstützung 42Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Vollständige Unterstützung 4.0
blob
Experimentell
Chrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Keine Unterstützung NeinChrome Android Vollständige Unterstützung 42Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Vollständige Unterstützung 4.0
body
Experimentell
Chrome Vollständige Unterstützung 52Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 65
Vollständige Unterstützung 65
Vollständige Unterstützung 57
Deaktiviert
Deaktiviert From version 57: this feature is behind the dom.streams.enabled preference (needs to be set to true) and the javascript.options.streams preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 39Safari Vollständige Unterstützung 11.1WebView Android Vollständige Unterstützung 52Chrome Android Vollständige Unterstützung 52Firefox Android Vollständige Unterstützung 65
Vollständige Unterstützung 65
Vollständige Unterstützung 57
Deaktiviert
Deaktiviert From version 57: this feature is behind the dom.streams.enabled preference (needs to be set to true) and the javascript.options.streams preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Vollständige Unterstützung 41Safari iOS Vollständige Unterstützung 11.3Samsung Internet Android Vollständige Unterstützung 6.0
bodyUsed
Experimentell
Chrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Keine Unterstützung NeinChrome Android Keine Unterstützung NeinFirefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Keine Unterstützung Nein
formData
Experimentell
Chrome Vollständige Unterstützung 60Edge Vollständige Unterstützung ≤79Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 47Safari Teilweise Unterstützung 10.1
Hinweise
Teilweise Unterstützung 10.1
Hinweise
Hinweise From Safari 10.1, the method exists but always rejects with NotSupportedError. See bug 215671.
WebView Android Vollständige Unterstützung 60Chrome Android Vollständige Unterstützung 60Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 44Safari iOS Teilweise Unterstützung 10.3
Hinweise
Teilweise Unterstützung 10.3
Hinweise
Hinweise From Safari for iOS 10.3, the method exists but always rejects with NotSupportedError. See bug 215671.
Samsung Internet Android Vollständige Unterstützung 8.0
json
Experimentell
Chrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Keine Unterstützung NeinChrome Android Vollständige Unterstützung 42Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Vollständige Unterstützung 4.0
text
Experimentell
Chrome Vollständige Unterstützung 42
Vollständige Unterstützung 42
Vollständige Unterstützung 41
Deaktiviert
Deaktiviert From version 41: this feature is behind the Experimental Web Platform Features preference. To change preferences in Chrome, visit chrome://flags.
Edge Vollständige Unterstützung ≤18Firefox Vollständige Unterstützung 39
Vollständige Unterstützung 39
Vollständige Unterstützung 34
Deaktiviert
Deaktiviert From version 34: this feature is behind the dom.fetch.enabled preference. To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari Vollständige Unterstützung 10.1WebView Android Keine Unterstützung NeinChrome Android Vollständige Unterstützung 42Firefox Android Keine Unterstützung NeinOpera Android Vollständige Unterstützung 29
Vollständige Unterstützung 29
Vollständige Unterstützung 28
Deaktiviert
Deaktiviert From version 28: this feature is behind the Experimental Web Platform Features preference.
Safari iOS Vollständige Unterstützung 10.3Samsung Internet Android Vollständige Unterstützung 4.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Teilweise Unterstützung  
Teilweise Unterstützung
Keine Unterstützung  
Keine Unterstützung
Kompatibilität unbekannt  
Kompatibilität unbekannt
Experimentell. Das Verhalten kann sich zukünftig ändern.
Experimentell. Das Verhalten kann sich zukünftig ändern.
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.
Benutzer muss dieses Feature explizit aktivieren.
Benutzer muss dieses Feature explizit aktivieren.

See also