Seminar TypeScript Professional – Migration von JavaScript und Compiler-Upgrades

Bestehende Anwendungen lassen sich selten vollständig neu schreiben. Das Seminar vermittelt deshalb ein Vorgehen, bei dem fachliche Änderungen und Typisierung in überschaubaren Schritten erfolgen. Zuerst werden Verhalten, Abhängigkeiten und Risiken erfasst. Danach wird ein funktionsfähiger Mischbetrieb aufgebaut, in dem der Anteil überprüfbaren Codes gezielt wächst.

Ein zweiter Schwerpunkt ist der Wechsel zwischen Compilerständen. Besonders beim Übergang auf den nativen TypeScript-Compiler müssen Kommandozeilenprüfung, Editor und Werkzeuge mit Compiler-API-Abhängigkeit gemeinsam betrachtet werden. Versionen und Kompatibilitätsgrenzen werden im vorbereiteten Projekt festgehalten. Eine Migration gilt erst dann als erfolgreich, wenn Build, Laufzeitverhalten und Entwicklungswerkzeuge wieder überprüfbar zusammenarbeiten.

Lernziele

• Eine Migration nach fachlichen Grenzen, Risiken und überprüfbaren Zwischenschritten planen.
• JSDoc, allowJs und checkJs gezielt für einen kontrollierten Mischbetrieb einsetzen.
• Unsichere Stellen an ihren Ursachen korrigieren und strenge Prüfungen schrittweise etablieren.
• Compiler-, Editor- und Werkzeugkompatibilität vor einem Upgrade prüfen.
• Eine Pilotmigration anhand von Verhaltenstests, Typdiagnosen und Rückfalloptionen bewerten.

Zielgruppe

Entwickler und technische Teamleiter bestehender JavaScript- oder TypeScript-Anwendungen sowie Verantwortliche für Build- und Entwicklungswerkzeuge.

Voraussetzungen

Praktische Erfahrung mit JavaScript, sichere TypeScript-Grundlagen sowie Umgang mit Git, npm, ES-Modulen und Tests. Für Compiler-Upgrades wird grundlegendes Verständnis von tsconfig vorausgesetzt.

Inhaltsübersicht

1. Bestandsaufnahme und Migrationsschnitt
2. JavaScript prüfen und Mischbetrieb aufbauen
3. Modelle statt Fehlerunterdrückung
4. Strikte Prüfungen und Modulmodernisierung
5. Compilerwechsel und Werkzeugkompatibilität
6. Pilotmigration und Freigabekriterien

Seminarinhalte

Bestandsaufnahme und Migrationsschnitt

• Einstiegspunkte, Module, Bibliotheken und Buildschritte des Beispielprojekts erfassen.
• Dynamische Datenzugriffe, globale Zustände und fehlende Verträge als Risiken markieren.
• Charakterisierungstests zur Sicherung des vorhandenen Verhaltens ergänzen.
• Ein Pilotmodul mit überschaubaren Abhängigkeiten und messbaren Abnahmekriterien auswählen.

JavaScript prüfen und Mischbetrieb aufbauen

• JSDoc-Typen, allowJs und checkJs nach ihren jeweiligen Aufgaben einsetzen.
• Ein- und Ausgabepfade trennen und versehentliches Überschreiben von Quelldateien verhindern.
• JavaScript- und TypeScript-Module gemeinsam bauen und im vorgesehenen Laufzeitmodell prüfen.
• Fehlende Bibliothekstypen mit begrenzten Deklarationen ergänzen.

Modelle statt Fehlerunterdrückung

• Unsichere Objektzugriffe, optionale Werte und implizite Annahmen systematisch bearbeiten.
• any durch bekannte Modelle oder unknown mit anschließender Prüfung ersetzen.
• Fehlerunterdrückungen erfassen, begründen und mit einem konkreten Abbaupfad versehen.
• Fachliche Zustandsmodelle und Fehlerverträge als stabile Migrationsgrenzen nutzen.

Strikte Prüfungen und Modulmodernisierung

• strict-Optionen und zusätzliche Prüfungen anhand des Projektbestands bewerten.
• noUncheckedIndexedAccess und exactOptionalPropertyTypes anhand konkreter Fehlerbilder erproben.
• ESM- und CommonJS-Annahmen sowie dazu passende Modulauflösung überprüfen.
• Buildkonfiguration und Laufzeitimporte gemeinsam ändern und separat kontrollieren.

Compilerwechsel und Werkzeugkompatibilität

• Ausgangs- und Zielversion einschließlich Editor-Integration und Lockfile festhalten.
• Neue oder entfallene Optionen sowie veränderte Diagnosen systematisch vergleichen.
• Beim Wechsel auf TypeScript 7.0 dessen fehlende programmatische Compiler-API berücksichtigen.
• Werkzeuge mit API-Abhängigkeit über eine geprüfte kompatible Toolchain weiterbetreiben und beide Prüfläufe unterscheiden.

Pilotmigration und Freigabekriterien

• Ein ausgewähltes Modul vollständig typisieren und an den Mischbestand anbinden.
• Verhaltens-, Integrations- und Typprüfungen vor und nach dem Wechsel vergleichen.
• Verbleibende Ausnahmen, Versionsbindungen und technische Folgearbeiten dokumentieren.
• Einen Rückfallpunkt sowie Kriterien für die nächste Migrationsetappe festlegen.

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. Den vorbereiteten Mischbestand ausführen und eine unveränderte Prüfbasis festhalten.
2. Ein fachliches Modul auswählen und sein bisheriges Verhalten durch Tests sichern.
3. JSDoc-Prüfung aktivieren, anschließend das Modul nach TypeScript überführen und seine Schnittstellen modellieren.
4. Strengere Prüfungen schrittweise einschalten und die entstehenden Fehler fachlich korrigieren.
5. Den vorbereiteten Compilerwechsel einschließlich der angrenzenden Werkzeuge vergleichen.
6. Abnahmekriterien, verbleibende Ausnahmen und den nächsten Migrationsschritt im Projekt festhalten.

Schulungsumgebung

Vorbereiteter JavaScript-/TypeScript-Mischbestand mit Tests und zwei abgestimmten Compilerkonfigurationen. Die Schulungsumgebung enthält benötigte Kompatibilitätswerkzeuge; produktiver Kundencode ist nicht erforderlich.

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