Seminar TypeScript Professional – Backend-Entwicklung mit Node.js und REST-APIs

Ein erfolgreicher Build belegt noch nicht, dass ein API-Endpunkt mit ungültigen Eingaben, ausgefallenen Diensten oder konkurrierenden Anfragen korrekt umgeht. Das Seminar führt die statischen Möglichkeiten von TypeScript mit den Anforderungen eines Node.js-Backends zusammen. Aus einem vorbereiteten Gerüst entsteht eine kleine, fachlich abgegrenzte REST-API mit validierten Eingaben und überprüfbaren Antwortverträgen.

Ein leichtgewichtiges HTTP-Framework wie Fastify dient als Übungsrahmen. Im Vordergrund stehen übertragbare Konzepte: passende Moduleinstellungen, kontrollierte asynchrone Abläufe, Laufzeitschemata, Persistenzadapter und Integrationstests. Die Übungen untersuchen ausdrücklich, welche Fehler der Compiler findet und welche erst durch Validierung, Tests oder Betriebsbeobachtung sichtbar werden.

Lernziele

• Ein Node.js-Projekt mit konsistentem Modul- und Buildmodell konfigurieren.
• Requests, Antworten und fachliche Fehlersituationen nachvollziehbar modellieren.
• Externe Daten vor der fachlichen Verarbeitung zur Laufzeit validieren.
• Asynchrone Ressourcen und Datenzugriffe kontrolliert verwenden.
• API-Verhalten durch reproduzierbare Integrations- und Negativtests prüfen.

Zielgruppe

Backend- und Fullstack-Entwickler mit JavaScript- und TypeScript-Erfahrung sowie Entwickler bestehender Node.js-Dienste.

Voraussetzungen

Sichere TypeScript-Grundlagen, Funktionen, Interfaces, Union Types, Generics und ES-Module; Grundwissen zu HTTP, JSON und Promises. Architekturkenntnisse sind hilfreich.

Inhaltsübersicht

1. Projekt, Module und Ausführung
2. HTTP-Verträge und Validierung
3. Asynchronität und Fehlerbehandlung
4. Persistenz und Geschäftslogik
5. Tests und Diagnose
6. API-Projekt und Bereitstellungsprüfung

Seminarinhalte

Projekt, Module und Ausführung

• Node.js-Laufzeit, TypeScript-Compiler und Editor auf abgestimmte Projektversionen festlegen.
• ESM, package.json, Dateiendungen und dazu passende TypeScript-Moduleinstellungen verbinden.
• Build nach JavaScript, Entwicklungsrunner und natives Type Stripping unterscheiden.
• Unabhängige Typprüfung einrichten; fehlende Prüfung und nicht ausgewertete tsconfig beim Type Stripping berücksichtigen.

HTTP-Verträge und Validierung

• Routen, Parameter, Query-Daten und Antwortobjekte für eine begrenzte Fachdomäne entwerfen.
• JSON zunächst als unbekannte Eingabe behandeln und mit Laufzeitschemata prüfen.
• Pflichtfelder, Grenzen, unbekannte Eigenschaften und fachliche Validierung unterscheiden.
• Dokumentierbare Fehlerantworten und eine stabile Fehlerstruktur definieren.

Asynchronität und Fehlerbehandlung

• Promises, async/await und Fehlerweitergabe an HTTP-Grenzen sicher einsetzen.
• Parallele und sequentielle Verarbeitung anhand von Abhängigkeiten auswählen.
• Zeitbegrenzung und Abbruch mit unterstützten AbortSignal-Schnittstellen umsetzen.
• Unbehandelte Promise-Rejections, doppelte Antworten und verlorene Fehler vermeiden.

Persistenz und Geschäftslogik

• Datenzugriff hinter einem typisierten Repository-Vertrag kapseln.
• Vorbereiteten SQL-Datenzugriff mit Parametrisierung und definierten Transaktionsgrenzen verwenden.
• Datenbankrepräsentation, fachliches Modell und API-Datentransferobjekte unterscheiden.
• Fehlende Datensätze, Konflikte und wiederholte Requests nachvollziehbar behandeln.

Tests und Diagnose

• HTTP-Endpunkte mit isolierten Testdaten und kontrolliertem Test-Lebenszyklus prüfen.
• Ungültige Eingaben, Dienstfehler und Persistenzkonflikte als Negativfälle abdecken.
• Strukturierte Protokollierung mit Korrelationskennung und ohne vertrauliche Nutzdaten vorbereiten.
• Gesundheitsprüfung, kontrolliertes Herunterfahren und Ressourcenfreigabe implementieren.

API-Projekt und Bereitstellungsprüfung

• Eine zusätzliche Route vom Eingabeschema bis zum Persistenzadapter implementieren.
• Typprüfung, Linting, Tests und Build als getrennte Prüfschritte ausführen.
• Konfiguration beim Start validieren und fehlende Werte verständlich melden.
• Das erzeugte JavaScript in einer bereinigten Laufzeitumgebung starten und Endpunkte prüfen.

Praxisprojekt

Die praktische Arbeit folgt einer zusammenhängenden Aufgabenstellung. Die folgenden Schritte werden anhand vorbereiteter Ausgangsstände umgesetzt und mit überprüfbaren Zwischenständen verbunden.

1. Das API-Gerüst starten und einen absichtlich fehlerhaften Build- oder Modulpfad diagnostizieren.
2. Einen Buchungsendpunkt einschließlich Laufzeitschema und fachlichem Fehlervertrag anlegen.
3. Den vorbereiteten Datenzugriff anbinden und Konflikte in definierte HTTP-Antworten übersetzen.
4. Einen externen Testdienst mit Zeitbegrenzung und kontrolliertem Abbruch integrieren.
5. Erfolg, Fehleingaben und Störungen mit automatisierten HTTP-Tests prüfen.
6. Den Produktionsbuild ohne Entwicklungsrunner starten und eine Anfragefolge vollständig nachvollziehen.

Schulungsumgebung

Abgestimmte stabile TypeScript-Version, unterstützte Node.js-LTS-Version, vorbereitetes Fastify-Projekt, Laufzeitschemata und lokale Testdatenbank. Die Einrichtung der Schulungsumgebung erfolgt vor Seminarbeginn.

Die Schulungsumgebung wird vom Kunden nach der vorab abgestimmten technischen Checkliste bereitgestellt. Benötigte Installationsrechte, Werkzeuge und Übungsstände werden vor Seminarbeginn geprüft.