re:re:actable
Урок 034 минуты чтения

Асинхронный UI: findBy, waitFor и act

На этой странице
Кратко

Большинство реальных компонентов асинхронны: загружают данные, ждут ответа после отправки формы, показывают тосты, используют Suspense и переходы. Testing Library даёт два инструмента ожидания: findBy* — дождаться появления элемента (это waitFor + getBy, по умолчанию до 1000 мс с повтором каждые 50 мс), и waitFor(callback) — повторять утверждение, пока оно не пройдёт. Для исчезновения — waitForElementToBeRemoved. Правила: внутри waitFor — одно утверждение и никаких побочных эффектов (клики, ввод — снаружи), не используй waitFor для того, что можно найти через findBy, и не жди «просто так» через setTimeout. Предупреждение «An update to X inside a test was not wrapped in act(...)» означает, что состояние компонента обновилось после того, как тест перестал его ждать: обычно нужно дождаться результата асинхронной операции (findBy), а не оборачивать код в act вручную — render, user-event и утилиты ожидания RTL уже используют act внутри.

Вопрос

Как тестировать компоненты, которые загружают данные или обновляются асинхронно? Когда использовать findBy, waitFor и act?

Загрузка данных

// Компонент: показывает «Загрузка…», затем список заказов (сеть замокана через MSW)
it("показывает заказы после загрузки", async () => {
  renderWithProviders(<OrdersPage />);
 
  expect(screen.getByRole("status")).toHaveTextContent("Загрузка");            // начальное состояние
  expect(await screen.findByRole("row", { name: /Заказ №42/ })).toBeInTheDocument(); // ждём данные
  expect(screen.queryByRole("status")).not.toBeInTheDocument();                // загрузка исчезла
});

findBy и waitFor

// ✓ Появление элемента — findBy
expect(await screen.findByText("Сохранено")).toBeInTheDocument();
 
// ✓ Изменение состояния уже существующего элемента — waitFor
await waitFor(() => expect(screen.getByRole("button", { name: "Сохранить" })).toBeEnabled());
 
// ✓ Колбэк, вызванный асинхронно
await waitFor(() => expect(onSuccess).toHaveBeenCalledWith({ id: "42" }));
 
// ✓ Исчезновение
await waitForElementToBeRemoved(() => screen.queryByText("Загрузка…"));

Настройка таймаута: findByText("…", {}, { timeout: 3000 }), waitFor(cb, { timeout: 3000 }). Если нужно больше нескольких секунд — вероятно, в тесте настоящие задержки, которые стоит заменить фейковыми таймерами или моками.

Ошибки с waitFor

// ✗ Побочный эффект внутри — клик повторится много раз
await waitFor(() => {
  fireEvent.click(button);
  expect(screen.getByText("Готово")).toBeInTheDocument();
});
 
// ✗ Несколько утверждений — при падении первого ждём впустую весь таймаут
await waitFor(() => {
  expect(onSubmit).toHaveBeenCalled();
  expect(screen.getByText("Готово")).toBeInTheDocument();
});
 
// ✗ Пустой колбэк — ничего не ждёт
await waitFor(() => {});
 
// ✗ waitFor + getBy вместо findBy
await waitFor(() => screen.getByText("Готово"));
 
// ✓
await user.click(button);
expect(await screen.findByText("Готово")).toBeInTheDocument();
expect(onSubmit).toHaveBeenCalled();

Предупреждение act(...)

Warning: An update to OrdersPage inside a test was not wrapped in act(...).

Причина: тест закончился (или перешёл к следующему шагу), а компонент получил данные и обновился «в пустоту». Результат этого обновления не проверен.

СитуацияИсправление
Запрос завершился после последнего утвержденияДождаться результата: await screen.findBy...
Таймер в компоненте сработал после тестаФейковые таймеры + проматывание внутри теста
Обновление после размонтированияОтменять запросы в cleanup эффекта (это и баг в коде)
Прямой вызов колбэка/стора вне RTLОбернуть в act(() => …)
// Прямое изменение внешнего стора — тут act нужен
act(() => useCartStore.getState().addItem(item));
expect(screen.getByText("Товаров: 1")).toBeInTheDocument();

В React 19 act импортируется из react (import { act } from "react"); RTL реэкспортирует его.

Suspense и use()

it("показывает fallback, затем профиль", async () => {
  const userPromise = Promise.resolve({ name: "Анна" });
  render(
    <Suspense fallback={<p>Загрузка профиля…</p>}>
      <Profile userPromise={userPromise} />      {/* внутри use(userPromise) */}
    </Suspense>,
  );
  expect(await screen.findByText("Анна")).toBeInTheDocument();
});

Промис для use() нужно создавать вне рендера (в тесте), иначе каждый рендер создаёт новый промис и компонент бесконечно подвешивается.

Ошибки и Error Boundary

it("показывает запасной UI при ошибке загрузки", async () => {
  vi.spyOn(console, "error").mockImplementation(() => {});  // React логирует пойманные ошибки
  server.use(http.get("/api/orders", () => HttpResponse.json({}, { status: 500 }), { once: true }));
  const user = userEvent.setup();
 
  renderWithProviders(<OrdersPage />);
 
  expect(await screen.findByRole("alert")).toHaveTextContent("Не удалось загрузить заказы");
  await user.click(screen.getByRole("button", { name: "Повторить" }));   // второй запрос — обычный хэндлер
  expect(await screen.findByRole("row", { name: /Заказ №42/ })).toBeInTheDocument();
});

Оптимистичные обновления

it("сразу показывает лайк и откатывает при ошибке", async () => {
  server.use(http.put("/api/posts/:id/like", () => HttpResponse.json({}, { status: 500 })));
  const user = userEvent.setup();
  renderWithProviders(<Post post={post} />);
 
  const like = screen.getByRole("button", { name: "Нравится" });
  await user.click(like);
  expect(like).toHaveAttribute("aria-pressed", "true");          // оптимистично
 
  await waitFor(() => expect(like).toHaveAttribute("aria-pressed", "false")); // откат
  expect(await screen.findByRole("alert")).toHaveTextContent("Не удалось");
});

Что важно помнить

  • findBy — дождаться появления; waitFor — дождаться изменения; waitForElementToBeRemoved — исчезновения.
  • В waitFor — одно утверждение и без побочных эффектов.
  • Предупреждение act — сигнал, что тест не дождался обновления; чаще лечится findBy, а не ручным act.
  • Промисы для use() создаются вне рендера.
  • Проверяй начальное, промежуточное и конечное состояния.

Мини-шпаргалка

  • await screen.findByRole(...).
  • await waitFor(() => expect(...)).
  • await waitForElementToBeRemoved(() => screen.queryBy...).
  • act(() => store.update()) — только для обновлений вне RTL.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам