Práce s cestami
Rozbitý krok a oprava selektoru
Web se mění i mezi dvěma skeny. Tlačítko dostane novou třídu, formulář se přesune o blok níž, přes stránku vyskočí newsletter. Nahraná cesta ale pořád říká „klikni tady“. Přehrání se proto nesnaží dojet na konec za každou cenu: raději krok nespustí, než aby kliklo jinam, než jste nahráli. Tady je, co jednotlivé stavy kroků znamenají a co s nimi dělat.
Jak přehrání hledá prvek
Každý krok nese víc než jeden popis prvku. Přehrání je zkouší v pevném pořadí a použije první, který na stránce najde viditelný prvek:
- nahraný selektor,
- záložní selektory uložené při nahrávání,
- text prvku, nejdřív přesná shoda, potom částečná,
- další nahrané vlastnosti prvku:
id,name, popisek pro čtečky (aria-label) a testovací atributy jakodata-testid, - zaznamenané souřadnice, ale jen když krok nic jiného nenese, když se kliká uvnitř iframu, nebo když nahraný cíl zabíral celou obrazovku.
Pokud krok s kliknutím má nahraný selektor nebo vlastnosti a žádná z cest prvek nenajde, přehrání na souřadnice neklikne. Na tom místě teď může být úplně jiný prvek a klik by byl akce, kterou jste nikdy nenahráli. Krok dostane stav „Cíl kroku nenalezen“ a přehrání pokračuje dalším krokem.
Krok psaní je jiný: musí dostat kurzor do pole. Když se jeho prvek nenajde, přehrání klikne na místo, kde našlo odpovídající pole, případně na zaznamenané místo, a píše jen tehdy, když je aktivní prvek vstupní pole odpovídající nahrávce. Když není, nic se nenapíše, krok selže a cesta se na něm přeruší.
Záložní selektor je pořád to, co jste nahráli, takže krok nalezený přes něj je v pořádku. Když se ale krok našel jen podle textu nebo souřadnic, očekávaný stav se z takového skenu neobnoví. Totéž platí, dokud u kroku čeká návrh opravy. Opakuje-li se to, uvidíte u cesty „Monitoring této journey neběží“.
Co znamenají stavy kroků
Stavy najdete v detailu skenu, v panelu „Integrita monitoringu“ a u jednotlivých kroků.
| Stav v aplikaci | Co se stalo | Co s tím |
|---|---|---|
| „Zotaveno náhradním selektorem“ | Krok se našel jinak než hlavním selektorem. Řádek „Způsob“ říká jak. | Přes záložní selektor nic. Přes text nebo další vlastnosti opakovaně: posuďte návrh opravy, pokud čeká, jinak přenahrajte cestu. |
| „Žádný selektor se nenašel — přehrání kliklo naslepo na zaznamenané souřadnice“ | Krok bez nahrané identity, v iframu nebo přes celou obrazovku se kliknul podle souřadnic. | Podívejte se na screenshot kroku, jestli klik trefil to, co měl. |
| „Cíl kroku nenalezen“ | Prvek na stránce nebyl, nic se neodeslalo. | Když prvek zmizel natrvalo, nahrajte cestu znovu. |
| „Cíl překryt jiným prvkem“ | Prvek tam byl, ale ležel na něm jiný. Klik se neposlal. | Viz další oddíl. |
Dokud cesta dojede, jsou to pozorování. Panel to říká sám: nevytvářejí nálezy, nemění skóre ani neposílají upozornění.
Překrytý prvek se nikdy neproklikává
Když cíl kroku překrývá jiný prvek, přehrání klik nevynutí. Vynucený klik by totiž nedostalo vaše tlačítko, ale to, co leží navrch: cookie lištu, newsletter, chat nebo průvodce novou funkcí.
Vedle stavu najdete značku, id a třídy překryvu. „fixed“ znamená, že se s odrolováním neposune, „cover“ říká, kolik obrazovky zabírá. Podle toho obvykle poznáte, o co jde:
- Cookie lišta. Přehrání samo souhlas nikdy nepotvrdí ani lištu nezavře. Pokud se lišta ukazuje, cesta musí obsahovat váš nahraný klik na ni. Když krok s lištou chybí nebo se lišta od nahrání změnila, nahrajte cestu znovu.
- Jednorázová kampaň. Pokud překryv zmizí, další sken projde. Nic neměňte.
- Trvalý prvek (chat, nový panel). Nahrajte cestu znovu tak, aby ho zavřel váš vlastní krok.
Kdy se cesta přeruší
Cesta se přeruší, když krok selže, nebo když několik kroků po sobě nenajde cíl, narazí na překryv nebo kliká naslepo. V detailu skenu uvidíte „Cesta se přerušila v kroku N“ a v panelu „Proto je cesta označena jako přerušená“ s příčinou.
U kroků, na které sken nedošel, ukáže porovnání „Krok neověřen“. To neznamená, že události zmizely. Sken je jen neměl jak zkontrolovat.
Tlačítko „Nahrát znovu od kroku N“ otevře nahrávání této cesty. Rozbitý krok můžete „Odebrat krok“ a v režimu „Navázat na uložené kroky“ nechat přehrát ty, které fungují, a pokračovat za nimi. Nebo zvolíte „Nahradit všechny kroky“ a nahrajete cestu celou. Pokud už čeká navržená oprava, verdikt nabídne nejdřív „Posoudit navrženou opravu“.
Navržená oprava selektoru
Nový selektor přehrání navrhne jen u kroku psaní: jeho pole se podle nahraného selektoru nenašlo, přehrání ale jednoznačně poznalo vstupní pole se stejnými vlastnostmi (typ, popisek, name, testovací atribut) a po psaní ověřilo, že pole obsahuje zadaný text. U kroku s kliknutím, který se našel podle dalších vlastností, nový selektor nenavrhne nikdy, nanejvýš změnu vlastnosti (viz níže). Krok nalezený podle textu nevede k žádnému návrhu. Přehrání samo žádný návrh nikdy neuloží. Návrh čeká na vaše rozhodnutí v detailu skenu pod tlačítkem „Zkontrolovat drifty“ nebo ve verdiktu jako „Posoudit navrženou opravu“. Rozhodovat můžou editoři, administrátoři a vlastník projektu.
Než přijmete, zkontrolujte dvě věci:
- Jde o tentýž prvek. Otevřete screenshot kroku. Selektor musí mířit na pole nebo tlačítko, které jste nahráli, ne na sousední.
- Selektor vydrží.
data-testid,namenebo smysluplnéidpřežijí redesign. Pořadové číslo ve stromu stránky nebo generovaná třída ne.
Přijmout uloží navržený selektor jako hlavní a původní ponechá jako záložní. Očekávaný stav analytiky se nemění: krok se dál porovnává s tím, co už znáte, a monitoring se rozjede při dalším skenu.
Zamítnout na cestě nic nezmění. Krok se bude dál hledat náhradní cestou a očekávaný stav se z něj neobnoví, takže ho spíš přenahrajte.
Pokud dialog napíše, že se nenašel žádný jednoznačný stabilní selektor, je návrh jen informativní. Sken prvek našel za běhu a ověřil akci, ale nemá co uložit. Přijetím zaznamenáte rozhodnutí, cesta zůstane stejná. Když se to u kroku opakuje, přenahrajte ho.
Dialog umí ještě jeden druh návrhu: změnu vlastnosti prvku, třeba textu tlačítka. Tabulka pak ukáže původní a novou hodnotu. Přijetím řeknete, že změna je u tohoto kroku v pořádku a tato vlastnost se tu přestane hlídat. Selektor se nemění.
Kdy raději přenahrát
- Prvek, na který krok míří, na webu už není.
- Změnil se průběh cesty, třeba košík má nový krok nebo krok končí na jiné stránce než obvykle.
- Návrh opravy míří na jiný prvek, nebo je opakovaně jen informativní.
- Monitoring neběží, protože se kroky nacházejí jen podle textu nebo souřadnic.
Přenahrání je dražší než přijatá oprava. Očekávaný stav se zachová, jen když v cestě zůstal každý dříve uložený krok se stejnou adresou, akcí i selektorem. Když se změnil nebo zmizel byť jediný z nich, očekávaný stav celé cesty se založí znovu z dalších skenů. Proto se vyplatí přijmout správný návrh a přenahrávat až tam, kde se změnil samotný průběh.
Jedna rada, která ušetří nejvíc práce: nahrávání vybírá selektor přednostně z testovacích atributů (data-testid a podobné), potom z negenerovaného id, popisku pro čtečky a name. Když vývojáři přidají data-testid k tlačítkům a polím v konverzní cestě, selektory přežijí i redesign. Kroky nahrané předtím ale nové atributy neznají, takže je po nasazení přenahrajte.