Abschnitt 13 · Lektion 2
Weiterleiten nach POST
Steht nach dem Abschicken eines Formulars die Antwort auf den POST im Fenster, schickt F5 das Formular ein zweites Mal ab. Und die Route legt alles noch einmal an.
Was beim Neuladen passiert
Ein Browser merkt sich, wie die Seite im Fenster entstanden ist. Kam sie aus einem POST, dann wiederholt das Neuladen genau diesen POST, mitsamt Rumpf.
import express from "express";
const app = express();
app.use(express.urlencoded({ extended: true }));
const notizen = [];
app.get("/", (req, res) =>
res.type("html").send(
'<form method="post" action="/notizen">' +
'<p><input name="text" value="Milch"></p>' +
"<p><button>Speichern</button></p>" +
"</form>"
)
);
// So nicht: der POST antwortet direkt mit dem Ergebnis.
app.post("/notizen", (req, res) => {
notizen.push(req.body.text);
res.type("text/plain").send(`Notizen: ${notizen.length}`);
});
app.listen(3000); Nach dem Abschicken des Formulars steht im Reiter Browser Notizen: 1. In deinem eigenen Browser
schickt F5 jetzt nach einer Rückfrage denselben POST noch einmal, und aus der 1 wird eine 2. Hier
geht das nicht. F5 lädt die ganze Lektionsseite, und der Button Seite neu laden holt die Adresse aus
der Adresszeile mit GET. Einen POST wiederholt keiner von beiden.
Deshalb wird im Terminal wiederholt. Jeder curl aus der Befehlsleiste legt dieselbe Notiz noch
einmal an, und die Zahl wächst mit jedem Mal um eins.
Zweimal dieselbe Anfrage, zwei Einträge. Im Browser kommt meist noch eine Rückfrage davor („Formular erneut senden?“). Die ist aber schnell weggeklickt, und wer sie wegklickt, hat zweimal bestellt.
Bei einer Notiz ist das ärgerlich. Bei einer Bestellung oder einer Überweisung ist es ein Supportfall. Nachstellen kann ihn niemand, denn er hängt allein davon ab, wie jemand seinen Browser bedient.
Post, Redirect, Get
Das Muster dagegen ist so alt wie das Problem. Es heißt nach seinen drei Schritten Post, Redirect, Get. Die POST-Route ändert etwas und antwortet dann mit einer Weiterleitung auf eine Seite, die per GET erreichbar ist. Das Ergebnis siehst du erst auf dieser Seite.
import express from "express";
const app = express();
app.use(express.urlencoded({ extended: true }));
const notizen = [];
// So: anlegen, dann mit 303 auf eine Seite schicken, die per GET
// erreichbar ist.
app.post("/notizen", (req, res) => {
notizen.push(req.body.text);
res.redirect(303, "/notizen");
});
app.get("/notizen", (req, res) => {
res.type("text/plain").send(`Notizen: ${notizen.length}`);
});
app.listen(3000); Die Liste unter /notizen steht gleich im Reiter Browser. Den POST gibt es in der Befehlsleiste
zweimal. Einmal bleibt curl an der Weiterleitung stehen, und mit -L folgt es ihr bis zur Liste.
Am Ende der Weiterleitung steht ein GET auf /notizen. Neuladen holt dieselbe Seite noch einmal,
und ein GET darf man beliebig oft wiederholen, ohne dass sich etwas ändert. Dafür gibt es die
Unterscheidung zwischen den Methoden aus Lektion 11.1.
Die Antwort auf den POST hat kaum einen Rumpf. Location sagt, wo es weitergeht, mehr braucht sie
nicht. Express legt zwar einen Satz hinein, See Other. Redirecting to /notizen, aber den liest nie
jemand. Der Browser ist da längst unterwegs, denn er folgt der Weiterleitung von selbst. Deshalb
bekommst du die 303 dort nie zu sehen, nur curl bleibt ohne -L davor stehen.
import express from "express";
const PORT = Number(process.env.PORT ?? 3000);
const app = express();
app.use(express.urlencoded({ extended: true }));
const notizen = [];
app.get("/", (req, res) => {
res.send([
"<!doctype html>",
'<meta charset="utf-8">',
"<title>Notizen</title>",
"<h1>Neue Notiz</h1>",
'<form method="post" action="/notizen">',
' <p><input name="text" value="Milch"></p>',
" <p><button>Speichern</button></p>",
"</form>",
`<p>Notizen im Speicher: ${notizen.length}</p>`,
].join("\n"));
});
app.post("/notizen", (req, res) => {
notizen.push(req.body.text);
res.redirect(303, "/notizen");
});
app.get("/notizen", (req, res) => {
res.send([
"<!doctype html>",
'<meta charset="utf-8">',
"<title>Notizen</title>",
`<h1>Notizen: ${notizen.length}</h1>`,
"<ul>",
...notizen.map((text) => ` <li>${text}</li>`),
"</ul>",
'<p><a href="/">Noch eine schreiben</a></p>',
].join("\n"));
});
app.listen(PORT); Nach dem Abschicken steht in der Adresszeile /notizen, und dahinter steckt ein GET. Lädst du die
Seite danach neu, auch mehrmals, wächst die Zahl nicht mehr.
Im Reiter Netzwerk hat der POST /notizen vom Formular eine eigene Zeile mit der 303. Aufgeklappt
steht im Anfrage-Rumpf die Notiz, die du getippt hast. Diesen Rumpf hätte F5 im ersten Beispiel
unverändert noch einmal geschickt.
Warum ausgerechnet 303
Im Beispiel stehen vier Codes für eine Weiterleitung nebeneinander. Jeder schickt auf sein eigenes Ziel, und das Ziel meldet, mit welcher Methode der Client dort ankam.
import express from "express";
const app = express();
app.get("/", (req, res) =>
res
.type("text/plain")
.send(
[301, 302, 303, 307]
.map((code) => `curl -s -L -d "" http://localhost:3000/start-${code}`)
.join("\n") + "\n"
)
);
// Vier Weiterleitungen, sonst gleich. Das Ziel meldet, welche Methode
// tatsaechlich bei ihm angekommen ist.
for (const code of [301, 302, 303, 307]) {
app.post(`/start-${code}`, (req, res) => res.redirect(code, `/ziel-${code}`));
app.all(`/ziel-${code}`, (req, res) =>
res.type("text/plain").send(`${code} -> beim Ziel kam an: ${req.method}`)
);
}
app.listen(3000); Die vier Befehle stehen in der Befehlsleiste und in der Seite. -d "" schickt einen POST mit leerem
Rumpf, -L folgt der Weiterleitung, und das Ziel sagt jedes Mal, welche Methode bei ihm ankam. Ein
-X POST hat hier nichts zu suchen. Damit schickt curl jede Anfrage als POST, auch die nach der
Weiterleitung, und alle vier sähen gleich aus.
- 301 heißt „diese Adresse gilt für immer nicht mehr“. Ein Browser darf sich das für GET merken, Suchmaschinen tragen die neue Adresse ein. Für eine Aktion ist das die falsche Aussage, denn die Adresse des Formulars gilt ja weiter.
- 302 heißt „im Moment woanders“.
- 303 heißt „schau dir das Ergebnis unter dieser Adresse an, und zwar per GET“.
- 307 behält die Methode bei, beim Ziel kommt wieder ein POST an.
In der Praxis machen 301, 302 und 303 alle dasselbe. Beim Ziel kommt ein GET an. Bei 301 und 302 tun die Clients das aus einer Gewohnheit, die sich in den neunziger Jahren eingebürgert hat, und die Norm würde ihnen auch etwas anderes erlauben. Bei 303 steht es geschrieben.
Die Rückmeldung, die keine Adresse hat
Eine Rückmeldung wie „Notiz gespeichert“ hat in der Antwort auf den POST keinen Platz, denn die sieht niemand mehr.
Am nächsten liegt ein Anhängsel an die Adresse, also /notizen?gespeichert=1. Das funktioniert. Nur
bleibt die Meldung beim Neuladen stehen, obwohl gerade nichts gespeichert wurde, und sie landet in
jedem Lesezeichen und jedem geteilten Link.
Sauberer ist es, die Meldung kurz beim Server abzulegen, einmal zu zeigen und dann wegzuwerfen. Dafür braucht es einen Platz, der zu diesem einen Besucher gehört, und so einen Platz baust du in Lektion 13.4. Eine Meldung, die nur einmal erscheinen soll, ist dort ein Eintrag, den die nächste Seite liest und wieder löscht.
Die POST-Route der Notizliste im Reiter Praxis antwortet direkt mit der ganzen Liste.
Zum Mitnehmen
Ein POST, der direkt mit der fertigen Seite antwortet, macht aus jedem Neuladen eine zweite Bestellung. Nach dem Anlegen antwortet die Route deshalb mit 303 und einer Adresse, die per GET erreichbar ist.
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 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.