Reactのメッセージをテストする

結果が一定になるローカルカタログで、翻訳文、値、フォールバック、リッチ要素、文字方向をテストします。

メッセージの描画は、翻訳リクエストを送らずにテストできます。内容がわかっているカタログを渡し、コンポーネントを描画して、読み手にとって重要な動作を検証します。翻訳を固定すれば、キーの不一致、値の欠落、リンク切れを再現できます。

翻訳と原文へのフォールバックをテストする #

このReact 19のテスト用コードでは、同じコンポーネントで両方の結果を確認します。

tsx
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対応のテストランナーで実行してください。空文字列のエントリと、意図的に異なるコンテキストを、それぞれ別のテストケースとして追加します。どちらも原文が使われるはずです。生成された宣言が実行時のあらゆる入力を保証すると考えず、単純な値が欠けているケースも含めて、プレースホルダーがそのまま表示されないか確認してください。

原文のテストには英語固定のヘルパーを使う #

テスト専用のエントリポイントには、原文だけが必要なテストで使える、より簡潔なラッパーが用意されています。

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は、独自のレンダラーで使えるように、そのラッパーを返します。どちらのヘルパーもロケールやカタログのオプションは受け取りません。翻訳や右から左への表示をテストする場合は、プロバイダーを明示的に指定してください。

リッチメッセージが生成する要素を検証する #

tsx
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>を担う場合は、その部分を別途テストしてください。

日付のテストでは、固定のタイムスタンプを使い、タイムゾーンを明示的に指定してください。相対時刻のテストには、固定のオフセットまたは基準時点が必要です。これらのケースで検証するのは、ローカルでの描画です。ハイドレーションのテストでは、フレームワークのクライアント側の処理経路を通じた描画も必要です。

描画テストの合格が示すのは、渡したテンプレートが、指定した入力に対して機能するということです。翻訳が意味を保っているかを確かめるには、取得したカタログの内容を確認し、適切な品質測定を行ってください。