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

typeKdy ho použítVolby
deterministiccokoli spočitatelného nebo přesného: přítomnost, počty, text, URL, styly, hodnoty ve stránceassert a jeho volby (níže)
semanticúsudek: je text srozumitelný, je na stránce jedna hlavní akcequestion (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)
manualnehodí 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

assertSplněno, když
existsselector najde aspoň jeden prvek
absentselector nenajde nic
countpočet shod je mezi min a max
text_matchesviditelný text prvku odpovídá pattern
text_absentžádný viditelný text neodpovídá pattern
text_equalscelý text se rovná value (mezery sloučené)
attr_equalsatribut attr se rovná value
attr_matchesatribut attr odpovídá pattern
no_overflowstránka se neposouvá do strany
no_console_errorsv konzoli nejsou chyby

Adresa, metadata a odkazy

assertSplněno, když
title_matchestitulek stránky odpovídá pattern
meta_matchescontent meta tagu ze selector odpovídá pattern
link_matcheshref odkazu ze selector odpovídá pattern
url_matchesURL po kroku odpovídá pattern; part vybere href, path, query, hash, host nebo origin
url_equalsURL se rovná value (cesta nebo celá URL); ignore_query vynechá ?… a #…
http_statusstav dokumentu je mezi min a max (výchozí 200–299), nebo se rovná value
link_homestránka odkazuje zpět na úvodní stránku
links_okkaž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_pairsaspoň min jazyků, každá verze odpoví 200 a odkazuje zpět

Strukturovaná data a odpovědní vyhledávače

assertSplněno, když
jsonld_presentstrá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_validkaž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_schemastrá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_firstprvní 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_parityholé 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é (&ndash;, &raquo;, 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.

assertSplněno, když
locale_langhtml lang uvádí jazyk průchodu (de-DE pro de); jiný region jen zmíní, neselže kvůli němu
locale_hreflangvlastní 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_texttext 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_pricesceny 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

assertSplněno, když
style_equalsspočítaná CSS vlastnost property se rovná value nebo design tokenu token; op porovnává čísla (>=), tolerance dovolí zaokrouhlení v px
style_matchesspočítaná property odpovídá pattern
js_equalsjeden 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)

assertSplněno, když
a11y_images_altobrázky mají alternativní text
a11y_namesodkazy a tlačítka mají přístupný název
a11y_labelsformulářová pole mají popisky
a11y_headingsúrovně nadpisů se nepřeskakují
a11y_contrasttext splňuje kontrast WCAG AA
a11y_mainstránka má landmark main
a11y_unique_idsid prvků jsou jedinečná
a11y_focus_orderpořadí tabulátoru odpovídá stránce a dojde ke každému ovládacímu prvku
a11y_focus_visiblefokus je vidět s kontrastem aspoň 3 : 1
a11y_keyboard_traptabulátor nikde neuvízne
a11y_skip_linkodkaz pro přeskočení nebo hlavní obsah do tří zastavení tabulátoru
a11y_ax_namesovládací prvky mají název ve stromu přístupnosti prohlížeče
a11y_landmarkslandmarky jsou úplné a opakované mají popisek
a11y_ariarole a atributy ARIA jsou platné

Výkon, aplikace a design

assertSplněno, když
perf_lcp, perf_cls, perf_ttfb, perf_weightvykreslení největšího obsahu, posun rozvržení, čas do prvního bajtu nebo váha stránky nepřekročí max
app_labelskaždý ovládací prvek aplikace má přístupný popisek
app_touch_targetsdotykové plochy mají aspoň 48 dp (Android) nebo 44 pt (iOS)
app_no_truncationžádný text není useknutý trojtečkou
app_no_crashaplikace nespadla ani nepřestala odpovídat
design_pixelsobrazovka se od reference designu liší nejvýš v podílu ratio pixelů (výchozí 0,03)
design_structurenadpisy, landmarky, akce a pole odpovídají referenci designu
uses_tokensbarvy, 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.

PackIdCo přidá
seoHC101–HC113, HC121–HC127jeden 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)
usabilityHC201–HC204účel je jasný z první obrazovky, jedna hlavní akce, pole s popisky, texty odkazů, které říkají, co udělají
a11yHC301–HC314všechny kontroly přístupnosti výše; průchod navíc projde stránku tabulátorem, nic nekliká ani nepíše
perfHC401–HC404LCP 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)
consoleHC501evaluátor si přečte chyby v konzoli a řekne, jestli se týkají toho, co krok přijímá
errorsHC601–HC606pro 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í
appHC701–HC705popisky, dotykové plochy, žádný useknutý text, žádný pád, jasný účel a další krok
designAC801–AC803implementace proti referenci designu: pixely, struktura, tokeny
aeoHC901–HC905pro 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)
localeHC1001–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.

IdSelže, když
HC121dvě 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
HC124strá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
HC125strá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
HC126stack načtený ze sitemapy (items.sitemap, items.robots): stránka odpoví jinak než 200, přesměruje nebo má noindex
HC127jen 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)
HC1005stack 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:

IdSelž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)
HC1102robots.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í
HC1103robots.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
HC1104sitemapa 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
HC1106http:// 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í
HC1107druhá 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