리액트 메시지 테스트

항상 같은 결과를 내는 로컬 카탈로그로 번역된 텍스트, 값, 대체 처리, 리치 요소, 텍스트 방향을 테스트하세요.

번역 요청 없이도 메시지 렌더링을 테스트할 수 있습니다. 내용을 미리 아는 카탈로그를 제공하고 컴포넌트를 렌더링한 뒤, 독자에게 필요한 동작이 제대로 작동하는지 검증하세요. 고정된 번역을 사용하면 키 불일치, 값 누락, 링크 오류를 재현할 수 있습니다.

번역과 원문 대체 처리 테스트 #

이 리액트 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>를 담당한다면 문서 셸도 별도로 테스트하세요.

날짜 테스트에는 고정된 타임스탬프를 사용하고 시간대를 명시하세요. 상대 시간 테스트에는 고정된 시간 차이나 기준 시점이 필요합니다. 이 테스트 사례들은 로컬 렌더링을 확인합니다. 하이드레이션 테스트에서는 프레임워크의 클라이언트 경로를 통한 렌더링도 수행해야 합니다.

렌더링 테스트를 통과했다는 것은 제공한 템플릿이 해당 입력에서 작동한다는 뜻입니다. 번역이 의미를 보존하는지 확인하려면 가져온 카탈로그 내용을 살펴보고 적절한 품질 측정을 사용하세요.