Testar mensagens React
Teste texto traduzido, valores, recurso ao texto de origem, elementos enriquecidos e direção com catálogos locais determinísticos.
Pode testar a renderização de mensagens sem fazer um pedido de tradução. Forneça um catálogo conhecido, renderize o componente e verifique o comportamento de que o leitor depende. Uma tradução fixa permite reproduzir uma incompatibilidade de chaves, um valor em falta ou uma ligação que não funciona.
Testar a tradução e o recurso ao texto de origem #
Este cenário de teste em React 19 verifica os dois resultados com 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 teste com a ferramenta de testes do projeto que já suporta TSX. Adicione, como casos separados, uma entrada com uma cadeia vazia e um contexto deliberadamente diferente; em ambos os casos, deve ser usado o texto de origem. Inclua um caso em que falte um valor simples para detetar se aparece um marcador de posição, em vez de presumir que uma declaração gerada garante a presença de todos os valores de entrada em tempo de execução.
Usar as funções auxiliares com o idioma fixado em inglês nos testes do texto de origem #
O ponto de entrada separado para testes disponibiliza uma forma mais concisa de encapsulamento quando o teste só precisa do texto de origem:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Este exemplo dá continuidade ao de Greeting. renderStatic(node: ReactNode): string envolve o nó num fornecedor em inglês sem mensagens e devolve marcação estática. withLingo(node: ReactNode): ReactNode devolve esse encapsulamento para usar com o seu próprio renderizador. Nenhuma das funções auxiliares aceita opções de idioma ou de catálogo; use um fornecedor explícito para testes com tradução ou RTL.
Verificar o elemento criado por uma mensagem enriquecida #
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 etiqueta sem correspondência aparece literalmente, para que uma tradução com problemas não seja confundida com uma interação funcional.
Testar explicitamente a gramática, a direção e o tempo #
Para os plurais, renderize contagens que abranjam as categorias do idioma de destino. Para as seleções, inclua um valor desconhecido da 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 base do documento separadamente se esta for responsável por <html lang> e <html dir>.
Use marcas temporais fixas e fusos horários explícitos nos testes de datas. Os testes de tempo relativo precisam de um desfasamento fixo ou de um instante de referência. Estes casos testam a renderização local; um teste de hidratação também tem de renderizar através do fluxo do lado do cliente da infraestrutura.
Um teste de renderização bem-sucedido indica que o modelo fornecido funciona com esses valores de entrada. Inspecione o conteúdo obtido do catálogo e use uma medição de qualidade adequada para avaliar se a tradução preserva o significado.