Projít víc prohlížečů a zařízení
Běh ve výchozím stavu zachytí každý krok v Chromiu, v každém jazyce a viewportu scénáře. Přidat můžete další prohlížeče, předvolby zařízení, tmavý režim a několik dalších nastavení. Každá kombinace je samostatný snímek, takže přidávejte jen to, o čem úkol je: chyba v Safari potřebuje WebKit u dotčených kroků, ne všechna nastavení u všech kroků.
Výchozí nastavení snímků
Nový scénář (z kaloko init, kaloko draft nebo ze šablony) snímá ve dvou velikostech:
| Název | Velikost | Proč |
|---|---|---|
desktop | 1280 × 800 | běžný notebook |
mobile | 360 × 800 | nejužší běžná šířka telefonu, na které se jako první ukáže, co se nevejde |
Každý krok se snímá jako celá stránka, odshora dolů. Tablet ve výchozím nastavení chybí, protože ho většina úkolů nepotřebuje a každá velikost přidá snímky. Vypnuté jsou i očíslované značky na kontrolovaných prvcích (capture: { annotate: true }).
Změníte to ve viewports: ve scénáři. Tablet přidáte jako tablet: [744, 1133] (iPad mini na výšku); od šířky 900 už většina webů ukazuje desktopovou verzi. capture: { full_page: false } u kroku nechá jen první obrazovku. Scénář, který už máte, si své velikosti nechá, takže jeho baseline zůstanou porovnatelné; scénář bez viewports: se snímá v 1280 × 800 a 390 × 844 jako dřív.
Ve scénáři
viewports: [iphone-se, iphone-15, pixel-8, ipad-landscape, laptop]
browsers: [chromium, webkit, firefox]
color_schemes: [light, dark]
reduced_motion: [no-preference, reduce] # volitelné
forced_colors: [none, active] # volitelné, vysoký kontrast ve Windows
display_modes: [browser, standalone] # volitelné, stránka jako nainstalovaná webová aplikace
Výchozí hodnoty pro celý projekt patří pod walk: v kaloko.config.yml. Příkazová řádka má přednost před scénářem a scénář před konfigurací.
Pro jeden běh
npx kaloko start --scenario qa/flows/checkout.yml --env staging \
--browsers chromium,webkit --color-schemes light,dark --viewports iphone-se,pixel-8,desktop-hd
npx kaloko walk # jeden průchod pro každý prohlížeč a zařízení
npx kaloko walk --browsers webkit # jen snímky běhu ve WebKitu
Předvolby zařízení
npx kaloko devices vypíše předvolby: telefony (iphone-se, iphone-15, pixel-8, galaxy-s24…), skládací telefony (fold-folded, fold-open), tablety (ipad-portrait, ipad-landscape…), počítače (laptop, desktop-hd, desktop-wide) a tv-1080p. Přípona -landscape otočí telefon, skládačku nebo tablet na šířku (iphone-15-landscape). Předvolba nastaví velikost, poměr pixelů, dotyk a user agent zařízení. Odhalí chyby rozložení, zbytek najde až skutečné zařízení.
Nainstalujte prohlížeče
WebKit (jádro Safari) a Firefox stáhnete jednou na každý počítač nebo job v CI:
npx kaloko browser install --browsers webkit,firefox
npx kaloko doctor vypíše prohlížeče, které vaše scénáře potřebují, a řekne, jak doinstalovat chybějící. V CI na Linuxu přidejte --with-deps kvůli systémovým knihovnám.
Co čekat
- Několik kontrol běží jen v Chromiu: názvy ze stromu přístupnosti, viditelný focus a posuny rozložení, ve WebKitu navíc průchod tabulátorem. V ostatních prohlížečích jsou „nehodnoceno“ i s důvodem a krok kvůli nim není částečně splněný.
- Kontrast se kontroluje pro každé barevné schéma zvlášť, takže chyba kontrastu v tmavém režimu neprojde na tmavém snímku.
- Běh odmítne víc než 400 kombinací.
Na plachtě najdete přepínač prohlížeče, barevného schématu a dalších nastavení vedle přepínače jazyka. Detail kroku s předvolbou zařízení vykreslí jeho rámeček a volba Vedle: ukáže stejný krok v jiném prohlížeči nebo schématu vedle něj.