测试 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>,请单独测试它。

日期测试应使用固定时间戳,并明确指定时区。相对时间测试需要固定的偏移量或参考时刻。这些用例测试的是本地渲染;水合测试还必须通过框架的客户端路径进行渲染。

渲染测试通过,说明提供的模板在这些输入下能正常工作。要判断翻译是否保留了原意,请检查获取到的消息目录内容,并使用适当的质量评测。