Triple-Slash-Direktiven sind einfache JavaScript-Kommentare, nach denen TypeScript sucht, um beispielsweise Compiler-Einstellungen für eine bestimmte Datei anzupassen oder anzuzeigen, dass eine Datei von einer anderen Datei abhängt. Platzieren Sie Ihre Direktiven am Anfang der Datei vor allem anderen Code. Triple-Slash-Direktiven sehen aus wie hier gezeigt (ein dreifacher Schrägstrich ///, gefolgt von einem XML-Tag):
/// <direktive attr='wert' />
TypeScript unterstützt verschiedene Triple-Slash-Direktiven. In Tabelle E-1 finden Sie die am häufigsten verwendeten:
amd-module
Nähere Informationen hierzu finden Sie unter »Die amd-module-Direktive« auf Seite 268.
lib
Anhand der lib-Direktive können Sie TypeScript mitteilen, von welchen TypeScript-Bibliotheken Ihr Modul abhängt. Sie können diese Methode verwenden, falls Ihr Projekt über keine tsconfig.json verfügt. Die Deklaration der benötigten Bibliotheken in Ihrer tsconfig.json sollte gegenüber der lib-Direktive immer die erste Wahl sein.
path
Wenn Sie TSC-Option outFile verwenden, können Sie mithilfe der path-Direktive angeben, dass Ihr Modul von einer andere Datei abhängt. Dadurch erscheint die andere Datei früher in den kompilierten Ausgaben als die davon abhängende Datei. Wenn Ihr Projekt import- und export-Anweisungen verwenden, werden Sie die path-Direktive vermutlich nie brauchen.
types
Ausführliche Informationen zur types-Direktive finden Sie unter »Die types-Direktive« auf Seite 267.
Tabelle E-1: Triple-Slash-Direktiven
Direktive |
Syntax |
Verwendung |
amd-module |
<amd-module name="MyComponent" /> |
Deklaration von Export-Namen bei der Kompilierung zu AMD-Modulen |
lib |
<reference lib="dom" /> |
Deklaration von TypeScript-eigenen Bibliotheken, von denen Ihre Typdeklarationen abhängen |
path |
<reference path="./path.ts" /> |
Deklaration von anderen TypeScript-Dateien, von denen Ihr Modul abhängt |
type |
<reference types="./path.d.ts" /> |
Deklaration darüber, von welchen Typdeklarationsdateien Ihr Modul abhängt. |
Sehr wahrscheinlich werden Sie die no-default-lib-Direktive (Tabelle E-2) nie in Ihrem eigenen Code verwenden.
Tabelle E-2: Interne Triple-Slash-Direktiven
Direktive |
Syntax |
Verwendung |
no-default-lib |
<reference no-default-lib="true" /> |
Weist TypeScript an, keinerlei externe Bibliotheken für diese Datei einzubinden. |
Verwenden Sie auf keinen Fall die amd-dependency-Direktive (Tabelle E-3). Benutzen Sie stattdessen eine reguläre import-Anweisung.
Tabelle E-3: Veraltete Trip-Slash-Direktiven
Direktive |
Syntax |
Verwenden Sie stattdessen |
amd-dependency |
<amd-dependency path="./a.ts" name="MyComponent" /> |
import |