SDK VisionAvant-première

Vos tests Playwright, vérifiés par Delta-QA. Une ligne par page à vérifier.

@delta-qa/vision envoie à Delta-QA chaque page que vos tests Playwright vérifient. Delta-QA la compare à sa référence élément par élément et dit quel élément a changé. Vos tests de non-régression écrits dans le code et vos scénarios enregistrés sans code vivent dans le même espace : mêmes références, même jugement, même rapport.

Demander l'accès à Vision Créer un compte gratuit

Le SDK Vision est d'abord disponible en avant-première : contactez-nous pour l'utiliser sur vos tests Playwright.

Trois étapes dans vos tests

Créez une clé d'API dans votre espace Delta-QA et rangez-la dans un secret de votre CI. Le SDK la lit dans DELTAQA_API_KEY ; l'espace est celui de la clé.
Ajoutez un check là où votre test doit vérifier la page : vision.check("Paiement"). Son nom l'apparie à sa référence.
Poussez. Au premier lancement, chaque test est « Nouveau » : sa première photo devient la référence. Au deuxième, site inchangé, aucune différence n'est signalée.

import { test } from "@playwright/test";
import { Vision } from "@delta-qa/vision";

const vision = new Vision(); // reads DELTAQA_API_KEY

test("Checkout", async ({ page }) => {
  await vision.open(page, { id: "checkout", name: "Checkout" });
  await page.goto("https://shop.example.com/checkout");
  await vision.check("Payment");
  await vision.close(); // fails the test on an unreviewed difference
});

Le SDK n'expose que des réglages que Delta-QA applique : aucun n'est accepté sans effet. Le tag et le tag de référence sont facultatifs ; sans eux, le SDK les déduit.

Une comparaison par élément, pas par pixels

Pour chaque check, le SDK envoie la page (son HTML, la taille d'écran) et les ressources que le navigateur a chargées. Delta-QA rouvre la page et compare ses éléments à ceux de la référence, comme une étape de scénario : le rapport dit quel élément a changé — le bouton « Payer », bleu puis vert — et non une zone de pixels.

Une différence non jugée fait échouer le test Playwright, et le journal de la CI donne le lien du lot. Vous ouvrez l'étape, lisez le rapport et jugez : « Voulu » ou « Bug ».

Chaque ressource est reconnue à son empreinte : une ressource déjà connue de votre espace ne repart jamais. Au deuxième lancement d'une suite, site inchangé, seuls le HTML et les empreintes partent.

Une référence par branche, sans fusion automatique

Le tag est déduit de votre branche git ou de la CI, et le tag de référence de la cible de la PR, sinon de main. Une branche neuve se compare à main dès son premier lancement, et le lot affiche « comparé à main ».
« Voulu » s'applique aux tags que vous cochez, « ce tag seulement » par défaut : les autres branches ne voient rien changer.
L'historique d'un test se filtre par environnement et par tag ; n'importe quel scan peut être posé en référence, pour les tags que vous cochez.
Les tests d'un même passage de CI forment un lot, partagé par des machines en parallèle ; la liste des lots se lit comme votre CI.

Créez vos scénarios avec un agent IA : le serveur MCP

Quels frameworks le SDK Vision couvre-t-il ?

Playwright, en TypeScript et JavaScript, sur Chromium. Cypress, WebdriverIO, Firefox et WebKit suivront. Vos scénarios enregistrés sans code se vérifient dans le même espace Delta-QA.

Faut-il réécrire mes tests Playwright ?

Non : vous ajoutez un check là où une page doit être vérifiée, le reste du test ne change pas. Le nom d'un check l'apparie à sa référence : deux checks du même nom dans un test font échouer le lancement en nommant le doublon.

Quelles données le SDK envoie-t-il ?

La page testée (HTML, taille d'écran) et les ressources chargées par le navigateur, sauf la vidéo et le son. Elles ne servent qu'à comparer, et restent rangées dans votre espace. Ne testez pas sur des données personnelles de production : ce choix vous revient.

Mes scénarios sans code changent-ils ?

Non : l'enregistrement, le rejeu et le rapport restent les mêmes. Un scénario peut désormais se lancer sous un tag, et « Voulu » s'applique aux tags que vous cochez.

Puis-je l'utiliser depuis un autre langage ?

Le SDK sera en TypeScript et JavaScript. Un autre langage s'ajoutera si des utilisateurs le demandent.

Faites vérifier vos tests Playwright par Delta-QA

Pour utiliser Vision, contactez-nous : il est d'abord disponible en avant-première. Dites-nous quels tests vous voulez faire vérifier, nous vous ouvrons l'accès.