Files
mechanic-pwa/driver-pwa/frontend/src/lib/back.test.tsx
T
tremble7681andClaude Opus 5.5 ab2ad8d471 feat(nav): кнопка «Назад» на каждом экране + правило для новых разделов (задача 6385)
На айфоне у установленного приложения нет системной «назад», а жест от края
после холодного старта или открытия из пуша не делает ничего — водитель
застревал в «Уведомлениях», на ожидании Telegram и оплаты, на спиннере штрафа.

- Все экраны заводятся в таблице src/routes.tsx с обязательным родителем
  (null — только у главной и входа); App рисует <Route> только из неё.
- BackBar над маршрутами показывает «Назад» (44 px) в любом состоянии экрана.
  Логика в lib/back.ts: есть история этого запуска (history.state.idx > 0) —
  шаг назад, нет — на родителя с replace.
- Тест-сторож обходит таблицу с зависшей сетью и требует «Назад» на каждом
  экране с родителем; список «корневых» экранов закреплён.
- После входа/оплаты/выхода переходы с replace — «Назад» не возвращает на
  отработанную форму; экраны входа уводят вошедшего на главную.
- Фильтр выписки (?kind=, период) и вход по коду (?by=code) — в адресе:
  «Назад» из штрафа возвращает к списку штрафов.
- ErrorBoundary вместо белого экрана при падении.
- driver-pwa/CLAUDE.md — правило и чек-лист нового раздела.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 21:53:48 +10:00

125 lines
5.3 KiB
TypeScript

import { describe, it, expect, beforeEach } from "vitest";
import { render, screen, waitFor } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { BrowserRouter, Link, MemoryRouter, Route, Routes, useLocation } from "react-router-dom";
import { BackButton } from "@/components/BackButton";
import { BackBar, BackProvider } from "@/components/BackBar";
import { canGoBackInApp, useBackOverride } from "./back";
// Настоящий BrowserRouter поверх истории jsdom: только так виден счётчик idx.
// Родитель экрана /a/b — главная, а позади в истории — /a: по тому, куда
// попали, видно, какой из двух путей сработал.
function Where() {
const loc = useLocation();
return <p data-testid="where">{loc.pathname}</p>;
}
function app() {
return render(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<Link to="/a/b">глубже</Link>} />
<Route path="/a/b" element={<BackButton to="/" />} />
</Routes>
</BrowserRouter>
);
}
const idx = () => (window.history.state as { idx?: number } | null)?.idx;
describe("canGoBackInApp", () => {
it("смотрит на счётчик записей BrowserRouter, а не на длину истории", () => {
window.history.replaceState(null, "", "/");
expect(canGoBackInApp()).toBe(false);
window.history.replaceState({ idx: 0 }, "", "/");
expect(canGoBackInApp()).toBe(false);
window.history.replaceState({ idx: 2 }, "", "/");
expect(canGoBackInApp()).toBe(true);
});
});
describe("кнопка «Назад»", () => {
beforeEach(() => window.history.replaceState(null, "", "/"));
it("есть история в приложении — ровно один шаг назад", async () => {
app();
await userEvent.click(screen.getByRole("link", { name: "в раздел" }));
await userEvent.click(screen.getByRole("link", { name: "глубже" }));
expect(idx()).toBe(2);
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
// popstate в jsdom асинхронный — ждём.
await waitFor(() => expect(screen.getByTestId("where").textContent).toBe("/a"));
expect(window.location.pathname).toBe("/a");
expect(idx()).toBe(1);
expect(window.history.length).toBe(len);
});
it("холодный старт (пуш, ссылка) — на родителя заменой, история не растёт", async () => {
window.history.replaceState(null, "", "/a/b");
app();
expect(idx()).toBe(0);
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByTestId("where").textContent).toBe("/");
expect(window.location.pathname).toBe("/");
expect(idx()).toBe(0);
expect(window.history.length).toBe(len);
});
it("режим parent — на родителя даже при истории позади", async () => {
render(
<BrowserRouter>
<Where />
<Routes>
<Route path="/" element={<Link to="/a">в раздел</Link>} />
<Route path="/a" element={<BackButton to="/b" mode="parent" />} />
<Route path="/b" element={<p>родитель</p>} />
</Routes>
</BrowserRouter>
);
await userEvent.click(screen.getByRole("link", { name: "в раздел" }));
const len = window.history.length;
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("родитель")).toBeInTheDocument();
expect(idx()).toBe(1);
expect(window.history.length).toBe(len);
});
});
describe("страница перенацеливает «Назад» над экраном", () => {
beforeEach(() => window.history.replaceState(null, "", "/"));
it("цель страницы важнее родителя из таблицы и уходит вместе со страницей", async () => {
// /topup в таблице с родителем «/»; режим внутри страницы ведёт в ленту.
function Mode() {
useBackOverride({ to: "/notifications" });
return <p>режим</p>;
}
render(
<MemoryRouter initialEntries={["/topup"]}>
<BackProvider>
<BackBar />
<Routes>
<Route path="/" element={<p>главная</p>} />
<Route path="/topup" element={<Mode />} />
<Route path="/notifications" element={<p>лента</p>} />
</Routes>
</BackProvider>
</MemoryRouter>
);
// Кнопка по-прежнему одна — страница не рисует вторую.
expect(screen.getAllByRole("button", { name: "Назад" })).toHaveLength(1);
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("лента")).toBeInTheDocument();
// Страница ушла — с ней и её цель: у ленты снова родитель из таблицы.
await userEvent.click(screen.getByRole("button", { name: "Назад" }));
expect(screen.getByText("главная")).toBeInTheDocument();
});
});