Как тестировать сообщения 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>.

В тестах дат используйте фиксированные временные метки и явно заданные часовые пояса. Для тестов относительного времени нужно фиксированное смещение или опорный момент времени. Эти тесты проверяют локальный рендеринг. Тест гидратации должен также проверять рендеринг через клиентский механизм фреймворка.

Успешный тест отображения означает, что переданный шаблон работает с указанными входными данными. Чтобы проверить, сохраняет ли перевод смысл, изучите содержимое полученного каталога и используйте подходящее измерение качества.