Ergebnis dieses Guides
Eine kleine öffentliche Schnittstelle
Arbeitsumgebung
TypeScript mit projektbezogener tsconfig und der vorgesehenen JavaScript-Laufzeit
Wann ist diese Entscheidung wichtig?
Module begrenzen Zuständigkeiten und Abhängigkeiten. Ihre öffentliche Schnittstelle sollte kleiner sein als ihre interne Umsetzung.
Beschreiben Sie interne Verträge möglichst genau und halten Sie unbekannte externe Werte zunächst als unknown. Eine Typbehauptung prüft keine Netzwerkantwort. Die fertige Ausgabe läuft weiterhin unter den Regeln der gewählten JavaScript-Umgebung.
Module: Schritt für Schritt.
- 01
Vorbereiten
Listen Sie benötigte Exporte und deren Verbraucher auf. Trennen Sie Bibliothekslogik von ausführbarem Startcode.
- 02
In TypeScript umsetzen
Importieren Sie nur die ausdrücklich freigegebenen Funktionen. Vermeiden Sie Kreisabhängigkeiten und Seiteneffekte beim Laden eines Moduls.
- 03
Im tatsächlichen Projekt prüfen
Prüfen Sie sowohl die Typen mit dem Projektcompiler als auch das tatsächliche Laufzeitverhalten. Ein erfolgreicher Typcheck ersetzt keine Eingabeprüfung und keinen Berechtigungstest.
Beispiel zur Überprüfung
So lässt sich das Ergebnis prüfen.
Als Projektkontext dient eine Webanwendung mit mehreren Formularen und API-Antworten. Der folgende Prüffall ist eine Vorlage für diese Aufgabe und kein Bericht über eine Kundenmessung.
- Eingabe / Auslöser
- Eine Funktion wird aus einem zweiten Modul aufgerufen
- Erwartetes Ergebnis
- Der Import funktioniert mit der vorgesehenen Laufzeit und dem Projekt-Build.
- Fehler- oder Grenzfall
- Ein bloßer Import öffnet keine Datenbankverbindung und startet keine unerwartete Hintergrundarbeit.
Abnahme und typische Fehler.
- Eine Änderung hat einen überschaubaren Wirkungsbereich.
- Ein bloßer Import öffnet keine Datenbankverbindung und startet keine unerwartete Hintergrundarbeit.
- Typen werden zur Laufzeit entfernt; externe Daten müssen trotzdem validiert werden.
Typischer Fehler
Zirkuläre Importe und riesige Sammelmodule verwischen Grenzen.
Quellen und Versionshinweis
Die Anleitung beschreibt das Vorgehen; konkrete APIs, Produktfunktionen und Laufzeitgrenzen müssen zur eingesetzten Version passen. Halten Sie Version, Konfiguration und Prüfergebnis im Projekt fest und vergleichen Sie die verlinkte Dokumentation bei Änderungen.
