Tester les messages React
Testez le texte traduit, les valeurs, le repli sur le texte source, les éléments enrichis et le sens d’écriture avec des catalogues locaux déterministes.
Vous pouvez tester le rendu des messages sans envoyer de requête de traduction. Fournissez un catalogue connu, effectuez le rendu du composant et vérifiez le comportement attendu par la personne qui lit le message. Une traduction fixe permet de reproduire une clé non concordante, une valeur manquante ou un lien défectueux.
Tester la traduction et le repli sur le texte source #
Ce jeu de test React 19 vérifie les deux résultats avec le même composant :
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>");Exécutez ce test avec l’outil de test existant du projet, qui prend en charge TSX. Ajoutez deux cas distincts : une entrée contenant une chaîne vide et un contexte volontairement différent. Dans les deux cas, le texte source doit être utilisé. Testez aussi l’absence d’une valeur simple pour détecter un éventuel espace réservé visible, plutôt que de supposer qu’une déclaration générée garantit la présence de toutes les valeurs à l’exécution.
Utiliser les fonctions utilitaires limitées à l’anglais pour tester le texte source #
Le point d’entrée distinct dédié aux tests propose une enveloppe plus concise lorsque seul le texte source est nécessaire :
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Cet exemple reprend celui de Greeting. renderStatic(node: ReactNode): string enveloppe le nœud dans un fournisseur configuré en anglais, sans messages, et renvoie un balisage statique. withLingo(node: ReactNode): ReactNode renvoie cette enveloppe pour votre propre moteur de rendu. Aucune de ces fonctions utilitaires n’accepte d’options de langue ou de catalogue ; utilisez un fournisseur explicite pour les tests de traduction ou de rendu RTL.
Vérifier l’élément créé par un message enrichi #
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>');Répétez ce test avec le modèle cible réel. Vérifiez ensemble la destination et le texte visible. Supprimez ensuite la fonction de rappel et vérifiez que la balise sans correspondance s’affiche telle quelle, afin de ne pas confondre une traduction défectueuse avec une interaction fonctionnelle.
Tester explicitement la grammaire, le sens d’écriture et le temps #
Pour les pluriels, effectuez le rendu avec des nombres qui couvrent les catégories de la langue cible. Pour les sélections, incluez une valeur inconnue de l’application et vérifiez other. Pour le rendu RTL, fournissez locale="ar" et une table de correspondance connue en arabe, effectuez le rendu de l’attribut de direction du composant et vérifiez dir="rtl". Testez séparément la structure du document si elle gère <html lang> et <html dir>.
Utilisez des horodatages fixes et des fuseaux horaires explicites pour les tests de dates. Les tests de temps relatif nécessitent un décalage fixe ou un instant de référence. Ces cas testent le rendu local ; un test d’hydratation doit aussi effectuer le rendu via le chemin d’exécution côté client du framework.
Un test de rendu réussi indique que le modèle fourni fonctionne avec les valeurs testées. Examinez le contenu du catalogue récupéré et utilisez une mesure de qualité adaptée pour déterminer si la traduction préserve le sens.