TypeScript
Übersetze Literalwerte in Sprachmodulen mit statischem Standardexport und behalte dabei die umgebende TypeScript-Syntax bei.
Mit einem TypeScript-Sprachmodul bleiben Meldungen nah an den Typen, die sie beschreiben. Der Dateihandler typescript übersetzt Literalwerte in einem statischen Standardexport und ersetzt den Text direkt an Ort und Stelle. Schlüssel, Importe, Kommentare und die umgebende Typsyntax bleiben dabei erhalten. Er liest den Quelltext, ohne das Modul auszuführen.
Stelle dem Handler einen statischen Katalog bereit #
Verwende ein Inline-Objekt oder ein Inline-Array als Standardexport:
export default {
checkout: {
title: "Complete your order",
retries: 3,
},
steps: ["Review", "Confirm"],
} as const;Als Zeichenfolgeneinheiten werden checkout.title, steps[0] und steps[1] erfasst. Der numerische Wert bleibt unverändert. as const, satisfies und Klammern um unterstützte Ausdrücke können im Quelltext stehen bleiben.
Gib übersetzbare Werte als Literale an. Der Handler folgt einem exportierten Bezeichner nicht zu seiner Deklaration und wertet keine Factory-Aufrufe aus. Er überspringt berechnete Eigenschaftsschlüssel, Spread-Elemente, Methoden und Werte, die durch Ausdrücke erzeugt werden. Template-Literale werden nur ohne interpolierte Ausdrücke unterstützt. Wenn ein gültiges Modul keine Übersetzungsaufgaben erzeugt, sieh dir zuerst die Struktur des Standardexports an, bevor du nach einem Übersetzungsfehler suchst.
Behalte akzeptierte Werte gezielt bei #
Änderungen werden anhand der vorherigen Quelle für jeden Katalogpfad ermittelt. Die vorhandene Zieldatei liefert akzeptierte Werte für unveränderte Zeichenfolgen und solche, die sich anderweitig nicht auflösen lassen. Bei gesperrten Pfaden bleibt das aktuelle Quellliteral erhalten; bei als beizubehalten markierten Pfaden bleibt der vorhandene Zielwert erhalten, sofern verfügbar. Diese Steuerungsmechanismen führen keinen Code aus, um weitere Texte zu ermitteln.
Beim Ersetzen werden dieselben Anführungszeichen wie im Quellliteral verwendet und die übersetzten Inhalte entsprechend maskiert. Bei einer Aktualisierung der Schlüssel bleiben nicht ausgewählte Zielwerte erhalten. Quelleinträge, die in diesem Teilergebnis fehlen, können entfernt werden – auch Array-Elemente. Sieh dir deshalb die resultierenden Schlüssel und die enthaltenen Array-Elemente an, bevor du das Modul lädst.
Konfiguriere die Dateiauswahl #
Die CLI leitet typescript für .ts, .mts und .cts ab, nicht jedoch für .js oder .tsx. Wähle Sprachmodule über die CLI-Konfiguration oder GitHub aus.
Lade das übersetzte Modul #
Dieses Format ist unabhängig von der Extraktion von React-Meldungen. Die Extraktion liest unterstützte Aufrufe im .ts- und .tsx-Quelltext der Anwendung, um einen Katalog zu erstellen. Dieser Handler hingegen übersetzt ein bereits strukturiertes Sprachmodul. Mehr zu diesem Ablauf findest du unter React-Kataloge und -Typen.
Führe nach dem Abruf eine Typprüfung des Moduls durch und lade es über den Kataloglader der Anwendung. Vergleiche die ausgewählten Schlüssel mit den Meldungen, die in der Ansicht verwendet werden, und teste anschließend die Platzhalter. Diese Kontrollen decken unterschiedliche Probleme auf: Ein ungültiges Modul lässt sich nicht laden, ein nicht ausgewählter dynamischer Wert bleibt unübersetzt, und eine gültige Übersetzung kann dennoch die falsche Bedeutung vermitteln.