Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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:

SyntaxError

Der Anforderungskörper kann nicht als JSON geparst werden.

Beispiele

js
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①

Browser-Kompatibilität

Siehe auch