Dokumentace

Kaloko

Stáhnout
Markdown s obrázky (.zip)Složka pro Docusaurus (.zip)Složka pro VitePress (.zip)Složka pro MkDocs (.zip)HTML pro offline čtení (.zip)PDFNovinky jako JSON
Stránky

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ázevVelikostProč
desktop1280 × 800běžný notebook
mobile360 × 800nejužší 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.

Na této stránceNa této stránce