Response: formData() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die formData()-Methode der Response-Schnittstelle nimmt einen Response-Stream und liest ihn bis zum Ende. Sie gibt ein Promise zurück, das mit einem FormData-Objekt aufgelöst wird.

Hinweis: Dies ist hauptsächlich für Service Worker relevant. Wenn ein Benutzer ein Formular absendet und ein Service Worker die Anforderung abfängt, könnten Sie z.B. formData() darauf aufrufen, um eine Schlüssel-Wert-Zuordnung zu erhalten, einige Felder zu ändern und dann das Formular an den Server weiterzuleiten (oder es lokal zu verwenden).

Syntax

js
formData()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem FormData-Objekt aufgelöst wird.

Ausnahmen

DOMException AbortError

Die Anforderung wurde abgebrochen.

TypeError

Wird aus einem der folgenden Gründe ausgelöst:

  • Der Antwortkörper ist gestört oder gesperrt.
  • Es gab einen Fehler beim Dekodieren des Inhalts des Körpers (zum Beispiel, weil der Content-Encoding-Header falsch ist).
  • Der MIME-Typ des Körpers kann nicht von den im Antwort-Header enthaltenen Content-Type-Headern bestimmt werden.
  • Der Körper kann nicht als FormData-Objekt analysiert werden.

Beispiele

TBD.

Spezifikationen

Specification
Fetch Standard
# ref-for-dom-body-formdata①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch