React-Nachrichten testen
Übersetzte Texte, Werte, Fallbacks, Rich-Text-Elemente und Textrichtung mit deterministischen lokalen Katalogen testen.
Das Rendern von Nachrichten lässt sich ohne Übersetzungsanfrage testen. Gib einen bekannten Katalog vor, rendere die Komponente und bestätige mit Assertions das Verhalten, auf das sich die Lesenden verlassen. Mit einer fest vorgegebenen Übersetzung lassen sich nicht übereinstimmende Schlüssel, fehlende Werte oder defekte Links reproduzieren.
Übersetzung und Fallback auf den Quelltext testen #
Dieses React-19-Testsetup testet beide Ergebnisse mit derselben Komponente:
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>");Führe diesen Test mit dem vorhandenen TSX-fähigen Test-Runner des Projekts aus. Ergänze einen Eintrag mit einer leeren Zeichenfolge und einen bewusst abweichenden Kontext als separate Testfälle; in beiden Fällen sollte der Quelltext verwendet werden. Teste auch einen fehlenden einfachen Wert, um einen sichtbaren Platzhalter zu erkennen, statt anzunehmen, dass eine generierte Deklaration sämtliche Eingaben zur Laufzeit garantiert.
Hilfsfunktionen mit fest eingestelltem Englisch für Quelltexttests verwenden #
Der separate Einstiegspunkt für Tests bietet einen kompakteren Wrapper, wenn der Test nur den Quelltext benötigt:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Hier wird das Beispiel mit Greeting fortgesetzt. renderStatic(node: ReactNode): string umschließt den Knoten mit einem englischsprachigen Provider ohne Nachrichten und gibt statisches Markup zurück. withLingo(node: ReactNode): ReactNode gibt diesen Wrapper für deinen eigenen Renderer zurück. Keine der beiden Hilfsfunktionen akzeptiert Optionen für Sprache oder Katalog; verwende für Übersetzungs- oder RTL-Tests einen expliziten Provider.
Das von einer Rich-Text-Nachricht erzeugte Element mit Assertions testen #
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>');Wiederhole den Test mit der tatsächlichen Zielvorlage. Kontrolliere dabei sowohl das Linkziel als auch den sichtbaren Text. Entferne anschließend den Callback und stelle sicher, dass das Tag ohne passenden Callback wörtlich angezeigt wird, damit eine fehlerhafte Übersetzung nicht für eine funktionierende Interaktion gehalten wird.
Grammatik, Textrichtung und Zeit gezielt abdecken #
Rendere für Pluralformen Zahlenwerte, die die Kategorien der Zielsprache abdecken. Beziehe bei Select-Ausdrücken einen unbekannten Anwendungswert ein und kontrolliere other. Gib für RTL locale="ar" und eine bekannte arabische Zuordnung vor, rendere das Richtungsattribut der Komponente und bestätige dir="rtl" mit einer Assertion. Teste das Dokumentgerüst separat, wenn es für <html lang> und <html dir> zuständig ist.
Verwende in Datumstests feste Zeitstempel und explizite Zeitzonen. Tests für relative Zeitangaben benötigen einen festen Zeitversatz oder einen Referenzzeitpunkt. Diese Testfälle testen das lokale Rendern; ein Hydrationstest muss zusätzlich über den clientseitigen Ausführungspfad des Frameworks rendern.
Ein erfolgreicher Rendering-Test zeigt, dass die vorgegebene Vorlage für diese Eingaben funktioniert. Sieh dir die abgerufenen Kataloginhalte an und nutze eine geeignete Qualitätsmessung, wenn du feststellen möchtest, ob die Übersetzung die Bedeutung bewahrt.