mitmario.dev

Daten schicken

JavaScript Im Browser 4 Min Lesezeit 3 BeispieleLektion 5 von 7

Diesmal soll nichts geholt werden. Die Daten aus einem Formular sollen zum Server. Dafür bekommt fetch ein zweites Argument, ein Objekt mit Einstellungen, und drei Eigenschaften davon brauchst du ständig, nämlich method, headers und body.

JSON geht als Text

Ein POST mit JSON
const anmeldung = {
  name: "Mario",
  kurs: "javascript",
  newsletter: true,
};

const optionen = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify(anmeldung),
};

console.log("Methode:", optionen.method);
console.log("Kopfzeile:", optionen.headers["Content-Type"]);
console.log("Typ des Rumpfs:", typeof optionen.body);
console.log("Rumpf:", optionen.body);

// So sähe der Aufruf aus. Es gibt hier keinen Endpoint,
// der ihn annimmt, deshalb bleibt die Zeile stehen.
// const antwort = await fetch("/api/anmeldung", optionen);

method: "POST" heißt, dass etwas hingeschickt statt geholt wird. In body steht das, was hingeschickt wird.

Über die Leitung geht Text, und daraus folgt alles Weitere. Ein JavaScript-Objekt lässt sich nicht abschicken, denn es existiert nur in deinem Browser. Deshalb steht vor einem JSON-body ein JSON.stringify.

Wenn du das vergisst und das Objekt direkt übergibst, gibt es keinen Fehler. Stattdessen kommt das Ergebnis der stillen Umwandlung in Text heraus, [object Object], und beim Server landet eine Anfrage, in der nichts steht, was er brauchen kann.

In headers steht, wie der Server den Rumpf lesen soll, bei JSON mit Content-Type: application/json. Fehlt die Zeile, schreibt der Browser text/plain;charset=UTF-8 hinein, und ein Server, der JSON erwartet, liest den Rumpf dann nicht als JSON.

Die beiden gehören zusammen, JSON.stringify im body und application/json in der Kopfzeile. Eines ohne das andere ergibt keinen Sinn.

Abgeschickt wird in dieser Lektion nichts, und im Reiter „Netzwerk“ bleibt es deshalb still. In den ersten beiden Beispielen steht das fetch als Kommentar da, und im dritten ist der Server durch eine Funktion ersetzt, die nach einer halben Sekunde antwortet. Der Grund ist derselbe wie beim geprüften Formular. Wer wirklich etwas abschickt, braucht ein Ziel, und das müsste die Anfrage prüfen, begrenzen und hinterher wieder aufräumen. Wie eine echte Anfrage in der Liste aussieht, kam in den Lektionen davor.

Die Alternative mit FormData

Derselbe POST mit FormData
const formular = document.getElementById("formular");
const daten = new FormData(formular);

for (const [name, wert] of daten.entries()) {
  console.log(name, "=", wert);
}

const optionen = {
  method: "POST",
  // Kein Content-Type. Der Browser setzt ihn selbst, samt
  // Trennzeichen, das er sich ausdenkt.
  body: daten,
};

console.log("Methode:", optionen.method);
console.log("Eigene Kopfzeilen:", Object.keys(optionen.headers || {}).length);
console.log("Rumpf ist FormData:", optionen.body instanceof FormData);

FormData aus Lektion 13.5 darf direkt als body stehen, ganz ohne Umwandlung.

Dabei gilt die umgekehrte Regel. Bei FormData bleibt der Content-Type weg. Der Browser packt die Felder in ein Format mit einem Trennzeichen zwischen den Teilen, und dieses Trennzeichen denkt er sich in dem Moment aus, in dem er die Anfrage baut. Es muss mit in der Kopfzeile stehen, damit der Server weiß, wonach er trennen soll. Wenn du die Kopfzeile selbst setzt, überschreibst du das erfundene Trennzeichen mit nichts, und der Server findet die Grenzen zwischen den Feldern nicht mehr.

FormData nehme ich, wenn Dateien dabei sind oder die Daten sowieso aus einem Formular kommen. Für alles andere nehme ich JSON, besonders wenn die Daten verschachtelt sind.

CORS

Ein Server entscheidet selbst, wessen Seiten seine Antworten sehen dürfen.

Wenn eine Seite bei einem anderen Server nachfragt, schickt der Browser mit, von wo die Anfrage kommt. Der Server antwortet mit einer Kopfzeile, in der steht, für welchen Origin die Antwort freigegeben ist. Passt sie nicht, hat der Browser die Antwort zwar bekommen, gibt sie deinem Code aber nicht heraus, und du bekommst genau denselben Fehler wie bei einer toten Leitung.

Bei einem POST mit JSON an einen fremden Server kommt ein Schritt dazu. Der Browser fragt vorher mit der Methode OPTIONS an, ob die Anfrage überhaupt erlaubt ist, und deshalb stehen in einer Netzwerkliste zwei Zeilen statt einer. Das nennt sich Preflight. Wenn ein POST scheitert, obwohl er richtig aussieht, steht die Antwort meistens in dieser ersten Zeile.

Hier im Kurs siehst du das nicht. Gefragt wird zwar auch hier, denn die Seite im Reiter „Browser“ hat keinen eigenen Origin, und für sie ist jeder Server fremd. Im Reiter „Netzwerk“ stehen aber nur die Anfragen, die die Seite selbst stellt, und die Vorabfrage stellt der Browser. Du findest sie in den Entwicklerwerkzeugen, spätestens beim ersten eigenen POST an eine fremde Adresse.

Der vollständige Handler

Der vollständige Handler
const formular = document.getElementById("formular");
const button = document.getElementById("senden");
const statusFeld = document.getElementById("status");

// NACHGESTELLT: hier stünde in einer echten Anwendung das
// fetch mit method POST. Es antwortet nach kurzer Zeit und
// lehnt einen leeren Namen ab.
function schicken(daten) {
  return new Promise((fertig, ablehnen) => {
    setTimeout(() => {
      if (!daten.get("name")) {
        ablehnen(new Error("Server meldet 400"));
        return;
      }
      fertig({ id: 17 });
    }, 500);
  });
}

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

  statusFeld.textContent = "Wird gesendet ...";
  button.disabled = true;

  try {
    const ergebnis = await schicken(new FormData(formular));
    statusFeld.textContent = `Gespeichert unter der Nummer ${ergebnis.id}.`;
    formular.reset();
  } catch (fehler) {
    statusFeld.textContent = "Konnte nicht gesendet werden. Bitte versuch es noch einmal.";
    console.warn("Absenden fehlgeschlagen:", fehler.message);
  } finally {
    button.disabled = false;
  }
});

Im dritten Beispiel kommt der ganze Abschnitt zusammen, preventDefault, FormData, die Ladezustände aus der vorigen Lektion und finally.

Wichtig ist, was vor dem try steht und was nach dem Absenden passiert. Das Formular wird erst zurückgesetzt, wenn wirklich gespeichert wurde. Nach einem Fehlschlag bleiben die Eingaben stehen, sonst müsste jemand alles noch einmal tippen.

Das Absenden selbst ist hier nachgestellt, und das steht auch so im Code. Alles drumherum ist echt.

Warum diese Lektion keine Aufgabe hat

Um einen POST wirklich auszuführen, bräuchte dieser Kurs einen Endpoint, der Daten annimmt. Und der bräuchte alles, was dazugehört, eine Begrenzung der Anfragen pro Minute, eine Prüfung der Größe, einen Schutz gegen automatisierte Zugriffe und eine Antwort auf die Frage, was mit den Daten passiert. Das ist ein eigenes Vorhaben und kein Kursinhalt. Der Stoff bleibt trotzdem hier, denn ohne ihn kennst du nur die Hälfte von fetch.

Was der Server noch einmal prüft

Was der Browser schickt, kann jeder verändern. Jede Anfrage lässt sich nachbauen und mit anderen Werten wiederholen, und dafür braucht es keine besonderen Werkzeuge.

In Lektion 16.2 steht unter jeder Anfrage im Reiter „Netzwerk“ ihre curl-Zeile. Die kannst du in ein Terminal kopieren, nach Belieben ändern und abschicken. Der Server bekommt sie und kann nicht erkennen, dass sie nicht aus dem Browser kam, und genauso wenig, ob das JavaScript vorher irgendetwas geprüft hat.

Eine Prüfung im JavaScript ist deshalb keine Sicherheitsmaßnahme. Sie ist eine Freundlichkeit, damit niemand auf eine Antwort warten muss, die absehbar ein Fehler wird, und die Prüfung, die zählt, passiert auf dem Server noch einmal von vorn. Wie sie dort aussieht, zeigt der Node-Kurs in seinem Abschnitt über JSON-APIs.

Zum Mitnehmen

Ein POST braucht method, einen Text im body und die passende Kopfzeile Content-Type, bei FormData ohne diese Kopfzeile. Was der Browser schickt, kann jeder nachbauen, geprüft wird deshalb auf dem Server.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

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.