Ergebnis dieses Guides
Ein kleiner Änderungsvorschlag mit überprüfbarem Verhalten
Arbeitsumgebung
TypeScript mit projektbezogener tsconfig und der vorgesehenen JavaScript-Laufzeit
Wann ist diese Entscheidung wichtig?
Qualität zeigt sich daran, wie leicht eine fachliche Änderung verstanden und geprüft werden kann. Zusätzliche Abstraktion ist nicht automatisch hilfreich.
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.
Codequalität: Schritt für Schritt.
- 01
Vorbereiten
Wählen Sie eine schwer verständliche Stelle und notieren Sie ihr beobachtbares Verhalten.
- 02
In TypeScript umsetzen
Trennen Sie Verantwortlichkeiten, benennen Sie fachliche Begriffe und entfernen Sie echte Doppelarbeit. Prüfen Sie danach denselben Nutzerfall.
- 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 neue Variante einer bestehenden fachlichen Regel
- Erwartetes Ergebnis
- Die Änderung betrifft einen klaren Bereich und ihre Wirkung ist durch gezielte Prüfungen belegt.
- Fehler- oder Grenzfall
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
Abnahme und typische Fehler.
- Eine Änderung lässt sich ohne umfangreiche Seiteneffekte umsetzen.
- Eine Umstrukturierung verändert weder Schnittstellen noch Fehlerverhalten unbeabsichtigt.
- Typen werden zur Laufzeit entfernt; externe Daten müssen trotzdem validiert werden.
Typischer Fehler
Abstraktion um ihrer selbst willen macht einfachen Code schwer.
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.
