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
# ref-for-dom-body-formdata①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
formData

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Siehe auch