Vendredi soir, vous mergez une refonte du header. Lundi matin, un collègue vous signale que le bouton de connexion a glissé de quelques pixels sur la page de pricing : une page que vous n'aviez même pas touchée. Aucun test n'a sonné l'alarme, parce qu'aucun test ne regardait l'apparence. C'est précisément le trou que le test visuel comble.
Playwright de Microsoft inclut depuis la version 1.22 une fonctionnalité native de test visuel : la méthode toHaveScreenshot(). Elle permet de capturer des screenshots et de les comparer automatiquement à des images de référence, sans plugin externe. C'est une solution entièrement gratuite : pour d'autres outils gratuits de test visuel, consultez notre comparatif.
C'est l'une des options les plus solides pour les équipes qui veulent ajouter des tests visuels à leur suite existante. Pour comprendre les bases de la régression visuelle, consultez notre guide complet. Ce guide couvre l'installation, la configuration, les bonnes pratiques et l'intégration CI/CD, puis ce que le SDK Vision de Delta-QA change dans ces mêmes tests.
L'essentiel en une page : ce qu'un outil no-code automatise vraiment et comment il se compare : Automatisation des tests sans code.
toHaveScreenshot() vous oblige encore à écrire et maintenir du code ? Delta-QA capture et compare vos pages sans écrire une ligne de code, sans carte bancaire. Essayer Delta-QA gratuitement →
Installation et premier test
La mise en place est rapide si vous avez déjà un projet Node.js :
npm install -D @playwright/test
npx playwright install
Créez ensuite votre premier test visuel dans tests/visual.spec.ts :
import { test, expect } from '@playwright/test';
test('homepage visual test', async ({ page }) => {
await page.goto('https://votre-site.com');
await expect(page).toHaveScreenshot('homepage.png');
});
Le premier lancement génère la baseline (l'image de référence). Les lancements suivants comparent la capture du moment à cette baseline et signalent les différences.
# Première fois : générer les baselines
npx playwright test --update-snapshots
# Ensuite : comparer
npx playwright test
C'est aussi simple que ça pour démarrer. La complexité arrive avec les cas réels.
Configurer la tolérance
Par défaut, Playwright signale la moindre différence d'un pixel. En pratique, il faut configurer des seuils de tolérance pour éviter les faux positifs.
Dans playwright.config.ts :
import { defineConfig } from '@playwright/test';
export default defineConfig({
expect: {
toHaveScreenshot: {
maxDiffPixelRatio: 0.01, // 1 % de pixels différents toléré
animations: 'disabled', // désactive les animations CSS
scale: 'device', // tient compte des écrans Retina
},
},
});
Vous pouvez aussi ajuster test par test :
// Page statique : seuil strict
await expect(page).toHaveScreenshot('landing.png', {
maxDiffPixelRatio: 0.001
});
// Tableau de bord avec graphiques : seuil plus souple
await expect(page).toHaveScreenshot('dashboard.png', {
maxDiffPixelRatio: 0.05,
mask: [page.locator('.chart')]
});
Le seuil est un compromis : trop bas, le moindre écart de rendu fait échouer le test ; trop haut, une marge qui passe de 16px à 12px se glisse sous la barre sans être vue.
Gérer le contenu dynamique
Le contenu dynamique (dates, publicités, avatars, compteurs) est le cauchemar des tests visuels. Playwright propose trois solutions :
Masquer les zones dynamiques, la méthode la plus courante :
await expect(page).toHaveScreenshot({
mask: [
page.locator('.ad-banner'),
page.locator('.timestamp'),
page.locator('.user-avatar')
]
});
Remplacer le contenu pour figer les valeurs :
await page.evaluate(() => {
document.querySelector('.date').textContent = '01/01/2026';
});
await expect(page).toHaveScreenshot();
Cacher par CSS les éléments qui ne doivent pas apparaître du tout :
await page.addStyleTag({
content: '.dynamic-element { visibility: hidden !important; }'
});
await expect(page).toHaveScreenshot();
Chacune de ces solutions se maintient à la main : un nouveau bloc dynamique sur la page, et c'est un sélecteur de plus à ajouter.
Stabiliser les tests
Un test visuel qui passe un jour et échoue le lendemain sans raison est inutilisable. Voici comment garantir la stabilité :
test('stable visual test', async ({ page }) => {
await page.goto('https://votre-site.com');
// Attendre que le réseau soit calme
await page.waitForLoadState('networkidle');
// Attendre le chargement des polices
await page.evaluate(() => document.fonts.ready);
// Attendre un élément critique
await page.waitForSelector('.hero-image', { state: 'visible' });
await expect(page).toHaveScreenshot();
});
Et pour désactiver les animations à la main quand l'option globale ne suffit pas :
await page.addStyleTag({
content: `
*, *::before, *::after {
animation-duration: 0s !important;
transition-duration: 0s !important;
}
`
});
Tester plusieurs résolutions
Playwright facilite le test multi-résolution via les projets :
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'Desktop',
use: { viewport: { width: 1920, height: 1080 } },
},
{
name: 'Tablet',
use: { viewport: { width: 768, height: 1024 } },
},
{
name: 'Mobile',
use: { ...devices['iPhone 13'] },
},
],
});
Chaque projet génère ses propres baselines. Un test s'exécute donc trois fois, dans trois résolutions, avec trois jeux de captures à tenir à jour.
Intégration CI/CD
L'intégration dans GitHub Actions est directe. Pour une configuration complète, consultez notre guide des tests de non-régression dans GitHub Actions ou, côté GitLab, celui du test visuel dans GitLab CI.
name: Visual Tests
on: [push, pull_request]
jobs:
visual-tests:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- run: npm ci
- run: npx playwright install --with-deps
- run: npx playwright test
- uses: actions/upload-artifact@v4
if: failure()
with:
name: playwright-report
path: playwright-report/
Quand un test échoue, Playwright produit trois images : la baseline (attendue), la capture du moment et un diff avec les différences en rouge. Le rapport HTML (npx playwright show-report) les affiche côte à côte.
Point d'attention : le rendu des polices varie d'un système à l'autre. Des baselines générées sur un Mac ne correspondront pas aux captures prises sur le runner Linux de la CI. Générez-les dans la CI, ou dans l'image Docker officielle de Playwright.
toHaveScreenshot() vous demande encore d'écrire du code ? Delta-QA capture et compare vos pages en no-code, sans carte bancaire. Essayer Delta-QA gratuitement →
Les limites de l'approche Playwright
Playwright est excellent pour les équipes qui écrivent leurs tests, mais toHaveScreenshot() a des limites qu'il faut connaître :
Compétences obligatoires : il faut maîtriser TypeScript/JavaScript, les sélecteurs et la configuration de projet. Les QA qui n'écrivent pas de code ne peuvent ni créer ni maintenir ces tests.
Pas d'interface de revue : il n'y a pas d'espace partagé pour juger les différences. La gestion des baselines se fait via le terminal et le système de fichiers. En équipe, ça devient vite complexe.
Une comparaison de pixels : le diff montre une zone rouge, pas ce qui a changé. Les différences d'anti-aliasing entre navigateurs, les variations de rendu des polices entre OS : tout cela génère du bruit qu'il faut gérer à la main avec des masques et des seuils.
Maintenance : chaque changement d'interface voulu oblige à régénérer les baselines (--update-snapshots). Sur un projet avec 200 tests visuels et 3 navigateurs, cela fait 600 baselines à gérer, versionnées dans le dépôt. Notre guide sur la gestion des baselines détaille les stratégies pour les maintenir.
Garder Playwright, changer la comparaison : le SDK Vision
Si vos tests Playwright existent déjà, vous n'avez pas à les quitter pour lever une partie de ces limites. Le SDK Vision de Delta-QA (@delta-qa/vision) ajoute une vérification Delta-QA là où le test doit regarder la page :
import { test } from "@delta-qa/vision/fixture";
test("Checkout", async ({ page, vision }) => {
const checkout = await vision.open(page, { id: "checkout", name: "Checkout" });
await page.goto("https://shop.example.com/checkout");
await checkout.check("Paiement");
}); // fermé par la fixture : une différence non jugée fait échouer le test
Le SDK lit la clé d'API dans la variable DELTAQA_API_KEY. Sans la fixture, open(page, { … }) de @delta-qa/vision ouvre le même test, et close() le ferme dans un afterEach.
Ce qui change par rapport à toHaveScreenshot() :
- Le rapport nomme l'élément qui a changé. Pas une zone rouge à interpréter : le rapport dit quel élément a changé, par exemple le bouton « Payer », passé du bleu au vert.
- Les références ne vivent plus dans le dépôt. Au premier lancement, chaque check devient la référence. Ensuite, une différence non jugée fait échouer le test, et le journal de la CI donne le lien du rapport. Vous y jugez chaque différence : « Voulu » ou « Bug ».
- Une référence par branche. Le test donne sa branche et sa branche de base (
branch,baseBranch) : une branche neuve se compare à sa branche de base dès son premier lancement, et « Voulu » ne s'applique qu'aux branches que vous cochez. - Le reste du test ne change pas. Les projets de
playwright.config.tscontinuent de s'appliquer : chaque taille d'écran a sa propre référence. Seule condition : une densité d'écran de 1 (deviceScaleFactor: 1).
Le SDK couvre Playwright en TypeScript et JavaScript, sur Chromium. Il est d'abord proposé en avant-première : l'accès se demande depuis sa page.
Et pour ceux qui n'écrivent pas de tests
Les tests Playwright restent du code. Pour que les QA, les product owners ou les designers vérifient eux aussi l'apparence de l'application, les solutions no-code comme Delta-QA proposent une autre voie : on enregistre un parcours dans le navigateur, Delta-QA le rejoue à chaque version et compare chaque étape à sa référence. Ces scénarios et les checks du SDK Vision se jugent dans le même espace Delta-QA, avec le même rapport.
Envie de tester sans une ligne de TypeScript ni une seule baseline à régénérer ? Comparez vos pages avec Delta-QA dès maintenant, gratuitement et sans carte bancaire. Essayer Delta-QA gratuitement →
FAQ
Playwright est-il gratuit pour les tests visuels ?
Oui, entièrement. toHaveScreenshot() est intégré nativement dans Playwright, qui est open source et maintenu par Microsoft. Pas de licence, pas de limite de screenshots.
Combien de temps pour mettre en place les tests visuels Playwright ?
Si vous maîtrisez déjà Playwright, comptez quelques heures pour configurer et écrire vos premiers tests. Si vous partez de zéro (installation, apprentissage de TypeScript, configuration de la CI), comptez 2 à 3 jours.
Playwright ou Cypress pour les tests visuels ?
Playwright a l'avantage d'intégrer le test visuel nativement (toHaveScreenshot()), tandis que Cypress nécessite un plugin externe. Playwright supporte aussi trois moteurs de navigateurs (Chromium, Firefox, WebKit), là où Cypress prend en charge les navigateurs Chromium et Firefox, WebKit restant expérimental. Pour le détail, voyez notre comparatif Playwright vs Cypress, ou Playwright vs Selenium si vous hésitez entre ces deux frameworks.
Peut-on utiliser Playwright et Delta-QA ensemble ?
Oui, et dans le même test. Avec le SDK Vision, vous ajoutez vision.check() aux étapes où la page doit être vérifiée : Playwright pilote le navigateur et vos assertions fonctionnelles, Delta-QA compare la page à sa référence. Les parcours enregistrés sans code par l'équipe QA se jugent dans le même espace.
Faut-il retirer mes toHaveScreenshot() pour utiliser le SDK Vision ?
Non. Les deux peuvent cohabiter dans une même suite : vous pouvez ajouter des vision.check() sur quelques pages, comparer les résultats, puis décider page par page de ce que vous gardez.
Playwright offre une base solide pour les tests visuels automatisés. Pour les équipes qui écrivent leurs tests en TypeScript, toHaveScreenshot() est probablement la meilleure option open source disponible en 2026, à condition de bien régler les seuils et de stabiliser les tests dès le départ. Quand le diff de pixels et les baselines du dépôt deviennent la charge principale, le SDK Vision garde vos tests et change la comparaison. Pour situer Playwright face aux autres outils, consultez notre comparatif des outils de test de non-régression.
