Prueba los mensajes de React
Prueba el texto traducido, los valores, el texto fuente como alternativa, los elementos enriquecidos y la dirección con catálogos locales deterministas.
Puedes probar la renderización de mensajes sin enviar una solicitud de traducción. Proporciona un catálogo conocido, renderiza el componente y verifica el comportamiento del que depende quien lee. Una traducción fija permite reproducir una discrepancia entre claves, un valor faltante o un enlace roto.
Prueba la traducción y el texto fuente como alternativa #
Este caso de prueba de React 19 verifica 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 que ya usa el proyecto y que admite TSX. Agrega, como casos separados, una entrada con una cadena vacía y un contexto deliberadamente distinto; ambos deben usar el texto fuente. Incluye un caso en el que falte un valor simple para detectar si aparece un marcador de posición, en lugar de asumir que una declaración generada garantiza todos los valores de entrada en tiempo de ejecución.
Usa las funciones auxiliares que fijan el idioma en inglés para probar el texto fuente #
El punto de entrada independiente para pruebas ofrece una envoltura más breve cuando la prueba solo necesita el texto fuente:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Este caso continúa el 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 esa envoltura para que la uses con tu propio renderizador. Ninguna de las dos funciones auxiliares acepta opciones de idioma o catálogo; usa un proveedor explícito para las pruebas con traducciones o RTL.
Verifica 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 el destino y el texto visible juntos. Luego elimina la función de devolución de llamada y verifica que la etiqueta sin correspondencia aparezca literalmente, para no confundir una traducción defectuosa con una interacción que funciona.
Prueba la gramática, la dirección y el tiempo de forma deliberada #
Para los plurales, renderiza cantidades que cubran 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 verifica dir="rtl". Prueba la estructura base del documento por separado 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 desplazamiento 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 del cliente del entorno de desarrollo.
Que una prueba de renderización pase significa que la plantilla proporcionada funciona con esos valores de entrada. Revisa el contenido recuperado del catálogo y usa una medición de calidad adecuada cuando lo que necesites comprobar sea si la traducción conserva el significado.