Benutzerdefinierte Transformer und Codegenerierung
Schreiben Sie Compiler-Transformationen, die den AST verändern.
Benutzerdefinierte Transformer und Codegenerierung ist eine kostenlose TypeScript Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des TypeScript Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Was sind Transformer?
TypeScript-Transformer sind Funktionen, die einen AST-Knoten empfangen und einen möglicherweise geänderten Knoten zurückgeben. Sie werden während der Kompilierung ausgeführt, um eine benutzerdefinierte Ausgabe zu erzeugen.
import ts from "typescript";
type Transformer = ts.TransformerFactory<ts.SourceFile>;Aufbau einer Transformer Factory
Eine Transformer Factory empfängt einen TransformationContext und gibt eine Funktion zurück, die SourceFile-Knoten transformiert.
const myTransformer: ts.TransformerFactory<ts.SourceFile> =
(ctx) => (sf) => {
function visit(node: ts.Node): ts.Node {
// Modify node here
return ts.visitEachChild(node, visit, ctx);
}
return ts.visitNode(sf, visit) as ts.SourceFile;
};Mit Kontext besuchen
ts.visitEachChild (nicht forEachChild) wird innerhalb von Transformern verwendet, weil die Funktion geänderte Knoten korrekt rekonstruiert.
function visit(node: ts.Node): ts.Node {
if (ts.isStringLiteral(node)) {
return ts.factory.createStringLiteral(node.text.toUpperCase());
}
return ts.visitEachChild(node, visit, ctx);
}Neue Knoten mit ts.factory erstellen
Das Objekt ts.factory stellt Methoden zum Erstellen jeder Art von AST-Knoten bereit.
const newCall = ts.factory.createCallExpression(
ts.factory.createIdentifier("console.log"),
undefined,
[ts.factory.createStringLiteral("hello")]
);Transformer auf ein Programm anwenden
Übergeben Sie Transformer an die Option customTransformers von program.emit.
program.emit(undefined, undefined, undefined, false, {
before: [myTransformer],
});Codegenerierung: Knoten ausgeben
Verwenden Sie ts.createPrinter, um AST-Knoten wieder in Quellcodezeichenfolgen umzuwandeln, ohne den vollständigen Compiler auszuführen.
const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
const result = printer.printNode(
ts.EmitHint.Unspecified,
newCall,
sf
);
console.log(result); // console.log("hello")Vollständige Quelldateien generieren
Sie können eine vollständige Quelldatei von Grund auf mit ts.factory.createSourceFile erstellen oder sie aus einer Liste von Anweisungsknoten zusammensetzen.
const statements = [
ts.factory.createExpressionStatement(
ts.factory.createCallExpression(
ts.factory.createIdentifier("console.log"),
undefined,
[ts.factory.createStringLiteral("generated!")]
)
),
];Imports transformieren
Ein häufiger Anwendungsfall ist die Transformation von Importpfaden – beispielsweise das Umschreiben von Aliaspfaden in relative Pfade zum Zeitpunkt der Ausgabe.
if (ts.isImportDeclaration(node)) {
const spec = node.moduleSpecifier as ts.StringLiteral;
if (spec.text.startsWith("@app/")) {
return ts.factory.updateImportDeclaration(
node, node.modifiers, node.importClause,
ts.factory.createStringLiteral(spec.text.replace("@app/", "../")),
node.assertClause
);
}
}Transformer testen
Testen Sie Transformer, indem Sie sie auf eine kleine Quelldatei anwenden und überprüfen, ob die ausgegebene Zeichenfolge der erwarteten Zeichenfolge entspricht.
const result = ts.transpileModule("const x = 'hello';", {
compilerOptions: { target: ts.ScriptTarget.ES2020 },
transformers: { before: [myTransformer] },
});
console.log(result.outputText);Plugin-Systeme
Einige Build-Tools (wie ttypescript / ts-patch) ermöglichen es, Transformer als Plugins in tsconfig zu registrieren, sodass sie im Entwicklungsworkflow transparent bleiben.
// tsconfig.json with ts-patch:
// "plugins": [{ "transform": "./my-transformer.js" }]Zusammenfassung: Benutzerdefinierte Transformer
Mit Transformern können Sie TypeScript-Code während der Kompilierung auf AST-Ebene umschreiben. Verwenden Sie ts.visitEachChild für die rekursive Traversierung, ts.factory zum Erstellen von Knoten und ts.createPrinter zum Generieren von Quelltext.
Schnelltest
Welches Objekt verwenden Sie, um in einem Transformer neue AST-Knoten zu erstellen?
Das haben Sie gelernt
Benutzerdefinierte Transformer ändern den TypeScript-AST zur Kompilierungszeit. Verwenden Sie ts.visitEachChild für die Rekursion, ts.factory zum Erstellen neuer Knoten und program.emit mit customTransformers, um sie anzuwenden.
Häufig gestellte Fragen
Ist die Lektion „Benutzerdefinierte Transformer und Codegenerierung“ kostenlos?
Ja — der vollständige Text von „Benutzerdefinierte Transformer und Codegenerierung“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des TypeScript Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der TypeScript Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Benutzerdefinierte Transformer und Codegenerierung“?
Schreiben Sie Compiler-Transformationen, die den AST verändern. Du übst TypeScript Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um TypeScript Academy zu starten?
Keine Vorkenntnisse erforderlich. TypeScript Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „Benutzerdefinierte Transformer und Codegenerierung“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser TypeScript Academy-Lektion Code schreiben und ausführen?
Ja. Jede TypeScript Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Ein TypeScript-Programm mit der API erstellen
- Den AST mit Visitor-Funktionen durchlaufen
- Benutzerdefinierte Transformer und Codegenerierung
- Ein einfaches Linting-Tool erstellen