Anforderung: json()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2017.
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
| Specification |
|---|
| Fetch # ref-for-dom-body-json① |