Ratgeber: Warum ein sichtbares Formularfeld in FormData fehlen kann

Im Browser steht eine Projektnummer, nach dem Speichern fehlt sie jedoch im Datensatz. Ein Screenshot des Formulars beweist nicht, welche Werte tatsächlich übertragen wurden. Wer einen Entwicklungsauftrag schreibt, sollte deshalb zwischen sichtbarer Anzeige und abgesendeten Daten unterscheiden. Dieser Fachratgeber nutzt die bestehende FormData-Schnittstelle für eine überschaubare Fehlersuche.

Was aus einem Formular übernommen wird

MDN beschreibt FormData als Sammlung von Schlüssel-Wert-Paaren. Wird sie aus einem vorhandenen Formular erstellt, berücksichtigt sie Eingabefelder mit name-Attribut. Deaktivierte Felder und deaktivierte Feldgruppen werden nicht aufgenommen. Bei einer Übertragung als multipart/form-data soll der Content-Type nicht eigenmächtig gesetzt werden, damit der Browser die nötige Trennmarkierung ergänzen kann.

Diese Regeln erklären einen häufigen Unterschied zwischen Bildschirminhalt und Übertragung. Sie legen jedoch noch nicht fest, welche Daten ein Server akzeptieren darf. Diese Entscheidung bleibt Teil der Anwendung.

Einen kleinen Vorgang sichtbar machen

Plane ein fiktives Reparaturformular mit Projektnummer, Beschreibung und optionalem Foto. Die Projektnummer erscheint zur Orientierung, soll aber nicht frei veränderbar sein. Schreibe auf, woher der Server die verlässliche Zuordnung erhält. Eine bloß mitgesendete Nummer darf nicht ungeprüft darüber entscheiden, ob jemand fremde Vorgänge bearbeiten kann.

Für die lokale Fehlersuche reichen drei harmlose Testwerte. Vergleiche die im Formular angezeigten Werte mit den tatsächlich erzeugten FormData-Einträgen. Dabei sollte verständlich werden, ob der Wert schon beim Zusammenstellen fehlt oder erst nach dem Absenden falsch verarbeitet wird.

Absichtliche Auslassungen testen

Deaktiviere im Test einmal ein Feld und wiederhole den Vergleich. Entferne bei einem anderen Testfeld bewusst den Namen. Dokumentiere, welche Einträge fehlen. Diese kleinen Versuche erleichtern die Zuordnung, ohne echte Kundendaten oder Uploads zu benötigen. Prüfe anschließend die korrigierte Variante mit denselben Werten.

Den Bauauftrag um die Datenprüfung ergänzen

Fordere eine klare Rückmeldung bei fehlenden Pflichtangaben und eine serverseitig geprüfte Vorgangszuordnung. Die Bestätigung soll erst erscheinen, wenn der gewünschte Datensatz tatsächlich gespeichert wurde. Als Abnahmebeleg dienen die Testeingaben, die übertragenen Feldnamen und der daraus entstandene Testdatensatz. Damit wird aus einem scheinbar rätselhaften Formularfehler ein nachvollziehbarer Weg vom Eingabefeld bis zur Speicherung.