AI-leesbaarheid betekent dat belangrijke informatie op een webpagina correct, actueel en machineleesbaar kan worden opgehaald door AI-agents. Zie je bijvoorbeeld in de HTML die de server genereert een productprijs van 1.299 TL, maar na het uitvoeren van JavaScript 1.249 TL in de browser, dan ontstaan er twee aparte contentlagen. Korte versie: een hydration mismatch stuurt op zichzelf niet per se verouderde data naar een AI-bot; maar als actuele informatie alleen client-side wordt geladen of als de SSR-uitvoer in cache blijft hangen, kunnen sommige agents wel de oude of onvolledige data uit de eerste HTML lezen.
Daarom is het doel niet alleen een pagina te maken die er in de browser goed uitziet, maar ook het verschil te meten tussen de ruwe HTTP-respons, de weergave met JavaScript uit en de DOM na JavaScript. Niet alle AI-systemen crawlen op dezelfde manier: sommige verwerken alleen de HTTP-respons, andere gebruiken een browser die JavaScript uitvoert. In plaats van te gokken welke laag wordt gelezen, voer je de 6 controles uit op dezelfde URL.
Hoe brengt een hydration mismatch verouderde data bij een AI-bot terecht?
Een hydration mismatch ontstaat wanneer de server-HTML afwijkt van de eerste render-uitvoer van React op de client. Het risico op verouderde data komt meestal voort uit een combinatie van een stale SSR-cache, data die client-side wordt opgehaald of waarden die in de loop van de tijd veranderen. De mismatch is dus een symptoom; de inconsistentie in de datastroom is het echte aandachtspunt.
SSR is de eerste HTML die de server naar de browser stuurt. Deze HTML is zichtbaar nog vóór JavaScript draait. Tijdens hydration koppelt React event listeners aan deze markup en matcht het die met zijn eigen virtuele boom. Als de eerste client render afwijkt van de tekst, attributen of node-structuur op de server, kan dat een fout of waarschuwing in de console veroorzaken. Ook al kan React sommige tekstverschillen herstellen, dat betekent niet dat de content voor alle bots actueel blijft.
Welke 6 controles gebruiken om het verschil tussen SSR en client-HTML te vinden?
1. Staat de actuele data in de eerste HTTP-respons?
Leg eerst vast wat de server terugstuurt zonder JavaScript uit te voeren. Als de response body geen titel, prijs, voorraad, datum of gestructureerde data bevat, kan de content zonder JS niet worden gelezen. Is de respons verouderd, dan ligt het probleem vóór hydration: in de databron of in de cachelaag.
Haal dezelfde URL op met verschillende User-Agent-waarden in de command line. Een User-Agent bootst op zichzelf geen echte AI-crawler na; toch kan het wel laten zien of CDN- of serverregels een andere respons geven.
curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html
2. Wat verandert er tussen View Source en de live DOM?
View Source in de browser toont grotendeels de bron-HTML die van de server komt; het Elements-paneel toont de live DOM na JavaScript. Sla beide uitvoer apart op en vergelijk de belangrijkste contentnodes. Als de prijs, beschrijving, datum en waarden in JSON-LD niet gelijk zijn, markeer dan waar het verschil vandaan komt.
De aanwezigheid van een verschil betekent niet altijd een SEO-fout. Bijvoorbeeld: het koppelen van een event listener door React verandert de zichtbare tekst niet. Maar als een voorraadzinsnede die op de server aanwezig is op de client verdwijnt of juist alleen client-side wordt toegevoegd, dan heeft dat direct invloed op de AI-leesbaarheid.
3. In welk component ontstaat de React hydration-fout?
Bewaar de hydration-waarschuwing en de component stack uit de browserconsole. In React 18 en nieuwer kun je voor hydrateRoot onRecoverableError gebruiken om gebeurtenissen in productie te volgen. Als je alleen het log stil maakt, is het probleem nog niet opgelost.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration verschil', error.message, info.componentStack);
}
});
Log de foutmelding samen met de URL, het component en de dataversie; stuur geen persoonsgegevens mee. Zie je dezelfde waarschuwing op één pagina in 3 verschillende componenten, zoek dan naar een gedeelde datumopmaak, locale of bron voor de initial state.
4. Veranderen datum, tijd, locale of random values de eerste render?
Date.now(), Math.random(), de tijdzone van de browser, valuta-opmaak en bronnen zoals window kunnen op server en client verschillende uitkomsten geven. Genereer op de server een vaste ISO-datum of een vooraf geformatteerd label; werk de variabele waarde op de client pas bij in useEffect na hydration.
Als de server bijvoorbeeld in UTC draait en de browser in de tijdzone Europe/Istanbul, kan dezelfde timestamp op een andere dag uitkomen. Moet je in de eerste HTML absoluut een exacte datum tonen, neem dan zowel de tekst als de dataversie in dezelfde payload van server naar client mee.
5. Komt actuele data alleen via een client-side fetch binnen?
Als content in useEffect wordt opgehaald, kan die ontbreken voor een client met JavaScript uit en voor een agent die alleen de HTTP-respons leest. Plaats voor kritieke informatie een startwaarde in de eerste SSR-respons. De client fetch mag de laatste update ophalen; maar de eerste render moet van dezelfde beginwaarde starten.
Als de productprijs die SSR om 10:00 genereerde verschilt van de prijs die de client om 10:01 via de API ophaalt, kan dat een verwachte update zijn. Maar als een AI-agent alleen de eerste HTML verwerkt, ziet die de tweede prijs nooit. Rapporteer dat verschil samen met de contentbron, het productietijdstip en het API-responstijdstip.
6. Houdt CDN, ISR of applicatiecache een oude SSR-uitvoer vast?
Bekijk de cachestatus in response headers zoals Age, ETag, Last-Modified, Cache-Control en CDN-specifieke cache-informatie. Zelfs als de server de actuele prijs uit de database haalt, kan een CDN nog steeds 300 seconden oude HTML teruggeven. Gebruik op het moment dat de content wijzigt een purge, korte revalidation of een passende no-store-policy.
Een test met een willekeurige queryparameter die de cache omzeilt, vertegenwoordigt niet altijd het echte bezoekpad. Vergelijk daarom de normale URL vanaf 2 of 3 verschillende netwerken, met dezelfde headers en met tijdstempelregistratie. Als de body van de 200-respons verschilt, controleer dan ook de variatieregel.
Technische checklist
- Sla de ruwe HTML van de pagina op met
curl; markeer belangrijke tekst, canonical en JSON-LD-velden. - Vergelijk de View Source-uitvoer met de Elements DOM na JavaScript; scheid niet alleen class- of eventbindingverschillen, maar ook verschillen in zichtbare content.
- Test met JavaScript uitgeschakeld of de nodige informatie voor product, artikel of dienst nog steeds leesbaar is.
- Volg React-consolewaarschuwingen met URL, component en dataversie; gebruik
suppressHydrationWarningniet als vervanging voor een echte fix. - Haal datum, tijd, locale en random values uit de eerste render of draag exact dezelfde waarde van server naar client over.
- Controleer in CDN- en applicatiecache bij contentupdates direct TTL, ETag, revalidation en purge-flow.
Voorbeeldscenario: productprijs is in SSR oud, maar in de DOM actueel
Op een e-commercepagina werkt het ERP de prijs van een product bij naar 1.249 TL. Maar vanwege de 300 seconden TTL van het CDN blijft de server HTML teruggeven met 1.299 TL. Het React-component doet na hydration een API-call en toont in de browser 1.249 TL. Terwijl de gebruiker in het Elements-paneel de juiste prijs ziet, kan een AI-lezer zonder JavaScript in de ruwe HTML 1.299 TL aantreffen.
De juiste oplossing is niet alleen het verbergen van de hydration-waarschuwing. Zorg ervoor dat SSR data uit een actuele bron haalt, dat het CDN wordt leeggemaakt na de ERP-update en dat de client dezelfde beginwaarde gebruikt. Het onderstaande patroon zorgt ervoor dat het serverlabel in de eerste client render behouden blijft en pas na binnenkomst van de API-respons gecontroleerd verandert:
function Price({ initialLabel, initialValue }) {
const [price, setPrice] = useState({
label: initialLabel,
value: initialValue
});
useEffect(() => {
fetch('/api/price/abc', { cache: 'no-store' })
.then(response => response.json())
.then(nextPrice => setPrice(nextPrice));
}, []);
return <p data-price={price.value}>{price.label}</p>;
}
Hier moeten initialLabel en initialValue via SSR identiek naar de client worden overgedragen. De API-respons kan bijvoorbeeld terugkomen als { label: '1.249 TL', value: 1249 }. Sla tijdens het testen eerst het bestand ssr.html op, daarna de DOM in een JavaScript-ingeschakelde browser; gebruik vervolgens diff -u om niet alleen het prijsnode, maar ook JSON-LD en toegankelijkheidsteksten te bekijken.
Als de pagina variabele data echt client-side bijwerkt, meet dan wanneer die update plaatsvindt. Een fetch die bijvoorbeeld in 180 milliseconden klaar is, kan zichtbaar zijn voor een browsergebruiker; maar een agent die de serverrespons nooit rendert, ervaart die tijd niet. Voor AI-leesbaarheid moet kritieke informatie in de eerste HTML staan en moet de waarde daar overeenkomen met je geldige databeleid.
Veelgemaakte fouten
- Denken dat het onderdrukken van een hydration-waarschuwing oude of onvolledige content fixt.
- Alleen screenshots controleren en de ruwe HTTP-respons helemaal niet bekijken.
- Prijs, voorraad of artikelbody alleen overlaten aan een API-call in
useEffect. - Op server en client verschillende locale, tijdzone of valuta-opmaak gebruiken.
- Aannemen dat content-updates direct live staan zonder de CDN-cache te controleren.
- Het gedrag van één browserbot generaliseren naar alle AI-agents.
Samengevat: een hydration mismatch is een signaal dat je eerst de SSR-uitvoer moet vergelijken met de eerste render van de client. Om vast te stellen of verouderde data echt bij een AI-bot terechtkomt, beoordeel je de ruwe respons, de weergave met JavaScript uit, de live DOM, React-logs en cache-headers samen op dezelfde URL.