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>
This commit is contained in:
1 parent
7d8f4b8998
commit
ab2ad8d471
29 files changed
+1148
-81
No files matched your search
@@ -0,0 +1,124 @@
|
||||
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();
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user