Abschnitt 13 · Lektion 1
Formulardaten annehmen
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.
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.
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.
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, kostenlosZu 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.