TypeScript-Formatierer

TypeScript ist eine Obermenge von JavaScript, aber die typebene Syntax, die es hinzufügt — Interfaces, mit `extends` eingeschränkte Generics, Dekoratoren, `as`-Typ-Assertions, und eigenständige reine Typdeklarationen — hat keine Bedeutung in der Grammatik von reinem JavaScript und lässt einen reinen JavaScript-Parser bei völlig gültigem TypeScript direkt scheitern. Den dedizierten TypeScript-Parser zu nutzen, statt zu versuchen, den von JavaScript zu zwingen, eine Obermenge seiner eigenen Grammatik zu akzeptieren, ist es, was einer mit Generics und Interfaces gefüllten Datei erlaubt, korrekt formatiert zu werden, statt als Syntaxfehler abgelehnt zu werden, sobald sie eine Funktion nutzt, die JavaScript selbst nicht hat.

Eine `.tsx`-Datei, die JSX-Syntax mit TypeScript-Typannotationen kombiniert, ist an einer bestimmten Stelle wirklich mehrdeutig zu analysieren: eine Typ-Assertion mit spitzen Klammern wie `<Foo>value` sieht identisch aus wie der Beginn eines JSX-Element-Tags für einen Parser, dem nicht gesagt wurde, welchen Dialekt er liest. Den TypeScript-mit-JSX-Analysemodus zu wählen löst diese Mehrdeutigkeit korrekt, daher zählt es speziell für Komponentendateien, die beide mischen, den richtigen Dialekt vorher zu wählen, statt anzunehmen, dass ein generischer JavaScript-Parser es lösen wird.

Dekoratoren — die in Angular und manchen auf TypeScript aufgebauten Backend-Frameworks üblichen `@Component`-artigen Annotationen — haben mehrere unterschiedliche Vorschlagsstufen im Standardisierungsprozess der Sprache durchlaufen, und unterschiedliche Codebasen können auf leicht unterschiedliche Versionen dieser Syntax zielen, je nachdem, wann sie geschrieben wurden und welche Compiler-Optionen sie verwenden. Dekorator-Syntax korrekt zu analysieren erfordert speziell den TypeScript-bewussten Parser; ein reiner JavaScript-Parser, der ein `@` vor einer Klasse oder Methode antrifft, hat keine definierte Bedeutung, auf die er zurückgreifen kann, und wird die Datei direkt ablehnen.