Prueba los mensajes de React
Prueba el texto traducido, los valores, el texto de origen como alternativa, los elementos enriquecidos y la dirección con catálogos locales deterministas.
Puedes probar la renderización de mensajes sin solicitar una traducción. Proporciona un catálogo conocido, renderiza el componente y comprueba el comportamiento del que depende la experiencia de lectura. Una traducción fija permite reproducir problemas como una clave que no coincide, un valor que falta o un enlace roto.
Prueba la traducción y el texto de origen como alternativa #
Este caso de prueba de React 19 comprueba ambos resultados con el mismo componente:
import assert from "node:assert/strict";
import { renderToStaticMarkup } from "react-dom/server";
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
function Greeting() {
const l = useLingo();
return <h1>{l.text("Hello, {name}.", {
context: "Greeting on the account dashboard",
values: { name: "Ana" },
})}</h1>;
}
const key = computeKey("Hello, {name}.", "Greeting on the account dashboard");
const translated = renderToStaticMarkup(
<LingoProvider locale="es" messages={{ [key]: "Hola, {name}." }}>
<Greeting />
</LingoProvider>,
);
assert.equal(translated, "<h1>Hola, Ana.</h1>");
const fallback = renderToStaticMarkup(
<LingoProvider locale="es" messages={{}}><Greeting /></LingoProvider>,
);
assert.equal(fallback, "<h1>Hello, Ana.</h1>");Ejecuta este caso con el ejecutor de pruebas compatible con TSX que ya utiliza el proyecto. Añade una entrada con una cadena vacía y un contexto deliberadamente distinto como casos independientes; ambos deberían usar el texto de origen. Incluye un caso en el que falte un valor simple para detectar si se muestra un marcador de posición, en lugar de dar por hecho que una declaración generada garantiza todos los valores de entrada en tiempo de ejecución.
Usa las funciones auxiliares configuradas en inglés para probar el texto de origen #
El punto de entrada independiente para pruebas ofrece un envoltorio más breve cuando la prueba solo necesita el texto de origen:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Este caso da continuidad al ejemplo de Greeting. renderStatic(node: ReactNode): string envuelve el nodo en un proveedor en inglés sin mensajes y devuelve marcado estático. withLingo(node: ReactNode): ReactNode devuelve ese envoltorio para que lo uses con tu propio renderizador. Ninguna de las dos funciones auxiliares acepta opciones de idioma ni de catálogo; usa un proveedor explícito para las pruebas con traducciones o RTL.
Comprueba el elemento que crea un mensaje enriquecido #
import { createLingo } from "@lingo.dev/react";
const l = createLingo("en");
const notice = l.rich("Read the <link>refund policy</link>.", {
context: "Purchase notice linking to the refund policy",
tags: { link: (children) => <a href="/refund-policy">{children}</a> },
});
const noticeMarkup = renderToStaticMarkup(<p>{notice}</p>);
assert.equal(noticeMarkup, '<p>Read the <a href="/refund-policy">refund policy</a>.</p>');Repite la prueba con la plantilla de destino real. Comprueba tanto el destino como el texto visible. Después, elimina la función de devolución de llamada y verifica que la etiqueta sin correspondencia aparezca literalmente, para que una traducción defectuosa no se confunda con una interacción que funciona.
Prueba de forma explícita la gramática, la dirección y el tiempo #
Para los plurales, renderiza cantidades que pongan a prueba las categorías del idioma de destino. Para las selecciones, incluye un valor desconocido de la aplicación y comprueba other. Para RTL, proporciona locale="ar" y un mapa conocido en árabe, renderiza el atributo de dirección del componente y comprueba dir="rtl". Prueba por separado la estructura del documento si se encarga de <html lang> y <html dir>.
Usa marcas de tiempo fijas y zonas horarias explícitas en las pruebas de fechas. Las pruebas de tiempo relativo necesitan un desfase fijo o un instante de referencia. Estos casos prueban la renderización local; una prueba de hidratación también debe renderizar a través de la ruta de ejecución del cliente del entorno de desarrollo.
Superar una prueba de renderización significa que la plantilla proporcionada funciona con esos valores de entrada. Revisa el contenido del catálogo recuperado y usa una medición de calidad adecuada para comprobar si la traducción conserva el significado.