Das TypeScript-Team hat mit dem Release 6.0 ein neues Compiler-Flag veröffentlicht – --noPropertyAccessFromIndexSignature. Wenn es aktiviert ist, verweigert der Compiler den Zugriff auf Eigenschaften über die Punkt-Notation, die aus einer Index-Signatur stammen. Dies zwingt Entwickler dazu, die Klammer-Notation zu verwenden, wodurch potenzielle undefined-Werte bereits zur Kompilierzeit statt erst in der Produktion sichtbar werden.

Warum das Flag wichtig ist

In JavaScript dienen Objekte oft als Dictionaries, und TypeScript ermöglicht es Ihnen, solche Strukturen mit einer Index-Signatur zu typisieren, z. B. Record<string, T>. Die Sprache behandelt obj.key und obj["key"] als austauschbar, sodass der Compiler davon ausgeht, dass die Eigenschaft existiert, selbst wenn der Schlüssel erst zur Laufzeit bekannt ist. Diese stille Annahme ist die Ursache für viele Abstürze: Code, der auf obj.missingProp zugreift, kompiliert problemlos, wird ausgeführt und wirft dann einen Fehler, weil der Wert undefined ist.

Die Punkt-Notation beinhaltet eine implizite Garantie – sie signalisiert Lesern und dem Type-Checker, dass die Eigenschaft definitiv vorhanden ist. Die Klammer-Notation hingegen signalisiert Unsicherheit – der Schlüssel könnte fehlen, und das Ergebnis könnte undefined sein. --noPropertyAccessFromIndexSignature erzwingt diese visuelle und semantische Unterscheidung und wandelt eine ganze Klasse von Laufzeitfehlern in Diagnosemeldungen zur Kompilierzeit um.

So funktioniert das Flag

Wenn das Flag aktiviert ist, wird jeder Ausdruck, der über die Punkt-Notation auf eine Eigenschaft über eine Index-Signatur zugreift, als Fehler markiert. Der Code muss so umgeschrieben werden, dass Klammern verwendet werden:

// Before
const name = userData.name;          // OK even if "name" is not in the index

// After enabling the flag
const name = userData["name"];       // Error unless brackets are used

Der Compiler wendet dann dieselben Regeln für den Umgang mit undefined an, die er bereits für den Zugriff mittels Klammern verwendet. Wenn auch --noUncheckedIndexedAccess aktiviert ist, wird der Typ von userData["name"] zu T | undefined, was den Entwickler dazu zwingt, den Fall des Fehlens zu prüfen.

Praktische Migrationsschritte

  1. Aktivieren Sie das Flag in der tsconfig.json:

    {
  "compilerOptions": {
    "noPropertyAccessFromIndexSignature": true
  }
}

  2. Führen Sie den Type-Checker aus. Alle Zugriffe auf Index-Signatur-Schlüssel mittels Punkt-Notation werden als Fehler angezeigt.

  3. Ersetzen Sie Punkte durch Klammern. Die Änderung ist rein mechanisch und hat keinen Einfluss auf die Laufzeitperformance.

  4. Behandeln Sie die resultierenden undefined-Typen. Fügen Sie bei Bedarf Nullish Coalescing, Optional Chaining oder explizite Prüfungen hinzu.

  5. Kombinieren Sie es nach Möglichkeit mit --noUncheckedIndexedAccess für das bestmögliche Sicherheitsnetz. Zusammen stellen sie sicher, dass jeder Zugriff im Dictionary-Stil als potenziell fehlend behandelt wird.

Wann explizite Eigenschaften beibehalten werden sollten

Wenn ein Feld Teil eines stabilen API-Vertrags ist, deklarieren Sie es als explizite Eigenschaft, anstatt sich auf eine Index-Signatur zu verlassen. Explizite Eigenschaften erlauben weiterhin die Punkt-Notation und bewahren die Garantie, dass das Feld immer vorhanden sein wird (soweit das Typsystem dies verifizieren kann). Reservieren Sie Index-Signaturen für wirklich dynamische Daten, bei denen die Schlüssel nicht im Voraus bekannt sind.

Gegenargument: erhöhte Ausführlichkeit

Einige Teams empfinden die zusätzlichen Klammern möglicherweise als störend, insbesondere in Codebasen, die stark auf flexible Objekte setzen. Das Flag erzwingt eine strengere Disziplin, die bei Legacy-Projekten umfangreiche Refactorings erfordern kann. In solchen Fällen kann das Flag schrittweise eingeführt werden, beispielsweise begrenzt auf neue Module, während die restliche Codebasis das Muster im Laufe der Zeit übernimmt.

Worauf man als Nächstes achten sollte

Das Flag ist Teil eines umfassenderen Bestrebens in TypeScript 6.0 hin zu einer strengeren Typsicherheit. Zukünftige Releases könnten zusätzliche Prüfungen für Object Spread, Optional Chaining oder die Verwendung von abgeleitetem any einführen. Ein Auge auf die TypeScript-Roadmap zu halten, hilft Teams zu entscheiden, wann sie den nächsten Satz an Sicherheitsfunktionen übernehmen können, ohne die Lieferpläne zu gefährden.

Fazit: Die Aktivierung von --noPropertyAccessFromIndexSignature macht die Unterscheidung zwischen „diese Eigenschaft ist garantiert vorhanden“ und „diese Eigenschaft könnte fehlen“ im Code explizit und fängt so eine ganze Klasse von Fehlern ab, bevor sie in die Produktion gelangen. Einen stillen Laufzeitfehler in einen Kompilierfehler umzuwandeln, ist eine kleine Änderung mit einer überproportional großen Auswirkung auf die Zuverlässigkeit.