Асинхронный 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.