Abschnitt 8 · Lektion 3
Die Anfrage lesen
Unter /buecher soll eine Bücherliste kommen, und über POST soll ein neues Buch angelegt werden.
Eine Suche braucht ihren Suchbegriff. Woran der Server das erkennt, steht in req, und drei Dinge
davon brauchst du ständig.
Methode und Pfad
import { createServer } from "node:http";
const server = createServer((req, res) => {
res.setHeader("Content-Type", "text/plain; charset=utf-8");
res.end(`${req.method} ${req.url}\n`);
});
server.listen(3000); req.method ist die Methode in Großbuchstaben, req.url der angefragte Pfad. Der Server oben
antwortet mit nichts anderem als diesen beiden Angaben. Du kannst ihn also fragen und nachlesen, was
angekommen ist. Mit einer anderen Adresse in der Adresszeile ändert sich der Pfad in der Antwort
mit.
Eine andere Methode bekommst du im Browser nicht hin, denn der schickt beim Eintippen immer GET.
Im Terminal geht es. Die drei Befehle aus der Befehlsleiste fragen /buecher einmal mit GET und
einmal mit POST und /buecher/12 mit DELETE.
Zusammen ergeben die beiden Angaben die Frage, die dein Server beantworten muss. Diese Frage hat
immer zwei Teile. GET /buecher und POST /buecher sind zwei völlig verschiedene Dinge am selben
Ort. Das eine holt die Liste, das andere legt einen Eintrag an. Wer nur auf den Pfad schaut, baut
sich einen Server, der beim Anlegen die Liste zurückgibt.
req.url ist nicht die ganze Adresse
Der Name führt in die Irre. In req.url steht nicht die Adresse, die der Nutzer eingetippt hat,
sondern nur alles hinter Hostname und Port.
import { createServer } from "node:http";
const server = createServer((req, res) => {
const adresse = new URL(req.url, "http://localhost");
res.setHeader("Content-Type", "text/plain; charset=utf-8");
res.end(
[
`req.url ist: ${req.url}`,
`pathname: ${adresse.pathname}`,
`q: ${adresse.searchParams.get("q")}`,
`seite: ${adresse.searchParams.get("seite")}`,
].join("\n") + "\n"
);
});
server.listen(3000); Im Reiter Browser ist hier gleich /suche?q=kaffee&seite=2 geladen. In der ersten Zeile der Antwort
steht, was davon in req.url ankommt. Der Hostname fehlt, das Protokoll auch. Das ist eigentlich
einleuchtend, denn die Anfrage ist ja schon bei dir angekommen. Wo sie hin sollte, weiß dein Server,
sonst hätte er sie nicht.
Zum Zerlegen nimmst du new URL(req.url, "http://localhost"). Das zweite Argument ist eine Basis,
die URL braucht, weil der erste Teil allein keine vollständige Adresse ist. Welchen Hostnamen du
dort hinschreibst, ist völlig egal, solange du danach nur pathname und searchParams benutzt.
Der handgestrickte Weg wäre req.url.split("?")[0], und für den Pfad allein funktioniert er sogar.
Sobald aber Werte aus der Adresszeile dazukommen, ist Schluss. Bei Kodierung, Mehrfachwerten, leeren
Werten und Sonderzeichen geht es schief. Mehr dazu in Lektion 8.6, und die Kurzfassung ist, dass
URL das alles schon richtig macht.
Kopfzeilen
req.headers ist ein ganz normales Objekt mit den Kopfzeilen der Anfrage.
import { createServer } from "node:http";
const server = createServer((req, res) => {
const zeilen = Object.entries(req.headers).map(
([name, wert]) => `${name} = ${wert}`
);
res.setHeader("Content-Type", "text/plain; charset=utf-8");
res.end(zeilen.join("\n") + "\n");
});
server.listen(3000); Im Reiter Browser steht, was beim Server angekommen ist, also die Kopfzeilen deines Browsers.
Dazwischen steht rund ein Dutzend, das er gar nicht geschickt hat. Ihre Namen fangen mit
x-forwarded-, x-vercel- oder x-real- an, und geschrieben hat sie der Rechner, über den die
Seite hier ausgeliefert wird. Für deinen Server sind sie Kopfzeilen wie alle anderen.
curl -s -H "X-Test: Hallo" http://localhost:3000/ schickt eine eigene dazu, mit einem
Großbuchstaben im Namen.
In der Antwort steht x-test = Hallo. Die Namen sind immer kleingeschrieben, egal wie der
Aufrufer sie geschrieben hat. Darauf kannst du dich verlassen, Node sagt es so zu. Deshalb findet
req.headers["x-test"] den Wert, und req.headers["X-Test"] ist undefined. Die Werte lässt Node
dagegen so, wie sie ankamen.
Die Handvoll, die dir im Alltag wirklich begegnet:
content-typesagt, was im Rumpf der Anfrage steckt. Wichtig ab Abschnitt 10, wenn du Formulare und JSON entgegennimmst.acceptsagt, was der Aufrufer gern hätte.user-agentsagt, welches Programm anfragt.cookieträgt die Cookies, die du selbst vorher gesetzt hast. Darum geht es in Lektion 13.3.authorizationträgt Anmeldedaten.
Kopfzeilen sind Behauptungen
Glauben darf dein Server davon nichts. Jede Kopfzeile kommt von außen, und wer anfragt, muss kein
Browser sein. X-Test war eben frei erfunden, und genauso frei lässt sich user-agent, accept
oder authorization erfinden. Mit
curl -s -H "User-Agent: ich bin ein Browser, ehrlich" http://localhost:3000/ gibt sich curl als
Browser aus.
Wer die Sprache aus accept-language liest, um eine Übersetzung zu wählen, macht alles richtig. Im
schlimmsten Fall steht die Seite eben auf Finnisch da. Liest dein Server aus einer Kopfzeile, wer
der Nutzer ist, hat er ein Problem, denn diese Zeile kann sich jeder selbst schreiben, mit curl
genauso wie mit jedem anderen Programm.
Das gehört hierher und nicht erst in Abschnitt 15, denn ab der nächsten Lektion arbeitest du mit diesen Werten.
Was dein Server aus einer Anfrage herausliest, gibt er in der Aufgabe gleich wieder zurück.
Zum Mitnehmen
req.method und req.url sagen, was der Aufrufer will, req.headers bringt seine Kopfzeilen mit kleingeschriebenen Namen. Alles davon kommt von außen, und nichts davon ist geprüft.
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.