mitmario.dev

Was jetzt?

Node.js Sandbox 4 Min Lesezeit 2 BeispieleLektion 6 von 7

Nach einem Kurs wie diesem kommen die Empfehlungen von allen Seiten, und jede klingt dringend. Welche davon du als Nächstes brauchst und welche nur laut ist, hängt an einem Moment, den man erkennen kann. Der steht hier bei jedem Punkt dabei.

Die beiden Beispiele sind zum Lesen da. Ausführen lassen sie sich hier nicht, denn beide bräuchten eine Werkzeugkette, die dieser Kurs bewusst nicht aufbaut. Du siehst trotzdem schon, was sich damit ändern würde, bevor du dir die Werkzeuge holst.

Zuerst TypeScript

Dieselbe Funktion, einmal mit Typen
export function rabatt(preis: number, prozent: number): number {
  // Die beiden Pruefungen bleiben. Typen gelten beim Uebersetzen, und
  // ein JSON aus einer Anfrage ist zur Laufzeit trotzdem alles Moegliche.
  if (!Number.isFinite(preis) || preis < 0) {
    throw new TypeError("preis muss eine Zahl ab 0 sein");
  }

  if (!Number.isInteger(prozent) || prozent < 0 || prozent > 100) {
    throw new RangeError("prozent muss zwischen 0 und 100 liegen");
  }

  return Math.round(preis * (100 - prozent)) / 100;
}

// rabatt("20", 10) laesst sich jetzt gar nicht mehr uebersetzen:
// Argument of type 'string' is not assignable to parameter of type 'number'.

Von allem, was hier steht, bringt TypeScript am meisten. Es ist JavaScript mit Angaben darüber, was wo hineingehört, und ein Übersetzer, der prüft, ob das stimmt. Fehler verschwinden dadurch nicht, sie fallen nur früher auf, beim Tippen statt im Betrieb.

Vor diesem Kurs wären es zwei Dinge auf einmal gewesen, und bei jedem Problem bliebe offen, ob es an Node liegt oder an den Typen. Jetzt ist TypeScript eine Schicht über etwas Bekanntem statt ein zweites Rätsel.

Typen gelten beim Übersetzen und nicht zur Laufzeit. Ein JSON aus einer Anfrage ist weiterhin alles Mögliche, und die Eingabeprüfung an der Systemgrenze aus Abschnitt 15 bleibt da, wo sie ist. TypeScript ersetzt sie nicht, es beschreibt nur, was danach gilt.

Du brauchst es, sobald du eine Datei nach zwei Wochen wieder aufmachst und erst im Code nachsehen musst, was eine Funktion eigentlich zurückgibt.

Danach ein Datenbankwerkzeug

Derselbe Zugriff, einmal mit Werkzeug
import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";

// Der eigentliche Gewinn steht hier: Die Tabelle ist einmal
// beschrieben, und ab jetzt kennt dein Editor die Spaltennamen.
// Ein Tippfehler in "titel" faellt beim Schreiben auf statt zur Laufzeit.
export const buecher = sqliteTable("buecher", {
  id: integer("id").primaryKey(),
  titel: text("titel").notNull(),
  jahr: integer("jahr"),
});

Werkzeuge wie Drizzle oder Prisma bauen Abfragen aus Bausteinen statt aus Text und kennen dabei deine Tabellen. Der Editor schlägt dann Spaltennamen vor, und Änderungen am Schema bekommen einen geordneten Weg.

Was die Abfrage tut, entscheidest weiterhin du. Ein Werkzeug, dessen SQL du nicht lesen kannst, steht zwischen dir und dem Problem. Deshalb war SQL zuerst dran und nicht danach. Wer Abschnitt 12 verstanden hat, kann ein solches Werkzeug in einem Nachmittag benutzen. Andersherum funktioniert es nicht.

Du brauchst es, sobald dein Projekt mehr als eine Handvoll Tabellen hat und du anfängst, Änderungen am Schema von Hand nachzuziehen.

Vier weitere, kurz und mit dem Moment dazu

Ein Framework mit mehr Meinung, etwa Fastify oder Nest. Express lässt dir alles offen. Für diesen Kurs war das richtig, denn so hast du jede Entscheidung selbst getroffen. Ein Framework mit mehr Meinung nimmt dir Entscheidungen ab und gibt dir dafür Struktur und Validierung als Standard. Du brauchst es, sobald ihr zu dritt an derselben Anwendung baut und jeder die Fehlerbehandlung anders löst.

Container, etwa mit Docker. Immer dieselbe Umgebung, überall. Das lösen sie und sonst nichts, wie in „Vom Rechner ins Netz“ beschrieben. Du brauchst sie, sobald du zum zweiten Mal einen Fehler suchst, der sich mit „bei mir geht es“ beschreiben lässt.

Warteschlangen und Hintergrundarbeit, etwa mit BullMQ. Manche Arbeit dauert länger, als eine HTTP-Anfrage warten darf, etwa ein Bild umrechnen oder hundert E-Mails verschicken. Statt den Aufrufer warten zu lassen, legst du einen Auftrag in eine Warteschlange und antwortest sofort mit 202. Du brauchst sie, sobald eine Route regelmäßig über zwei Sekunden läuft und du anfängst, an Zeitgrenzen zu drehen.

WebSockets oder Server-Sent Events. Bei HTTP fragt der Aufrufer, und der Server antwortet. Soll der Server von sich aus etwas schicken, reicht das nicht. Dann braucht es eine Verbindung, die offen bleibt. Du brauchst sie, sobald du überlegst, ob der Browser alle zwei Sekunden nachfragen soll. Für den einfachen Fall reichen Server-Sent Events, und die sind deutlich weniger Arbeit.

Ein eigenes Projekt

Nichts davon lernt sich aus einer Liste. Was hilft, ist ein eigenes Projekt, das dich interessiert, und zwar ein kleines. Du hast in diesem Kurs jeden Baustein einmal von Hand gebaut, und deshalb kannst du jetzt entscheiden, welchen du dir abnehmen lässt. Für dein eigenes Projekt gibt es vorher keine Prüfliste, und deshalb hat diese Lektion keine Aufgabe.

Die Ausleihverwaltung ist so ein Anfang, wenn dich Bücher interessieren. Ihr fehlt die Rückgabe, eine Route mit einem UPDATE, das zurueck_am setzt. Ihr fehlen Tests. Mein erster Schritt wäre eine bibliothek.test.js mit fünf Fällen, alle ohne Server wie in Abschnitt 17, also mit dem Normalfall, dem unbekannten Buch, dem verliehenen Buch, der leeren Suche und der Suche mit Treffern. Und Port und Datenbankpfad könnten aus einer konfig.js kommen, so wie in der Lektion zur Konfiguration.

Wenn dich Bücher nicht interessieren, gehen andere Anfänge genauso gut mit dem, was du im Kurs gebaut hast:

  • Ein Werkzeug für einen Ordner, der dich nervt, etwa eins, das die Dateien darin zählt oder umbenennt. Dateien und Ordner kommen aus Abschnitt 3, Argumente, Exit-Code und Fehlerkanal aus Abschnitt 4.
  • Eine kleine JSON-API über etwas, das du sammelst, Schallplatten oder Rezepte. Express und Middleware kommen aus Abschnitt 9 und 10, die Form der Antworten aus Abschnitt 11 und die Tabellen aus Abschnitt 12.
  • Eine Seite mit Anmeldung für zwei Leute, etwa eine gemeinsame Einkaufsliste. Formulare und Sitzungen kommen aus Abschnitt 13, die Anmeldung aus Abschnitt 14 und die Absicherung aus Abschnitt 15.

Laufen soll so etwas auf deinem eigenen Rechner und nicht in der Sandbox. Wie du ihn dafür einrichtest, steht in der Lektion „Node auf deinem Rechner“ in Abschnitt 4.

Danach kommt noch der Test zu diesem Abschnitt, und dann hast du Node durch.

Zum Mitnehmen

TypeScript zuerst, danach ein Datenbankwerkzeug, alles Weitere erst, wenn das Problem dazu auftaucht. Gelernt wird das an einem eigenen kleinen Projekt, und die Ausleihverwaltung ist schon ein Anfang, dem noch die Rückgabe und die Tests fehlen.

Jetzt du

Basis Konto, kostenlos

Im Editor änderst du die Beispiele dieser Lektion und lässt sie gleich laufen. So merkst du am schnellsten, ob es sitzt.

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 2 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.