Kritéria, kontroly a packy
Kritérium je jedna věc, kterou má krok splnit. Má id (AC1), text pro lidi a právě jednu kontrolu check. Jak je do scénáře přidat: Přidat kritéria a packy. Jak se z výsledků stane verdikt: Jak vznikají verdikty.
Druhy kontrol
type | Kdy ho použít | Volby |
|---|---|---|
deterministic | cokoli spočitatelného nebo přesného: přítomnost, počty, text, URL, styly, hodnoty ve stránce | assert a jeho volby (níže) |
semantic | úsudek: je text srozumitelný, je na stránce jedna hlavní akce | question (anglicky, ano = splněno), true a false (co se počítá za ano a za ne), scope (CSS selektor, který se pošle evaluátorovi), about: console (čte chyby v konzoli místo stránky), vision: true (ukáže i screenshot) |
manual | nehodí se ani jedno; rozhodne kontrolující na plachtě | note |
Čísla, data a počty patří do deterministických kontrol, nikdy do sémantické otázky. V jedné otázce se ptejte na jednu věc.
Deterministické kontroly (assert)
Společné volby: selector (CSS), pattern (regulární výraz) s flags (i, m, s), value, min, max, all (vyhovět musí každá shoda, ne jen jedna).
Obsah stránky
assert | Splněno, když |
|---|---|
exists | selector najde aspoň jeden prvek |
absent | selector nenajde nic |
count | počet shod je mezi min a max |
text_matches | viditelný text prvku odpovídá pattern |
text_absent | žádný viditelný text neodpovídá pattern |
text_equals | celý text se rovná value (mezery sloučené) |
attr_equals | atribut attr se rovná value |
attr_matches | atribut attr odpovídá pattern |
no_overflow | stránka se neposouvá do strany |
no_console_errors | v konzoli nejsou chyby |
Adresa, metadata a odkazy
assert | Splněno, když |
|---|---|
title_matches | titulek stránky odpovídá pattern |
meta_matches | content meta tagu ze selector odpovídá pattern |
link_matches | href odkazu ze selector odpovídá pattern |
url_matches | URL po kroku odpovídá pattern; part vybere href, path, query, hash, host nebo origin |
url_equals | URL se rovná value (cesta nebo celá URL); ignore_query vynechá ?… a #… |
http_status | stav dokumentu je mezi min a max (výchozí 200–299), nebo se rovná value |
link_home | stránka odkazuje zpět na úvodní stránku |
links_ok | každý odkaz na stejný původ odpoví pod 400 (max odkazů na stránku, pattern přeskočí cesty, follow mimo prostředí jen pro čtení) |
hreflang_pairs | aspoň min jazyků, každá verze odpoví 200 a odkazuje zpět |
Strukturovaná data a odpovědní vyhledávače
assert | Splněno, když |
|---|---|
jsonld_present | stránka má <script type="application/ld+json">; s types: [Product, BreadcrumbList] jsou ve strukturovaných datech všechny uvedené typy (počítají se grafy, seznamy, vnořené hodnoty jako offers i mikrodata) |
jsonld_valid | každý blok JSON-LD jde přečíst jako JSON; stránka bez JSON-LD projde. Neúspěch uvede blok a chybu |
aeo_faq_schema | stránka s otázkami a odpověďmi (aspoň dvě details > summary, dl > dt nebo nadpisy h2–h4 s otazníkem na konci) má strukturovaná data FAQPage nebo QAPage. Stránka bez otázek se nehodnotí |
aeo_answer_first | první odstavec pod H1 má min až max znaků (výchozí 40–320): krátká odpověď před podrobnostmi |
llms_txt | /llms.txt webu odpoví 200 s textem, ne HTML stránkou. Jeden dotaz na web a průchod |
nojs_parity | holé HTML stránky stažené bez JavaScriptu obsahuje to, co ukazuje vykreslená stránka: titulek a canonical se shodují, meta popis, H1 a všechny typy JSON-LD v něm jsou a text těla stránky má aspoň ratio vykresleného (výchozí 0,3; posuzuje se, když má vykreslená stránka aspoň 200 znaků). user_agent: stahuje jako crawler: gptbot, oai-searchbot, claudebot, perplexitybot, googlebot, bingbot nebo celý řetězec user agenta |
Bez JavaScriptu (nojs_parity). Spousta AI crawlerů čte HTML, které pošle server, a skripty nikdy nespustí. Kontrola udělá na každou stránku jeden GET navíc, přečte ho v Node bez prohlížeče (nejvýš 500 000 znaků, 15 s) a porovná ho se stránkou, kterou průchod zachytil. Titulky a popisy porovnává tak, jak je čtou lidé (–, », pevné mezery a podobně rozluštěné). Text počítá z celého těla stránky na obou stranách, skryté části také, takže část, kterou Next.js streamuje do skrytého prvku, se počítá stejně jako po vykreslení. S user_agent: přijde jako ten crawler: bez cookies, s user agentem bota a s Accept-Language průchodu, a jen tehdy, když to robots.txt dovolí. Stránku, kterou robots.txt botovi zavírá, nestáhne a ukáže ji jako nehodnocenou s poznámkou „blocked by robots.txt for GPTBot“; stejně tak všechny stránky, když robots.txt odpoví 5xx, protože crawlery pak nestahují nic. Když web dotaz odmítne (401, 403, 429 nebo 503, stránka s ověřením, přesměrování na jinou doménu, třeba na přihlášení), kontrola se také nehodnotí a řekne, koho web odmítl: user agenta bota (prohlížeč stránku dostane), dotaz bez cookies přihlášení nebo brány, nebo kohokoli. Nejde o problém s vykreslením. Bez user_agent: použije user agenta a přihlášení prohlížeče z průchodu a robots.txt nečte. Důkaz vypíše, co bez JavaScriptu chybí, třeba GPTBot without JavaScript: no H1 (rendered: "Photo books"); JSON-LD Product only after JavaScript; body text 0 of 1840 characters (0 %), at least 30 % expected. Titulek v jiném jazyce to řekne i s oběma hodnotami lang. Delší stránku kontrola ořízne a její JSON-LD pak neposuzuje. Každou stránku a user agenta stáhne jednou za průchod (průchod si drží jen krátké shrnutí, ne stránku), robots.txt jednou za web a bota. Porovnávejte vstupní kroky: holé HTML je stránka tak, jak se načte, ne po kliknutích kroku.
Každý snímek navíc zapíše structured_data: počet bloků JSON-LD, neplatné bloky, typy schema.org a z nich ty rozpoznané (Product, Offer, AggregateOffer, BreadcrumbList, FAQPage, QAPage, Article, BlogPosting, NewsArticle, Organization, WebSite). items.json stohového kroku sečte stránky podle typu, stránky bez strukturovaných dat a stránky s neplatným JSON-LD (structured_data na začátku indexu a v stack kroku).
Jazykové verze (používá je pack locale)
Porovnávají stránku s jazykem, ve kterém se procházela (cs, de, en_US). Když jazyk průchodu není jazykový kód (jazyk podle ISO 639-1, třeba cs; cz je země), nepoužijí se.
assert | Splněno, když |
|---|---|
locale_lang | html lang uvádí jazyk průchodu (de-DE pro de); jiný region jen zmíní, neselže kvůli němu |
locale_hreflang | vlastní hreflang stránky ji označí jejím jazykem, každý kód je platný (en-GB, ne en_UK) a tam, kde adresa nese jazyk (/de/…), kód s ní souhlasí. Stránka bez hreflang se nehodnotí |
locale_text | text stránky je v jazyce průchodu. Kaloko počítá běžná slova 26 jazyků (většina Evropy a turečtina); stránky pod min slov (výchozí 40), jiné jazyky a blízké dvojice (dánština, norština, švédština; chorvatština, slovinština) nehodnotí |
locale_prices | ceny s desetinnými místy používají oddělovač daného jazyka (12,50 € v de, $12.50 v en). Stránky bez takových cen se nehodnotí |
Styly a hodnoty ve stránce
assert | Splněno, když |
|---|---|
style_equals | spočítaná CSS vlastnost property se rovná value nebo design tokenu token; op porovnává čísla (>=), tolerance dovolí zaokrouhlení v px |
style_matches | spočítaná property odpovídá pattern |
js_equals | jeden JavaScriptový výraz expression, který jen čte, vrátí ve stránce value (nebo odpovídá pattern, nebo se porovná přes op) |
Přístupnost (používá je pack a11y)
assert | Splněno, když |
|---|---|
a11y_images_alt | obrázky mají alternativní text |
a11y_names | odkazy a tlačítka mají přístupný název |
a11y_labels | formulářová pole mají popisky |
a11y_headings | úrovně nadpisů se nepřeskakují |
a11y_contrast | text splňuje kontrast WCAG AA |
a11y_main | stránka má landmark main |
a11y_unique_ids | id prvků jsou jedinečná |
a11y_focus_order | pořadí tabulátoru odpovídá stránce a dojde ke každému ovládacímu prvku |
a11y_focus_visible | fokus je vidět s kontrastem aspoň 3 : 1 |
a11y_keyboard_trap | tabulátor nikde neuvízne |
a11y_skip_link | odkaz pro přeskočení nebo hlavní obsah do tří zastavení tabulátoru |
a11y_ax_names | ovládací prvky mají název ve stromu přístupnosti prohlížeče |
a11y_landmarks | landmarky jsou úplné a opakované mají popisek |
a11y_aria | role a atributy ARIA jsou platné |
Výkon, aplikace a design
assert | Splněno, když |
|---|---|
perf_lcp, perf_cls, perf_ttfb, perf_weight | vykreslení největšího obsahu, posun rozvržení, čas do prvního bajtu nebo váha stránky nepřekročí max |
app_labels | každý ovládací prvek aplikace má přístupný popisek |
app_touch_targets | dotykové plochy mají aspoň 48 dp (Android) nebo 44 pt (iOS) |
app_no_truncation | žádný text není useknutý trojtečkou |
app_no_crash | aplikace nespadla ani nepřestala odpovídat |
design_pixels | obrazovka se od reference designu liší nejvýš v podílu ratio pixelů (výchozí 0,03) |
design_structure | nadpisy, landmarky, akce a pole odpovídají referenci designu |
uses_tokens | barvy, písma, velikosti, mezery a zaoblení pocházejí ze sady tokenů |
Packy
packs: [seo, a11y] u kroku přidá pevnou sadu kontrol. Jsou to kontroly kondice: jen radí, ukazují se zvlášť od přijetí a do verdiktu kroku se nepočítají. Pack design se do přijetí počítá vždy, ostatní jen tehdy, když je scénář uvede v health: { acceptance: [seo] }. Všechny kontroly všech packů, proč na nich záleží a jak jsou závažné, najdete v Kontrolách kondice.
Na designovém prostředí (kind: design) jsou kroky vaše vlastní HTML ze složky, a tak jsou tam packy, které splní jen kód (seo, aeo, perf, console, errors), vypnuté. Pokud některý chcete i tam, uveďte ho ve scénáři v health: { design_packs: [console] }. a11y, usability a locale běží i na designech.
Kontroly kondice mají id HC, akceptační kritéria id AC. Číslo patří kontrole, takže HC401 (LCP jako kontrola kondice) a AC401 jsou táž kontrola ve dvou rolích: pack v přijetí přidá AC401 a převzetím HC401 dostane krok kritérium AC401 s from: HC401. Vlastní kritérium, které zaujme místo kontroly, ji nahradí a počítá se do přijetí; tak se mění limit (AC401 s max: 4000) nebo převezme jedna kontrola (kaloko health adopt <krok>:<kontrola>). Běhy a scénáře z doby před 7. 10. 2026 označují kontroly kondice AC101…; Kaloko je čte jako HC101… a stará id přijímá i v příkazech.
| Pack | Id | Co přidá |
|---|---|---|
seo | HC101–HC113, HC121–HC127 | jeden H1, titulek 10–70 a popis 50–160 znaků, canonical, hreflang pro každý jazyk, Open Graph, žádný noindex, meta viewport, html lang, žádné přetečení, žádné chyby v konzoli, JSON-LD na stránce (HC112) a platný (HC113); u stack kroku navíc kontroly napříč jeho stránkami (níže) |
usability | HC201–HC204 | účel je jasný z první obrazovky, jedna hlavní akce, pole s popisky, texty odkazů, které říkají, co udělají |
a11y | HC301–HC314 | všechny kontroly přístupnosti výše; průchod navíc projde stránku tabulátorem, nic nekliká ani nepíše |
perf | HC401–HC404 | LCP do 2,5 s, CLS pod 0,1, TTFB do 800 ms, váha stránky do 3 MB (měřeno v prohlížeči průchodu) |
console | HC501 | evaluátor si přečte chyby v konzoli a řekne, jestli se týkají toho, co krok přijímá |
errors | HC601–HC606 | pro chybové stránky: skutečný stav 4xx/5xx, odkaz na úvod, navigace nebo hledání, žádný výpis chyby ze serveru, srozumitelná zpráva s cestou dál, žádné chyby v konzoli. HC601 a HC605 platí jen pro chybové stránky (krok s expect_status: 404 nebo stránka s odpovědí 4xx/5xx); jinde se nepoužijí |
app | HC701–HC705 | popisky, dotykové plochy, žádný useknutý text, žádný pád, jasný účel a další krok |
design | AC801–AC803 | implementace proti referenci designu: pixely, struktura, tokeny |
aeo | HC901–HC905 | pro odpovědní vyhledávače (AI hledání, asistenti): FAQPage nebo QAPage tam, kde stránka klade otázky a odpovídá, krátký odstavec s odpovědí (40–320 znaků) pod H1, /llms.txt v kořeni webu, meta popis a stránka bez JavaScriptu tak, jak ji dostane GPTBot (HC905, nojs_parity) |
locale | HC1001–HC1004 (HC1005 u stacků s items.variants, níže) | pro vícejazyčné weby: html lang, vlastní hreflang stránky, jazyk textu a desetinný oddělovač cen odpovídají jazyku průchodu. Jen ve scénářích, které uvádějí locales |
Pack a11y pokrývá část WCAG 2.2 AA. Audit se čtečkou obrazovky nenahradí.
Pack aeo čte levné signály ze stránky, neměří pořadí v žádném AI asistentovi. Hostované běhy zkontrolují jeho meta popis (HC904), ostatní kontroly aeo a také HC112 a HC113 ukážou jako „nehodnoceno“; kaloko walk a plánovaný workflow na GitHubu vyhodnotí všechny. HC905 potřebuje živou stránku: kaloko recheck ji nechá tak, jak ji našel průchod. Id HC9xx patří packu aeo, HC10xx packu locale; i kontroly locale hostované běhy ukážou jako „nehodnoceno“.
Napříč stránkami stacku (pack seo)
Stack krok s packem seo po průchodu porovná své stránky i mezi sebou. Nic se znovu nestahuje: kontroly čtou titulek, popis, H1, canonical, meta robots, hreflang a stav HTTP z každého snímku.
| Id | Selže, když |
|---|---|
| HC121 | dvě nebo více stránek jednoho jazyka mají stejný titulek. Stránky s chybovou odpovědí, stránky s kanonickou adresou jinam a stejná adresa podruhé se nepočítají |
| HC122 | … stejný meta popis |
| HC123 | … stejný H1 |
| HC124 | stránka uvádí jako kanonickou jinou adresu (stránky mířící na jednu adresu tvoří shluk), nebo canonical míří na stránku ze stacku, která odpoví chybou nebo má noindex. Na stagingu nebo náhledu, kde canonical míří na produkční doménu, platí za stránku samotnou, když se liší jen doménou |
| HC125 | stránka s hreflang neoznačí sama sebe, nebo jazyková verze, kterou stack prošel, odpoví chybou či neodkáže zpátky. Alternativy mimo stack se jen spočítají, nestahují se (stahuje je hreflang_pairs); chybějící x-default se zmíní, neselže kvůli němu |
| HC126 | stack načtený ze sitemapy (items.sitemap, items.robots): stránka odpoví jinak než 200, přesměruje nebo má noindex |
| HC127 | jen s daty o návštěvnosti (traffic v konfiguraci nebo scénáři): stránka s aspoň 100 zobrazeními má CTR pod polovinou mediánu webu na podobných pozicích (1–3, 4–10, 11–20). Přepište její titulek a popis (Konfigurační soubor) |
| HC1005 | stack s items.variants: hreflang, s packem i bez něj: stránka zdrojového jazyka nemá v procházeném jazyce vlastní verzi (hreflang pro jazyk chybí, je tam jen x-default, hreflang vede zpátky na stránku samotnou, stránka nejde načíst, nebo překlad odpoví 4xx/5xx: error 404), nebo víc stránek vede na stejnou verzi. Hreflang čte průchod, když hledá jazykové verze |
Jsou to nálezy kondice stack kroku, počítané ve stránkách. steps/<krok>/items.json je drží v cross_page se skupinami a jejich adresami (nejvýš 20 skupin po 10) a každá dotčená stránka má id v cross_fails. Kontrolu napříč stránkami nejde převzít jako kritérium jedné stránky. Osiřelé stránky a hloubku prokliku Kaloko zatím nekontroluje.
Kontroly celého webu (health.site)
Některé věci patří celému webu, ne stránce. S health: { site: true } ve scénáři zkontroluje průchod každý web jednou za běh (jednou pro každý origin ze základních adres prostředí) a zapíše do běhu site.json:
| Id | Selže, když |
|---|---|
| HC1101 | /robots.txt neodpoví 200, je to HTML stránka, nebo má řádky, které roboti přeskočí (překlep jako Disalow, pravidlo před prvním User-agent) |
| HC1102 | robots.txt blokuje / nebo úvodní cestu některého procházeného jazyka všem robotům, Googlebotu nebo Bingbotu. Na prostředí production je to chyba, jinde varování |
| HC1103 | robots.txt blokuje GPTBot, OAI-SearchBot, ChatGPT-User, PerplexityBot, ClaudeBot, Google-Extended nebo CCBot na celém webu nebo na procházené úvodní cestě. Kontroluje se jen na production |
| HC1104 | sitemapa uvedená v robots.txt (nebo /sitemap.xml, když robots.txt žádnou neuvádí) neodpoví, není urlset ani index sitemap, je useknutá, má relativní adresy nebo stránky z jiné domény než sitemapa a web (robots.txt smí ukázat na sitemapu jinde), víc než 50 000 adres nebo hodnoty lastmod, které nejsou datum nebo leží v budoucnosti. Indexy sitemap se procházejí do dvou úrovní, nejvýš 50 souborů |
| HC1105 | /llms.txt neodpoví 200 s textem |
| HC1106 | http:// nepřesměruje rovnou na https:// téže domény (dočasné 302 nebo 307 zmíní). Na jiném než výchozím portu se nehodnotí |
| HC1107 | druhá podoba domény (example.com pro www.example.com a naopak) odpovídá sama, nebo její první přesměrování vede jinam. Subdomény druhou podobu nemají a nehodnotí se; jiný než výchozí port zůstává |
Kontroly posílají vlastní požadavky, proto jsou vypnuté, dokud o ně scénář nepožádá. Ochranu prostředí (hlavičky, HTTP Basic) posílají jen na origin webu, přesměrování procházejí samy, z odpovědi přečtou nejvýš 10 MB a na jeden web mají dvě minuty. Odpověď 401 (přihlašovací brána) kontrolu neudělá nálezem, jen se nepoužije. Prostředí s klientským certifikátem (mTLS) se nekontrolují. Místo true jde nastavit:
health:
site:
paths: [/, /cs/, /eshop/] # cesty, které robots.txt musí nechat otevřené (výchozí: / a úvodní cesta každého jazyka)
ai_crawlers: false # blokovat AI roboty je rozhodnutí webu: HC1103 vynechat
sitemaps: 20 # nejvíc souborů sitemap na web (výchozí a nejvýš 50)
environments: [production] # na jiných prostředích se kontroly celého webu přeskočí (výchozí: všude)
kaloko health ukáže řádek za každý web a jeho nálezy pod packem site jako site:<host>:HC1104; manifest běhu je drží jako site. Kontroly celého webu nejde převzít jako kritéria.
Závažnost nálezu kondice
Neúspěšná kontrola je chyba, když lidé nebo vyhledávače zůstanou venku: HC107 (noindex), HC108 (viewport), HC110 (přetékání), HC111, HC501 a HC606 (chyby v konzoli), HC301–HC303, HC305, HC310 a HC312 (názvy, popisky, kontrast, past pro klávesnici), HC601 a HC604 (falešná 404, výpis chyby), HC701 a HC704 (popisky v aplikaci, pád), HC1102 (robots.txt blokuje procházené úvodní stránky, na production). Každá jiná neúspěšná kontrola je varování a odpověď, kterou si evaluátor nebyl jistý, je nejistá.
Kaloko · latest · 2026-11-21