Testar mensagens do React
Teste textos traduzidos, valores, texto de origem como alternativa, elementos de formatação e direção com catálogos locais determinísticos.
É possível testar a renderização de mensagens sem solicitar uma tradução. Forneça um catálogo conhecido, renderize o componente e verifique o comportamento de que o leitor depende. Com uma tradução fixa, é possível reproduzir problemas como chaves que não correspondem, valores ausentes ou links quebrados.
Testar a tradução e o texto de origem como alternativa #
Este cenário de teste do React 19 verifica os dois resultados usando o mesmo 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>");Execute este código no executor de testes do projeto que já oferece suporte a TSX. Adicione, como casos separados, uma entrada com uma string vazia e um contexto intencionalmente diferente; ambos devem usar o texto de origem. Inclua um caso com um valor simples ausente para detectar se um marcador fica visível, em vez de presumir que uma declaração gerada garante todas as entradas em tempo de execução.
Usar as funções auxiliares com idioma fixo em inglês nos testes do texto de origem #
O ponto de entrada separado para testes oferece uma forma mais simples de envolver o conteúdo quando o teste precisa apenas do texto de origem:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Este trecho dá continuidade ao exemplo de Greeting. renderStatic(node: ReactNode): string envolve o nó em um provedor em inglês sem mensagens e retorna marcação estática. withLingo(node: ReactNode): ReactNode retorna essa estrutura para uso no seu próprio renderizador. Nenhuma das funções auxiliares aceita opções de idioma ou catálogo; use um provedor explícito para testes com tradução ou RTL.
Verificar o elemento criado por uma mensagem com formatação #
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>');Repita o procedimento com o modelo de destino real. Verifique o destino e o texto visível em conjunto. Em seguida, remova a função de retorno e confirme que a tag sem correspondência aparece literalmente, para não confundir uma tradução com problemas com uma interação que funciona.
Testar gramática, direção e tempo de forma planejada #
Para plurais, renderize contagens que testem as categorias do idioma de destino. Para seleções, inclua um valor desconhecido pela aplicação e verifique other. Para RTL, forneça locale="ar" e um mapa conhecido em árabe, renderize o atributo de direção do componente e verifique dir="rtl". Teste a estrutura do documento separadamente se ela for responsável por <html lang> e <html dir>.
Use carimbos de data e hora fixos e fusos horários explícitos nos testes de data. Testes de tempo relativo precisam de um deslocamento fixo ou de um instante de referência. Esses casos testam a renderização local; um teste de hidratação também deve renderizar pelo fluxo de execução do lado do cliente do framework.
Um teste de renderização que passa indica que o modelo fornecido funciona com aquelas entradas. Inspecione o conteúdo recuperado do catálogo e use uma medição de qualidade adequada para avaliar se a tradução preserva o significado.