Dvojklik odešle akci dvakrát — stav „odesílá se“ má jiný klíč než řádek a obsluha nemá vlastní pojistku
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”V seznamu má každý řádek akci s potvrzovacím tlačítkem („Provést“). Uživatel klikne dvakrát rychle po sobě, nebo podruhé, protože se dlouho nic neděje. Vzniknou dva doklady a přesune se dvojnásobek požadovaného množství. Obě odpovědi serveru jsou úspěšné, žádná chyba se neukáže a stav i deník spolu souhlasí — jen je operace provedená dvakrát.
Root cause
Sekce “Root cause”Dvě chyby, každá sama o sobě by stačila.
1. Klíč stavu se liší od klíče řádku. Seznam kdysi dostal do klíče řádku další rozměr (stejná položka může být ve více skladech). Stav „odesílá se“ zůstal u staršího tvaru:
// při odeslánísetBusyKey(`${row.itemId}-${row.state}`);
// při vykresleníconst key = `${row.itemId}-${row.warehouseId}-${row.state}`;<Button isLoading={busyKey === key} … /> // nikdy se nerovná → nikdy se nezamkneNic nespadne a nic nevaruje: tlačítko jen nikdy neukáže načítání.
2. Obsluha spoléhá na vypnuté tlačítko. I se správným klíčem je mezi kliknutím a překreslením okno, ve kterém je tlačítko ještě aktivní. Dvě události kliknutí doručené v jednom kroku zavolají obsluhu dvakrát dřív, než se stav promítne do DOM.
Fix
Sekce “Fix”const rowKey = (r: Row) => `${r.itemId}-${r.warehouseId}-${r.state}`; // jediná identita řádku
const submitting = useRef(false);
const submit = async () => { if (!action || submitting.current) return; // okamžitá pojistka, nezávislá na překreslení if (!valid(action)) return; // neplatný vstup pojistku nenastaví submitting.current = true; setBusyKey(rowKey(action.row)); try { await post(action); } finally { submitting.current = false; // i po odmítnutí serverem a po chybě spojení setBusyKey(null); }};Během odesílání jsou neaktivní i akce ostatních řádků a zrušení formuláře, aby se rozpracovaný stav nedal rozbít jinudy.
Test, který rozliší obě příčiny
Sekce “Test, který rozliší obě příčiny”Běžný test „klikni, počkej, klikni znovu“ projde už po opravě klíče — knihovna pro testování mezi kliknutími komponentu překreslí a tlačítko je vypnuté. Okamžitou pojistku ověří až dvě kliknutí v jednom kroku:
await act(async () => { confirm.click(); confirm.click(); }); // stav se mezi nimi nepromítneexpect(posts).toHaveLength(1);Kontrolní varianta „opraven jen klíč, bez pojistky“ musí na tomto testu selhat; pokud projde, test pojistku nehlídá. K tomu patří: uvolnění po odmítnutí serverem i po vyhozené chybě, a dva řádky se stejnou položkou a stavem v různých skladech.
V prohlížeči se totéž doloží pozdržením prvního požadavku (bez změny jeho obsahu), dvojklikem a spočítáním požadavků a vzniklých dokladů.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: hledej stavy typu
busyKey,loadingId,pendingRowa porovnej, jak se skládá klíč při zápisu a při čtení. Každé ruční skládání téhož klíče na dvou místech je kandidát. - Pravidlo: když se mění klíč seznamu, hledej všechny stavy, které se k řádku vážou stejnou identitou.
- Obsluha zápisu má vlastní pojistku. Vypnuté tlačítko je zpětná vazba pro uživatele, ne ochrana.
- Viditelný příznak: tlačítko, které při odesílání nikdy neukáže načítání, není kosmetická vada — znamená, že zámek nefunguje.
- Anti-pattern: považovat dva úspěšné zápisy za „správně“, protože součty sedí. Součty sedí i po dvojím provedení.
Sister bugs / související
Sekce “Sister bugs / související”- Souběžné odeslání téhož dokladu projde dvakrát a přečerpá kredit — stejný následek, příčina na serveru.
- Seznam čte jen první stranu stránkovaného API a při úbytku položek hlásí prázdno — druhá vada téže obrazovky.