mitmario.dev

Formulardaten annehmen

Node.js Sandbox 4 Min Lesezeit 3 BeispieleLektion 1 von 6

Ein Formular in einer Webseite schickt kein JSON, egal was dein Server erwartet. Das Format legt der Browser fest, und es ist seit den neunziger Jahren dasselbe. Eine Route, die auf JSON wartet, bekommt davon schlicht nichts mit. Dazu kommen zwei Eigenheiten der Checkboxen, über die ein Server leicht falsch zählt.

Was beim Abschicken über die Leitung geht

Ein <form method="post" action="/anmelden"> sammelt beim Klick auf den Button alle Felder ein, die ein name-Attribut haben, und schickt sie als eine einzige Zeile los.

Was der Browser wirklich abschickt
import express from "express";

const app = express();


// Ein echtes Formular. Ein Klick auf den Button schickt es so ab, wie
// es jeder Browser tut.
app.get("/", (req, res) =>
  res.type("html").send(
    '<form method="post" action="/anmelden">' +
      '<p><input name="name" value="Mario"></p>' +
      '<p><label><input type="checkbox" name="newsletter" checked> Newsletter</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="js" checked> JavaScript</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="node" checked> Node</label></p>' +
      "<p><button>Abschicken</button></p>" +
      "</form>"
  )
);

// Kein Parser angemeldet: hier kommt der Rumpf roh an, so wie ihn der
// Browser beim Abschicken auf die Leitung legt.
app.post("/anmelden", (req, res) => {
  let roh = "";
  req.on("data", (stueck) => {
    roh += stueck;
  });
  req.on("end", () => {
    res.type("text/plain").send(
      `Content-Type: ${req.headers["content-type"]}\nRumpf:        ${roh}\n`
    );
  });
});

app.listen(3000);

Im Reiter Browser steht ein echtes Formular. Nach einem Klick auf „Abschicken“ siehst du in der Antwort Zeichen für Zeichen, was dein Browser gerade auf die Leitung gelegt hat.

Mehr Kodierung gibt es nicht. Schlüssel, Gleichheitszeichen, Wert, und zwischen zwei Paaren ein &. Sonderzeichen werden verpackt wie in einer Adresse, und ein Leerzeichen schreibt der Browser als +. express.urlencoded() versteht beim Lesen auch %20 und macht aus beidem wieder ein Leerzeichen. Das Format heißt application/x-www-form-urlencoded, so steht es in der Kopfzeile darüber.

Den Rumpf siehst du hier nur, weil der Server ihn ausdrücklich zurückschickt. Ein richtiger Server tut das nicht. Dort findest du den Rumpf im Reiter Netzwerk unter Anfrage-Rumpf, wenn du den POST aufklappst. Das klappt allerdings nur, wenn nach dem POST eine Seite kommt, direkt oder über eine Weiterleitung. Nach einer Antwort aus reinem Text wie hier bleibt der Reiter leer.

An name hängt mehr, als man dem Attribut ansieht. Sein Wert wird der Schlüssel im Rumpf. Die Beschriftung neben dem Feld geht gar nicht mit. Ein Feld ohne name fehlt in der Zeile ganz, egal was drinsteht, und das ist einer der stilleren Fehler beim Bauen eines Formulars. Außerdem taucht thema zweimal auf, denn der Browser wirft nichts weg, wenn zwei Felder denselben Namen tragen.

Der Parser dafür heißt urlencoded

express.json() aus Lektion 10.3 hilft hier nicht weiter. Für Formulare gibt es express.urlencoded({ extended: true }), und das wird genau wie sein Geschwister als Middleware ganz oben angemeldet.

Derselbe Rumpf, von urlencoded gelesen
import express from "express";

const app = express();

app.use(express.urlencoded({ extended: true }));

// Ein echtes Formular. Ein Klick auf den Button schickt es so ab, wie
// es jeder Browser tut.
app.get("/", (req, res) =>
  res.type("html").send(
    '<form method="post" action="/anmelden">' +
      '<p><input name="name" value="Mario"></p>' +
      '<p><label><input type="checkbox" name="newsletter" checked> Newsletter</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="js" checked> JavaScript</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="node" checked> Node</label></p>' +
      "<p><button>Abschicken</button></p>" +
      "</form>"
  )
);

app.post("/anmelden", (req, res) => {
  res.json({
    body: req.body,
    typVonThema: Array.isArray(req.body.thema) ? "Array" : typeof req.body.thema,
  });
});

app.listen(3000);

Dasselbe Formular, diesmal mit dem Parser davor. Mit allen Haken kommt ein Objekt mit den Feldnamen als Schlüssel an, und thema ist darin eine Liste mit zwei Einträgen. Nimmst du danach einzelne Haken weg und schickst noch einmal ab, schrumpft das Objekt. Und zwar auf zwei verschiedene Arten.

Ein Feld ist einmal Text und einmal Liste

Mit einem einzigen Thema ist thema ein ganz normaler Text. Der Parser rät nicht, ob du eine Liste erwartest. Er gibt dir nur, was angekommen ist.

Gemein daran ist, dass dein Code trotzdem läuft. Zählst du mit req.body.thema.length, bekommst du bei zwei Themen eine 2 und freust dich. Bei einem einzigen Thema js kommt ebenfalls eine 2 heraus, denn das ist die Länge des Texts. Der Fehler steckt also ausgerechnet im einfachsten Fall. Laut wird er erst ohne jeden Haken. Dann fehlt thema ganz, und dieselbe Zeile endet mit TypeError: Cannot read properties of undefined (reading 'length') und einem 500.

Dagegen hilft [].concat(req.body.thema ?? []). Es macht aus keinem Wert eine leere Liste, aus einem Wert eine Liste mit einem Eintrag und lässt eine Liste in Ruhe. Danach zählst du gefahrlos.

Die Checkbox, die nichts schickt

Ohne Haken bei „Newsletter“ fehlt der Schlüssel newsletter in req.body ganz. Eine Checkbox wird nur mitgeschickt, wenn sie angehakt ist. Dann kommt der Wert aus ihrem value-Attribut mit, und hat sie keins, steht da schlicht on.

Ein if (req.body.newsletter === false) ist deshalb nie wahr, auch ohne Haken nicht. Gefragt wird, ob der Schlüssel da ist. Genauso ist es bei einer Gruppe von Radio-Buttons, in der nichts gewählt ist, und bei einer Auswahlliste mit multiple, in der nichts markiert ist. Eine gewöhnliche Auswahlliste hat dagegen immer einen Eintrag gewählt und schickt ihn mit.

Der falsche Parser tut gar nichts

Steht express.json() an der Stelle von express.urlencoded(), sieht der Server auf den ersten Blick richtig aus.

Mit express.json statt urlencoded
import express from "express";

const app = express();

// Der falsche Parser: express.json() ist fuer application/json zustaendig
// und laesst den Rumpf eines Formulars unberuehrt liegen.
app.use(express.json());

// Ein echtes Formular. Ein Klick auf den Button schickt es so ab, wie
// es jeder Browser tut.
app.get("/", (req, res) =>
  res.type("html").send(
    '<form method="post" action="/anmelden">' +
      '<p><input name="name" value="Mario"></p>' +
      '<p><label><input type="checkbox" name="newsletter" checked> Newsletter</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="js" checked> JavaScript</label></p>' +
      '<p><label><input type="checkbox" name="thema" value="node" checked> Node</label></p>' +
      "<p><button>Abschicken</button></p>" +
      "</form>"
  )
);

app.post("/anmelden", (req, res) => {
  res.json({ typ: typeof req.body, name: req.body?.name ?? null });
});

app.listen(3000);

Wieder dasselbe Formular, wieder derselbe Button. Diesmal ist req.body aber undefined, obwohl der Rumpf vollständig angekommen ist. Jeder Parser schaut zuerst auf den Content-Type und lässt liegen, wofür er nicht zuständig ist. Soll ein Server Formulare und JSON annehmen, stehen beide Parser untereinander. Die stören sich nicht.

Eine dritte Art gibt es noch. Hat ein Formular ein Feld für Dateien, wechselt der Browser auf multipart/form-data, denn eine Datei lässt sich nicht sinnvoll in eine Zeile aus Gleichheitszeichen pressen. Express bringt dafür nichts mit, das macht ein Paket. Datei-Uploads bleiben in diesem Kurs draußen. Sie sind ein Thema für sich, vor allem weil man genau prüfen muss, was da hochkommt.

In der Aufgabe fasst deine Route ein abgeschicktes Anmeldeformular in drei Zeilen Text zusammen.

Zum Mitnehmen

Ein Formular schickt seine Felder als eine Zeile aus Schlüsseln und Werten, und in Express liest sie express.urlencoded. Eine Checkbox ohne Haken fehlt darin ganz, und ein Feld mit zwei Werten kommt als Liste an, mit nur einem als Text.

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.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.