Une référence (baseline) est une capture d'écran enregistrée d'une page dans son état « approuvé ». Chaque test de Régression Visuelle compare la page en ligne actuelle avec cette référence et signale toute différence. Les moniteurs exécutent des tests de régression selon une planification, donc la référence est le fondement de toute la surveillance.

Comment les références sont capturées

Vous ne capturez pas les références manuellement — le système le fait pour vous dans deux situations :

Lorsque vous créez un nouveau moniteur. La première exécution planifiée (ou votre premier clic manuel sur Exécuter) appelle POST /api/baselines, capture la page et l'enregistre. À partir de là, chaque exécution suivante est un test de régression par rapport à cette référence enregistrée.
Lorsque vous approuvez un résultat de régression. Si le système signale de vrais changements que vous acceptez (vous avez réellement redessiné la page volontairement), cliquez sur Approuver sur le résultat. Cela recapture une nouvelle référence afin que les exécutions futures utilisent le nouvel état comme repère.

Ce qui est enregistré avec la capture d'écran

Pour rendre les comparaisons de régression fiables, chaque référence enregistre plus qu'une simple image :

Capture d'écran (JPEG pleine page) — le repère visuel.
Texte de la page — chaque chaîne visible sur la page. Utilisé pour détecter les changements de texte uniquement qui n'affectent pas le rendu (la correction d'une faute de frappe, une nouvelle phrase dans un paragraphe) — ceux-ci sont détectés de manière programmatique sans faire intervenir l'IA.
Jetons de couleur CSS — propriétés personnalisées CSS extraites (--primary, --accent) ainsi que les couleurs calculées des boutons, liens et titres. Utilisé pour détecter les changements à l'échelle de la palette que la comparaison de pixels seule pourrait manquer.
Cookies de session de la capture — restaurés à chaque exécution de régression afin que la page soit rendue dans la même variante de test A/B / segment de géo-personnalisation qu'au moment où la référence a été prise.

Garde-fous de stabilité

Le pipeline de capture refuse d'enregistrer une référence défectueuse. Si 3 images ou plus de la page n'ont pas pu se charger pendant la capture, l'API renvoie 503 CAPTURE_UNSTABLE et rien n'est enregistré. Cela évite le mode d'échec le plus courant des moniteurs de régression : une référence avec des images manquantes que chaque exécution future signale comme des « changements de couleur » par rapport aux rectangles blancs là où les images devraient être.

Si vous voyez cette erreur, attendez 1 à 2 minutes (votre site ou CDN peut limiter le débit de notre scraper) et réessayez.

Mettre à jour une référence

Deux scénarios appellent une nouvelle référence :

Vous avez déployé des changements intentionnels

La prochaine exécution du moniteur signalera une régression parce que la page a réellement changé. Ouvrez le résultat, vérifiez que les changements sont corrects et cliquez sur Approuver. Le plugin capture immédiatement une nouvelle référence et le compteur de régressions est remis à zéro.

La référence d'origine était mauvaise

Si votre premier résultat de régression semble suspect — de grands « changements de couleur » inexpliqués que vous n'avez pas faits — la référence elle-même a peut-être été capturée à un moment où quelque chose sur votre site était cassé (images lentes, déploiement en cours, purge de CDN). Ouvrez Moniteurs, trouvez le moniteur concerné et cliquez sur Recapturer la Référence. La nouvelle référence remplace l'ancienne et les exécutions futures comparent avec l'état actualisé.

Où résident les références

Les références sont stockées sur les serveurs de QA Proof, indexées par un hachage de l'URL normalisée. Elles persistent à travers les mises à jour du plugin et les redémarrages de WP-Cron. Supprimer un moniteur supprime également sa référence. Il n'y a pas de limite de stockage par référence sur aucun plan — votre nombre de moniteurs est la limite.

API directe

Si vous gérez les références en dehors du plugin WP (par exemple, depuis la CI), les points de terminaison de l'API sont :

POST /api/baselines — capture et enregistre une référence. Corps : { "pageUrl": "..." }.
GET /api/baselines — liste toutes les références de votre compte.
GET /api/baselines/:key — récupère une référence spécifique (renvoie la capture d'écran en ligne sous forme de data URI).
DELETE /api/baselines/:key — supprime une référence.

Consultez la documentation de l'API pour tous les détails.