Testování zpráv v Reactu
Testujte přeložený text, hodnoty, náhradní zobrazení, prvky s formátováním a směr textu pomocí deterministických lokálních katalogů.
Vykreslování zpráv můžete testovat i bez odeslání požadavku na překlad. Předejte známý katalog, vykreslete komponentu a ověřte chování, na které se čtenář spoléhá. S pevně daným překladem lze reprodukovat nesoulad klíčů, chybějící hodnotu nebo nefunkční odkaz.
Otestujte překlad i náhradní zobrazení zdrojového textu #
Tento testovací příklad pro React 19 ověřuje oba výsledky u téže komponenty:
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>");Spusťte příklad ve stávajícím testovacím nástroji projektu s podporou TSX. Jako samostatné testovací případy přidejte položku s prázdným řetězcem a záměrně odlišný kontext; v obou případech by se měl použít zdrojový text. Zahrňte také případ s chybějící jednoduchou hodnotou, abyste odhalili případný zobrazený zástupný symbol. Nespoléhejte na to, že vygenerovaná deklarace zaručí přítomnost všech vstupů za běhu.
Pro testy zdrojového textu používejte pomocné funkce s pevně nastavenou angličtinou #
Samostatný vstupní bod pro testování nabízí stručnější obal pro testy, které potřebují pouze zdrojový text:
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);Tento postup navazuje na příklad Greeting. renderStatic(node: ReactNode): string obalí uzel poskytovatelem s angličtinou a bez zpráv a vrátí statický značkovací kód. withLingo(node: ReactNode): ReactNode vrátí tento obal pro váš vlastní vykreslovač. Ani jedna z pomocných funkcí nepřijímá nastavení jazyka ani katalogu; pro testy překladů nebo RTL použijte explicitně zadaného poskytovatele.
Ověřte prvek, který vytvoří zpráva s formátováním #
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>');Zopakujte postup se skutečnou cílovou šablonou. Ověřte společně cíl odkazu i zobrazený text. Poté odeberte funkci zpětného volání a ověřte, že se značka bez odpovídajícího zpracování zobrazí doslovně. Předejdete tak tomu, aby se nefunkční překlad zaměnil za funkční interakci.
Cíleně otestujte gramatiku, směr textu a čas #
U množného čísla vykreslete počty, které pokryjí kategorie cílového jazyka. U výběrových větvení zahrňte neznámou hodnotu aplikace a ověřte other. U RTL předejte locale="ar" a známou mapu arabských překladů, vykreslete atribut směru komponenty a ověřte dir="rtl". Základní strukturu dokumentu testujte samostatně, pokud zodpovídá za <html lang> a <html dir>.
V testech kalendářních dat používejte pevně daná časová razítka a explicitně zadaná časová pásma. Testy relativního času vyžadují pevný posun nebo referenční okamžik. Tyto případy testují lokální vykreslování; test hydratace musí navíc provést vykreslení přes klientskou část frameworku.
Úspěšný test vykreslování znamená, že předaná šablona funguje pro dané vstupy. Pokud chcete zjistit, zda překlad zachovává význam, zkontrolujte obsah načteného katalogu a použijte vhodné měření kvality.