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’;
Symptom
Sekce “Symptom”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í.
Root cause
Sekce “Root cause”const res = await fetch('/api/queue'); // bez take/skip → server vrátí výchozí první stranuconst json = await res.json();setRows(json.rows ?? []); // json.total se nepoužijeServer 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.
Fix
Sekce “Fix”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/pagea 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
takeserveru — 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í”- Dvojklik odešle akci dvakrát — stav „odesílá se“ má jiný klíč než řádek — druhá vada téže obrazovky.
- Fronta řazená podle času materializovaného stavu — stránka z více čtení — serverová strana téhož seznamu.
- Dávka s limitem před filtrem hladoví pozdější položky — jiná podoba „limit uřízne to důležité“.
- Načítací stav segmentu zafixuje odpověď 200