Tipado de claves de traducción

En una configuración de i18n con seguridad de tipos, el conjunto de claves de traducción válidas se deriva del objeto de mensajes. Un error tipográfico como t("greetng") se convierte en un error de compilación, no en un fallo por falta de cadena durante la ejecución.

Comience con un objeto sencillo de mensajes. Es la única fuente de verdad tanto para los valores como para el tipo de las claves.

Para un objeto plano, keyof typeof proporciona la unión de sus claves.

Los catálogos de mensajes reales están anidados. Queremos rutas separadas por puntos como "cart.empty", no solo claves de nivel superior. Necesitamos un tipo recursivo que recorra el objeto.

Un tipo condicional y mapeado construye rutas separadas por puntos al recorrer recursivamente los objetos anidados y anteponer las claves. El prefijo utiliza un tipo de literal de plantilla, que en el código real se escribe con comillas invertidas como [backtick]${K}.${Paths<T[K]>}[backtick]. A continuación lo mostramos como JoinPath(K, child) para mantener limpio el listado.

Pasar el tipo de messages a Paths produce todas las claves válidas separadas por puntos.

A menudo solo quiere las rutas de hoja (cadenas reales), excluyendo los objetos intermedios. Ajuste la recursión para omitir los nodos que no sean cadenas. El prefijo K-punto-hijo vuelve a utilizar un tipo de literal de plantilla (delimitado por comillas invertidas en el código real), que aquí se muestra como JoinPath.

Restrinja el parámetro de la función de traducción a la unión de claves derivada para que solo se compilen claves válidas.

Puede ir más allá e inferir el tipo de valor de una ruta, lo que resulta útil cuando los mensajes contienen entradas que no son cadenas. Un tipo condicional que indexa una ruta recorre los puntos. Divide la ruta mediante un patrón de literal de plantilla que, en el código real, se escribe con comillas invertidas como la forma Head punto Rest con infer. A continuación representamos esa división como SplitHead/SplitRest.

Sin as const, los valores de cadena se amplían a string y se pierde la información literal necesaria después (por ejemplo, para extraer marcadores de posición). Declare siempre los catálogos como constantes.

Derivar las claves del catálogo significa que añadir, cambiar de nombre o eliminar un mensaje actualiza al instante el tipo de claves permitidas en todas partes. No hay un enum central que mantener ni constantes de cadena obsoletas.

Compruebe su comprensión de la tipificación de claves de traducción.

Derivó una unión de claves válidas a partir de un objeto messages utilizando keyof y un tipo de rutas recursivo de literal de plantilla. Las variantes que solo incluyen hojas excluyen los objetos intermedios, una función t con tipos rechaza las claves no válidas y as const conserva la información literal que necesita la maquinaria de tipos.