mitmario.dev

Die Anfrage lesen

Node.js Sandbox 4 Min Lesezeit 3 BeispieleLektion 3 von 8

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

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.

Was in req.url wirklich steht
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.

Kopfzeilennamen sind kleingeschrieben
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-type sagt, was im Rumpf der Anfrage steckt. Wichtig ab Abschnitt 10, wenn du Formulare und JSON entgegennimmst.
  • accept sagt, was der Aufrufer gern hätte.
  • user-agent sagt, welches Programm anfragt.
  • cookie trägt die Cookies, die du selbst vorher gesetzt hast. Darum geht es in Lektion 13.3.
  • authorization trä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, 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.