Abschnitt 8 · Lektion 6
Query-Parameter
Suchbegriff und Seitenzahl sollen in die Adresse passen. Dann kann man eine Suche als Lesezeichen
speichern oder weitergeben. Dafür stehen hinter dem Fragezeichen Werte, die der Aufrufer mitschickt,
wie in ?q=kaffee&seite=2. Jeder davon heißt Query-Parameter. Das ist ein Name und ein Wert mit =
dazwischen, und mehrere stehen mit & getrennt hintereinander. Ein Link mit ?seite=2 am Ende
schickt sie so, und ein Formular mit method="get" hängt seine Felder auf dieselbe Weise an die
Adresse. Das new URL(req.url, "http://localhost"), das dir schon den Pfad geliefert hat, gibt dir
auch die Werte.
searchParams
const adresse = new URL("/suche?q=kaffee&tag=neu&tag=rabatt&leer=", "http://localhost");
console.log(`pathname: ${adresse.pathname}`);
console.log(`q: ${JSON.stringify(adresse.searchParams.get("q"))}`);
console.log(`tag: ${JSON.stringify(adresse.searchParams.get("tag"))}`);
console.log(`getAll: ${JSON.stringify(adresse.searchParams.getAll("tag"))}`);
console.log(`leer: ${JSON.stringify(adresse.searchParams.get("leer"))}`);
console.log(`fehlt: ${JSON.stringify(adresse.searchParams.get("fehlt"))}`); get gibt dir bei mehrfach vorhandenen Namen nur den ersten. ?tag=neu&tag=rabatt ist eine völlig
legale Adresse. Wenn du dort nur get("tag") aufrufst, verlierst du die Hälfte. Dafür gibt es
getAll, das immer ein Array zurückgibt.
Ein fehlender Wert ist null, ein leerer Wert ist "". Den Unterschied braucht man manchmal. ?q=
heißt „hat gesucht, aber nichts eingegeben“, und ? ganz ohne q heißt „hat gar nicht gesucht“.
Wem der Unterschied egal ist, der behandelt beides gleich, aber dann mit Absicht.
Warum nicht von Hand
Der naheliegende Weg wäre, an & und dann an = zu trennen. Er sieht nach drei Zeilen aus und ist
falsch.
const roh = "q=caf%C3%A9+crema&tag=a&tag=b";
// Der naheliegende Weg: an & trennen, dann an = trennen.
const vonHand = {};
for (const paar of roh.split("&")) {
const [name, wert] = paar.split("=");
vonHand[name] = wert;
}
console.log(`von Hand: ${JSON.stringify(vonHand)}`);
const params = new URL(`/suche?${roh}`, "http://localhost").searchParams;
console.log(`q: ${JSON.stringify(params.get("q"))}`);
console.log(`tag: ${JSON.stringify(params.getAll("tag"))}`); Zwei Fehler auf einmal. Der zweite tag hat den ersten überschrieben, weil ein Objekt nur einen
Wert je Schlüssel hat. Und der Suchbegriff steht noch kodiert da. %C3%A9 ist das é, und das +
ist ein Leerzeichen. In der Adresszeile müssen solche Zeichen umgeschrieben werden, denn & und =
haben dort ja schon eine Bedeutung.
Dazu kommen die Fälle, die im Beispiel gar nicht auftauchen. Ein Wert, der selbst ein = enthält,
wird von split("=") an der falschen Stelle zerschnitten. Und ein Name ohne = ergibt undefined
statt "".
Unlösbar ist nichts davon, searchParams hat es nur schon gelöst.
Jeder Wert ist Text
const params = new URL("/liste?seite=2&limit=abc", "http://localhost").searchParams;
const seite = params.get("seite");
console.log(`seite ist ${JSON.stringify(seite)}, also ${typeof seite}`);
console.log(`seite + 1 ergibt ${JSON.stringify(seite + 1)}`);
console.log(`Number(seite) + 1 ergibt ${Number(seite) + 1}`);
const limit = params.get("limit");
console.log(`Number(limit) ergibt ${Number(limit)}`);
console.log(`Number.isInteger(Number(limit)) ergibt ${Number.isInteger(Number(limit))}`); seite ist "2", nicht 2. Deshalb ergibt seite + 1 den Text "21", denn + hängt Texte
aneinander. Das ist dieselbe Regel wie bei den Kommandozeilenargumenten und den Umgebungsvariablen
in Abschnitt 4. Hier kommt sie zum dritten Mal, weil sie an allen drei Stellen dieselbe Sorte Fehler
erzeugt. Tückisch ist, dass seite * 2 trotzdem 4 ergibt. Mit * wandelt JavaScript den Text
still um, mit + nicht. Derselbe Wert rechnet also einmal richtig und einmal falsch.
Und Prüfen heißt hier wirklich prüfen. Number("abc") wirft keinen Fehler, sondern ergibt NaN.
Mit NaN geht es dann fröhlich weiter, es lässt sich addieren, vergleichen und in eine Datenbank
schreiben. Wer nur umwandelt und nicht prüft, hat irgendwann eine Zeile in der Datenbank, in der
statt einer Zahl NULL steht, und keine Ahnung, wo sie herkam.
Die Prüfung, die du in den meisten Fällen willst, steht in der letzten Zeile des Beispiels.
Number.isInteger sagt in einem Aufruf, ob eine ganze Zahl herausgekommen ist, und ist bei NaN
sauber false. Dazu kommt meistens noch eine Grenze. ?seite=-5 ist zwar eine ganze Zahl, aber
eben keine Seite. Bei einem ungültigen Wert hat der Aufrufer den Fehler gemacht, also ist es ein
400.
In der Aufgabe blättert eine Suche durch ihre Treffer, und beide Werte kommen aus der Adresszeile.
Zum Mitnehmen
new URL(…).searchParams liefert die Query-Parameter dekodiert, get den ersten Wert eines Namens und getAll alle. Jeder davon ist Text, bis er geprüft und umgewandelt ist, und ein ungültiger Wert bekommt ein 400.
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.