Anforderung: json()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2017 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die json()-Methode der Request-Schnittstelle
liest den Anforderungskörper und gibt ihn als ein Versprechen zurück, das mit dem Ergebnis der Analyse des Körpertextes als JSON aufgelöst wird.
Beachten Sie, dass das Ergebnis, trotz der Bezeichnung der Methode json(), nicht JSON ist, sondern das Ergebnis der Verarbeitung von JSON als Eingabe, um ein JavaScript-Objekt zu erzeugen.
Syntax
json()
Parameter
Keine.
Rückgabewert
Ein Promise, das auf ein JavaScript-Objekt aufgelöst wird. Dieses Objekt kann alles sein, was durch JSON dargestellt werden kann — ein Objekt, ein Array, ein String, eine Zahl…
Ausnahmen
TypeError-
Wird aus einem der folgenden Gründe ausgelöst:
- Der Anforderungskörper ist gestört oder gesperrt.
- Es gab einen Fehler beim Dekodieren des Körperinhalts (zum Beispiel, weil der
Content-Encoding-Header falsch ist).
SyntaxError-
Der Anforderungskörper kann nicht als JSON geparst werden.
Beispiele
const obj = { hello: "world" };
const request = new Request("/myEndpoint", {
method: "POST",
body: JSON.stringify(obj),
});
request.json().then((data) => {
// do something with the data sent in the request
});
Spezifikationen
| Spezifikation |
|---|
| Fetch> # ref-for-dom-body-json①> |