mitmario.dev

FormData

JavaScript Im Browser 3 Min Lesezeit 3 BeispieleLektion 5 von 7

Fünfzehn Felder einzeln auszulesen ist Fleißarbeit, und mit jedem neuen Feld wird der Code länger. FormData sammelt alles auf einmal ein, und zwar nach denselben Regeln, nach denen der Browser beim Absenden sowieso sammelt.

Ein Aufruf für alles

Ein Formular auf einmal einsammeln
const formular = document.getElementById("formular");

formular.addEventListener("submit", (event) => {
  event.preventDefault();

  // Ein Aufruf, und alle Felder mit name sind drin.
  const daten = new FormData(formular);

  // get holt einen Wert, und bei diesen Feldern ist es immer Text.
  console.log("name:", daten.get("name"));
  console.log("alter:", daten.get("alter"), "| Typ:", typeof daten.get("alter"));

  // Durchlaufen geht wie über eine Liste von Paaren.
  const zeilen = [];
  for (const [schluessel, wert] of daten) {
    zeilen.push(`${schluessel} = ${wert}`);
  }
  document.getElementById("ausgabe").textContent = zeilen.join("\n");

  console.log("Anzahl Einträge:", [...daten.keys()].length);
});

console.log("Erst das Absenden sammelt ein.");

new FormData(formular) liest das ganze Formular ein. Heraus kommt eine Sammlung von Paaren aus Schlüssel und Wert.

daten.get("name") holt einen Wert, daten.has("newsletter") fragt, ob ein Schlüssel überhaupt da ist. Über die Paare läufst du wie über eine Liste, mit dem Destructuring aus Abschnitt 7.

Auch hier ist alles Text. Ein type="number" ändert daran nichts, genau wie bei value.

Fragst du in der Eingabezeile der Console nur nach new FormData(formular), kommt bloß FormData {} zurück. Die Paare stehen nicht als Eigenschaften darin, an sie kommst du nur über get, has und das Durchlaufen. [...new FormData(formular)] macht die Paare zu einer Liste, [["name", "Ida"], ["alter", "34"], ["thema", "javascript"]]. Und Object.fromEntries(new FormData(formular)) antwortet mit {name: "Ida", alter: "34", thema: "javascript"}. Beide Male steht "34" in Anführungszeichen.

Was nicht dabei ist

Was fehlt, und warum
document.getElementById("formular").addEventListener("submit", (event) => {
  event.preventDefault();
  const daten = new FormData(event.currentTarget);

  document.getElementById("ausgabe").textContent = [...daten.keys()].join("\n");

  // Ohne name ist ein Feld nicht dabei, so ist die Regel.
  console.log("Schlüssel:", [...daten.keys()]);

  // Eine nicht angehakte Checkbox fehlt einfach. Sie steht
  // nicht als false darin, es ist gar nicht da.
  console.log("haken vorhanden?", daten.has("haken"));
  console.log("haken get:", daten.get("haken"));

  // Das angehakte ist da, und zwar mit seinem value.
  console.log("gesetzt:", daten.get("gesetzt"));

  // Ein gesperrtes Feld zählt ebenfalls nicht mit.
  console.log("gesperrt vorhanden?", daten.has("gesperrt"));

  // Deshalb fragt man bei Checkboxen has() und nicht get().
  console.log("als Wahrheitswert:", daten.has("haken"), daten.has("gesetzt"));
});

console.log("Jedes Absenden sammelt den Stand der Checkboxen neu ein.");

Drei Sorten Feld fehlen in einem FormData, und alle drei überraschen beim ersten Mal.

Felder ohne name fehlen, und es zählt name, nicht id. Ein Feld ohne name-Attribut gibt es für das Formular nicht, so sichtbar es auch sein mag. So funktionieren Formulare schon immer.

Nicht angehakte Checkboxen fehlen ganz. Der Schlüssel steht nicht etwa auf false, es gibt ihn schlicht nicht, und daten.get("haken") liefert null. Bei einer Checkbox fragst du deshalb mit has und nicht mit get, und daten.has("newsletter") ist der Wahrheitswert, um den es geht.

Gesperrte Felder fehlen auch. Ein disabled schließt das Feld vom Absenden aus und damit auch von FormData.

Keine dieser drei Regeln hat sich FormData ausgedacht, es sind die Regeln des Formulars selbst. Schickst du ohne preventDefault ab, steht im Reiter „Netzwerk“ dieselbe Liste von Paaren. Das Feld ohne name fehlt, die nicht angehakte Checkbox fehlt, und eine angehakte ohne eigenen value steht mit on da, hier wie dort. FormData sammelt also genau das, was beim Absenden losginge, nur eben bevor die Anfrage rausgeht.

In ein Objekt umwandeln

In ein Objekt umwandeln
document.getElementById("formular").addEventListener("submit", (event) => {
  event.preventDefault();
  const daten = new FormData(event.currentTarget);

  // Object.fromEntries macht aus den Paaren ein Objekt.
  // Bequem, und es hat zwei Haken.
  const roh = Object.fromEntries(daten);
  // JSON.stringify schreibt das Objekt in einer Zeile als Text,
  // das Format dahinter erklärt Abschnitt 16.
  console.log("roh:", JSON.stringify(roh));

  // Erstens: alles ist Text, auch das Alter.
  console.log("Typ von alter:", typeof roh.alter);

  // Zweitens: bei mehrfach vergebenem name bleibt nur der
  // letzte übrig. Dafür gibt es getAll.
  console.log("alle Tage:", daten.getAll("tag"));

  // Also von Hand, mit den richtigen Typen:
  const sauber = {
    name: daten.get("name"),
    alter: Number(daten.get("alter")),
    tage: daten.getAll("tag"),
  };

  document.getElementById("ausgabe").textContent = JSON.stringify(sauber, null, 2);
});

console.log("Nach dem Absenden stehen beide Fassungen nebeneinander.");

Object.fromEntries(daten) macht in einer Zeile ein normales Objekt daraus. Das ist bequem, hat aber zwei Haken.

Alle Werte sind Text. Ein Objekt mit alter: "34" sieht fertig aus und ist es nicht. Beim nächsten Rechnen hängt ein Plus daran nur Text an.

Mehrfachwerte gehen verloren. Kommt ein name mehrmals vor, etwa bei einer Gruppe von Checkboxen, bleibt nur der letzte übrig. Dafür gibt es getAll, das eine Liste zurückgibt.

Im Kurs steht deshalb der ausgeschriebene Weg. Das Objekt wird Feld für Feld gebaut, mit Number wo gerechnet wird, has bei Checkboxen und getAll bei Gruppen. Das sind ein paar Zeilen mehr. Dafür ist das die einzige Stelle, an der die Typen festgelegt werden.

Wie es weitergeht

In Abschnitt 16 wird dieses Objekt verschickt. fetch nimmt ein FormData direkt an, und in eine Anfrage mit JSON gehört das saubere Objekt.

Bis dahin ist es der Zustand aus Lektion 12.8, nur aus einem Formular gefüllt statt aus Klicks.

In der Aufgabe sammelst du ein Formular mit vier Feldern ein und machst daraus ein Objekt mit den richtigen Typen.

Zum Mitnehmen

FormData sammelt ein Formular nach den Regeln des Absendens ein, nur Felder mit name, keine nicht angehakten Checkboxen und keine gesperrten Felder. Alle Werte sind Text, und die Typen legt ein Objekt fest, das Feld für Feld gebaut wird.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.