Mettre à jour une capture est une décision de revue.

Une vérification échoue après la disparition d'un bouton. Remplacer l'image attendue ramène le vert mais peut faire de cette disparition la nouvelle norme. La commande ne décide pas si elle était voulue. La référence est une décision produit, pas une réparation par l'outil.

Ce guide suit la documentation des captures Playwright avec une carte locale inventée. Nous comparons un exemple inchangé dans un environnement contrôlé. Ce n'est ni production, ni certificat d'accessibilité, ni mesure de performance. Que signifie l'acceptation de la référence ?

Nommez référence et environnement

L'assertion compare une capture à une référence. Le guide décrit la création au premier lancement, puis la comparaison. Le nom identifie la vue pour éviter une substitution sans rapport.

await page.setContent(`
  <main aria-label="Demo preference card">
    <h1>Demo preference</h1>
    <button>Keep demo setting</button>
  </main>
`);
await expect(page.getByRole('main')).toHaveScreenshot('demo-card.png');

Le moteur Playwright et expect importé sont nécessaires. Une région est capturée, pas tout le produit. Style stable et fenêtre fixe sont utilisés. La référence est créée volontairement puis comparée lors d'un autre lancement.

Système, navigateur, paramètres, matériel et mode sans interface peuvent modifier le rendu. Créez et comparez dans le même environnement. Une autre plateforme peut nécessiter une autre référence, pas une tolérance cachant un changement important.

Lisez la différence avant de remplacer

Examinez attendu, actuel et changement visible. Exigence modifiée, environnement différent ou régression exigent des réponses distinctes malgré le même résultat rouge.

La commande update-snapshots est documentée. Utilisez-la après compréhension et accord selon le processus de l'équipe. Les nouveaux fichiers changent le comportement attendu. Ne remplacez pas tout pour faire taire les écarts.

Un bouton supprimé peut être une refonte correcte ou un défaut grave. Les pixels ne le savent pas. Reliez le changement à l'exigence et gardez une assertion fonctionnelle si sa disponibilité importe.

Limitez honnêtement la comparaison

Une région fournit une preuve sur cette région et cette configuration. Elle ne vérifie ni hors-écran, ni autres fenêtres, ni résultat serveur. Choisissez selon la question, pas la facilité de maintenir du vert.

Les tolérances et styles de capture réduisent le bruit mais changent ce qui compte. Nommez exclusions et seuils. Ne masquez jamais le contrôle à protéger.

Nous comparons la carte inchangée et créons une autre image au libellé modifié pour inspection. Celle-ci n'est pas acceptée comme référence. C'est une différence visible et une comparaison stable, pas une stratégie complète.

Gardez une décision vérifiable

Notez vue, environnement, différence voulue et décision. Conservez l'historique pour expliquer l'évolution. Retirez les dossiers privés avant dépôt des images.

AnyTest décrit exploration et tests pour revue. Demandez ce qui est comparé et qui a accepté le changement. Aucune fonction de référence AnyTest n'est affirmée. La commande écrit un fichier; la revue possède son sens.