Typer les clés de traduction

Dans une configuration d’internationalisation sûre du point de vue des types, l’ensemble des clés de traduction valides est déduit de votre objet de messages. Une faute de frappe comme t("greetng") devient une erreur de compilation, et non un problème de chaîne manquante à l’exécution.

Commencez par un objet simple de messages. Il constitue l’unique source de vérité pour les valeurs comme pour le type des clés.

Pour un objet plat, keyof typeof fournit l’union des clés.

Les catalogues de messages réels sont imbriqués. Nous voulons des chemins avec points comme "cart.empty", et pas seulement les clés de premier niveau. Nous avons besoin d’un type récursif qui parcourt l’objet.

Un type conditionnel associé à un type mappé construit des chemins avec points en descendant récursivement dans les objets imbriqués et en préfixant les clés. Le préfixe utilise un type littéral de modèle, écrit avec des accents graves dans le code réel sous la forme [backtick]${K}.${Paths<T[K]>}[backtick]. Nous le représentons ci-dessous par JoinPath(K, child) afin de garder la liste claire.

Fournir le type des messages à Paths produit chaque clé valide avec points.

Souvent, vous ne voulez que les chemins des feuilles (les chaînes réelles), en excluant les objets intermédiaires. Adaptez la récursion afin d’ignorer les nœuds qui ne sont pas des chaînes. Le préfixe K-point-enfant utilise lui aussi un type littéral de modèle (délimité par des accents graves dans le code réel), représenté ici par JoinPath.

Limitez le paramètre de la fonction de traduction à l’union de clés dérivée afin que seules les clés valides soient acceptées à la compilation.

Vous pouvez aller plus loin et déduire le type de valeur correspondant à un chemin, ce qui est utile lorsque les messages contiennent des entrées qui ne sont pas des chaînes. Un type conditionnel d’indexation de chemin parcourt les points. Il sépare le chemin à l’aide d’un motif de type littéral de modèle qui, dans le code réel, s’écrit avec des accents graves sous la forme Tête.point.Reste avec infer. Nous représentons cette séparation ci-dessous par SplitHead/SplitRest.

Sans as const, les valeurs de chaîne s’élargissent en string et vous perdez les informations littérales nécessaires par la suite, par exemple pour l’extraction des espaces réservés. Déclarez toujours les catalogues comme constants.

Déduire les clés du catalogue signifie que l’ajout, le renommage ou la suppression d’un message met instantanément à jour le type de clé autorisé partout. Aucun énumérateur central à maintenir, aucune constante de chaîne obsolète.

Confirmez votre compréhension du typage des clés de traduction.

Vous avez déduit une union de clés valides à partir d’un objet messages en utilisant keyof et un type de chemin récursif fondé sur un littéral de modèle. Les variantes limitées aux feuilles excluent les objets intermédiaires, un t typé rejette les clés invalides et as const préserve les informations littérales nécessaires au système de types.