React und TypeScript
State an einem Ort ablegen
Jeder Wert sollte genau einen Besitzer haben. Die meisten React-Fehler entstehen, wenn zwei Kopien derselben Tatsache nicht übereinstimmen.
Leite Werte ab, anstatt sie zu speichern. Wenn ein Wert während des Renderings aus Props und State berechnet werden kann, berechne ihn – spiegele ihn nicht in useState, denn die Kopie wird veraltet, sobald sich seine Quelle ändert. const total = items.reduce(...) benötigt keinen State und kann niemals falsch sein.
State, der von einem Prop kopiert wird, ist derselbe Fehler mit einer längeren Zündschnur: Der Anfangswert von useState wird einmal gelesen und danach für immer ignoriert. Wenn die Komponente zurückgesetzt werden muss, wenn sich ein Prop ändert, gib ihr einen key und lass React sie neu mounten.
Hebe State nur so weit hoch, wie der nächste gemeinsame Elternteil, der ihn benötigt. Weiteres Hochheben führt dazu, dass alle Geschwister bei jedem Tastendruck neu rendern.
Effekte
Ein Effekt synchronisiert mit etwas außerhalb von React: einem Abonnement, einem Timer, dem Dokument, einer imperativen Bibliothek. Er ist nicht der Ort, um Werte zu berechnen oder auf einen Klick zu reagieren – dafür ist der Event-Handler zuständig.
Das Abhängigkeitsarray muss alles auflisten, was der Effekt liest. Das Weglassen eines Werts, um eine Schleife zu stoppen, friert ihn auf seinem ersten Wert ein und erzeugt den Stale-Closure-Fehler. Wenn der Effekt eine Schleife verursacht, weil eine Abhängigkeit ein Objekt oder eine Funktion ist, die bei jedem Rendern neu erstellt wird, behebe die Abhängigkeit – useCallback, useMemo, oder verschiebe sie aus der Komponente heraus – anstatt sie aus dem Array zu löschen.
Gib eine Cleanup-Funktion zurück, wann immer der Effekt etwas startet, das ihn überleben kann. Abonnements, Timer und laufende Anfragen müssen alle gestoppt werden, wenn die Komponente unmountet oder sich die Abhängigkeiten ändern, und unter StrictMode in der Entwicklung wird der Effekt zweimal ausgeführt, um genau eine fehlende Bereinigung aufzudecken.
Eine async-Funktion kann kein Effektkörper sein – sie gibt ein Promise zurück, und React erwartet eine Cleanup-Funktion. Deklariere die asynchrone Arbeit im Inneren und rufe sie auf.
Daten abrufen
Bevorzuge die Datenbibliothek des Projekts gegenüber dem manuellen Abrufen in einem Effekt; sie löst bereits Caching, Deduplizierung, Wiederholungsversuche und das Wettrennen, das du gleich schreiben wirst.
Wenn du manuell abrufst, behandle alle vier Zustände – Laden, Leer, Fehler, Erfolg – und brich die Anfrage im Cleanup ab. Zwei in Reihe gestartete Anfragen können immer noch in falscher Reihenfolge aufgelöst werden, also brich entweder die vorherige ab oder ignoriere eine Antwort, die nicht mehr aktuell ist.
Schlucke niemals eine Zurückweisung. Eine nicht behandelte Zurückweisung in einem Handler oder Effekt schlägt stillschweigend fehl, und die UI hört einfach auf, sich zu aktualisieren.
Rendern
Schlüssele Listen mit einer stabilen Identität aus den Daten. Index-Schlüssel sind nur für eine Liste korrekt, die nie neu geordnet, eingefügt oder gelöscht wird; wenn dies geschieht, verwendet React den falschen DOM-Knoten wieder und Eingaben behalten den Wert der vorherigen Zeile.
Greife zu memo, useMemo und useCallback, nachdem du mit dem Profiler gemessen hast. Standardmäßig überall angewendet, fügen sie Allokationen und Abhängigkeitsarrays hinzu, die schiefgehen können, und sie lösen nichts, wenn die eigentliche Kosten ein Elternteil ist, das den gesamten Baum neu rendert.
Rufe niemals einen Hook bedingt, in einer Schleife oder nach einer frühen Rückkehr auf. Die Reihenfolge muss bei jedem Rendern identisch sein.
TypeScript
Behandle any und eine Typ-Assertion als eine ungelöste Frage, nicht als eine Lösung. Beide bringen den Compiler genau an der Stelle zum Schweigen, an der er etwas Nützliches zu sagen hatte. Wenn ein Typ wirklich unbekannt ist, verwende unknown und grenze ihn ein.
Typisiere, was eine Grenze überschreitet: API-Antworten, Formularwerte, URL-Parameter. Daten aus dem Netzwerk sind nicht der Typ, den du deklariert hast, bis etwas sie überprüft – validiere also an der Grenze und lass den Rest der App dem Ergebnis vertrauen.
Überprüfen
Ein grüner Build beweist weniger, als es scheint. Viele Projekte konfigurieren das Framework so, dass Lint- und Typfehler während des Builds ignoriert werden – überprüfe daher die Konfiguration, bevor du den Build als Beweis betrachtest, und führe die Typprüfung und den Linter explizit aus.
Dann verwende die Komponente: den leeren Zustand, den Fehlerzustand, ein langsames Netzwerk und eine zweite schnelle Interaktion, bevor die erste abgeschlossen ist.