Přeskočit na obsah

Seznam čte jen první stranu stránkovaného API a při úbytku položek hlásí prázdno

import { Aside } from ‘@astrojs/starlight/components’;

Fronta položek je seskupená podle stavu. Když jich je 50, obrazovka ukáže všechny. Přidá se jedna položka do první skupiny — a jediná položka z poslední skupiny z obrazovky zmizí. V API je na druhé straně, ale obrazovka nenabízí, jak se na ni dostat, ani po odrolování na konec. Uživatel nemá jak poznat, že něco chybí.

const res = await fetch('/api/queue'); // bez take/skip → server vrátí výchozí první stranu
const json = await res.json();
setRows(json.rows ?? []); // json.total se nepoužije

Server stránkoval správně a vracel i celkový počet. Obrazovka ho ignorovala. Protože server řadí nejdřív podle skupiny, uřízne se vždy konec — tedy celé poslední skupiny, ne „nejstarší řádky“.

Stejný kód měl ještě dvě tiché vady, které vyšly najevo až při opravě:

  • před první odpovědí je pole řádků prázdné, takže obrazovka na okamžik hlásila „nic tu není“;
  • chyba čtení se ukázala jako hlášení bez možnosti zkusit to znovu.

Stránkování „Předchozí / Další“ nad stávajícím API, vždy výslovně take=50&skip=…. Každá strana je jedna odpověď serveru; strany se neskládají do jednoho seznamu, protože mezi dvěma požadavky se fronta může změnit a složený seznam by řádky opakoval nebo vynechal.

const [status, setStatus] = useState<'loading' | 'ready' | 'error'>('loading');
const [hasView, setHasView] = useState(false); // existuje potvrzená odpověď od poslední chyby?
const seq = useRef(0);
const wanted = useRef(1);
const load = useCallback(async (page: number) => {
const mine = ++seq.current; // pozdní odpověď na starší požadavek se zahodí
wanted.current = Math.max(1, page);
setStatus('loading');
try {
for (let attempt = 0; attempt < 4; attempt++) {
const target = wanted.current;
const res = await fetch(`/api/queue?take=50&skip=${(target - 1) * 50}`);
if (mine !== seq.current) return;
if (!res.ok) return fail();
const { rows, total } = await res.json();
if (mine !== seq.current) return;
if (rows.length === 0 && total > 0) { // strana za koncem: zeptat se na poslední existující
wanted.current = Math.max(1, Math.ceil(total / 50));
continue;
}
setRows(rows); setTotal(total); setPage(total === 0 ? 1 : target);
setHasView(true); setStatus('ready');
return;
}
fail(); // fronta se zmenšovala při každém pokusu
} catch { if (mine === seq.current) fail(); }
}, []);

Vykreslení podle stavu: chyba → hlášení a tlačítko „Zkusit znovu“ (znovu požádá o wanted); bez potvrzené odpovědi → obrys řádků; potvrzené total = 0 → „nic tu není“; jinak seznam. Dokud není potvrzená odpověď na poslední požadavek, nejde otevřít akci na dosavadním řádku ani listovat, a číslo strany se mění až s potvrzenou odpovědí.

Server musí dodržet jednu věc: i prázdná strana za koncem vrací správný total. Bez toho by obrazovka poslední stranu nenašla.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: hledej volání seznamových API bez take/skip/page a odpovědi, ze kterých se čte jen pole řádků. Ověř, jestli server nemá výchozí limit.
  • Test hranice: právě limit (všechno vidět, listování se nenabízí), limit + 1 (položka na druhé straně je dosažitelná) a násobek nad nejvyšším dovoleným take serveru — zvýšení limitu není řešení.
  • Test obnovy: poslední položka poslední strany zmizí → návrat na poslední existující stranu; fronta se zmenšuje při každém čtení → chyba s opakováním; první čtení selže → opakování; pozdní odpověď nepřepíše novější stav.
  • Kontrolní varianty: vyřaď ochranu proti pozdní odpovědi a vrať „prázdno po vyčerpání pokusů“ — každá musí shodit právě svůj test.
  • Řazení po skupinách + limit vždy znamená, že se ztrácí celé skupiny z konce. Když nejde stránkovat, obrazovka musí aspoň říct „zobrazeno 50 z N“.
  • Anti-pattern: rows.length === 0 ? <Empty/> : <List/> bez ohledu na to, jestli už nějaká odpověď přišla a co říká celkový počet.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 19. 11. 2026 1:00
Provozuje aiarchitekt.cz