Reactのメッセージをテストする
結果が一定になるローカルカタログで、翻訳文、値、フォールバック、リッチ要素、文字方向をテストします。
メッセージの描画は、翻訳リクエストを送らずにテストできます。内容がわかっているカタログを渡し、コンポーネントを描画して、読み手にとって重要な動作を検証します。翻訳を固定すれば、キーの不一致、値の欠落、リンク切れを再現できます。
翻訳と原文へのフォールバックをテストする #
このReact 19のテスト用コードでは、同じコンポーネントで両方の結果を確認します。
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>");プロジェクトで既に使っているTSX対応のテストランナーで実行してください。空文字列のエントリと、意図的に異なるコンテキストを、それぞれ別のテストケースとして追加します。どちらも原文が使われるはずです。生成された宣言が実行時のあらゆる入力を保証すると考えず、単純な値が欠けているケースも含めて、プレースホルダーがそのまま表示されないか確認してください。
原文のテストには英語固定のヘルパーを使う #
テスト専用のエントリポイントには、原文だけが必要なテストで使える、より簡潔なラッパーが用意されています。
import { renderStatic, withLingo } from "@lingo.dev/react/testing";
const markup = renderStatic(<Greeting />);
const wrapped = withLingo(<Greeting />);これはGreetingの例の続きです。renderStatic(node: ReactNode): stringは、メッセージを持たない英語のプロバイダーでノードをラップし、静的なマークアップを返します。withLingo(node: ReactNode): ReactNodeは、独自のレンダラーで使えるように、そのラッパーを返します。どちらのヘルパーもロケールやカタログのオプションは受け取りません。翻訳や右から左への表示をテストする場合は、プロバイダーを明示的に指定してください。
リッチメッセージが生成する要素を検証する #
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>');実際の翻訳先テンプレートでも同じテストを行い、リンク先と表示テキストを併せて確認してください。次にコールバックを削除し、対応する処理のないタグがそのまま表示されることを確認します。これにより、不備のある翻訳を、正常に操作できる状態と取り違えずに済みます。
文法、文字方向、時刻を意識してテストする #
複数形では、翻訳先の言語の各カテゴリに該当する数値で描画します。選択分岐では、アプリケーションで想定していない値を含め、otherを確認します。右から左への表示では、locale="ar"と内容がわかっているアラビア語のマップを渡し、コンポーネントの文字方向属性を描画して、dir="rtl"を検証します。文書全体の外枠が<html lang>と<html dir>を担う場合は、その部分を別途テストしてください。
日付のテストでは、固定のタイムスタンプを使い、タイムゾーンを明示的に指定してください。相対時刻のテストには、固定のオフセットまたは基準時点が必要です。これらのケースで検証するのは、ローカルでの描画です。ハイドレーションのテストでは、フレームワークのクライアント側の処理経路を通じた描画も必要です。
描画テストの合格が示すのは、渡したテンプレートが、指定した入力に対して機能するということです。翻訳が意味を保っているかを確かめるには、取得したカタログの内容を確認し、適切な品質測定を行ってください。