Première question posée dans presque toutes mes sessions de formation Playwright : « faut-il savoir coder pour automatiser ? » Réponse honnête : oui, mais beaucoup moins que ce que tu imagines. Une suite de tests Playwright utilise environ 15 % de TypeScript.
Voici ce sous-ensemble, dans l'ordre d'utilité.
1. Les types de base
TypeScript ajoute des types à JavaScript. En tests, cela évite des heures de débogage sur des données mal formées.
const email: string = 'demo@exemple.fr';
const tentatives: number = 3;
const estAdmin: boolean = false;
const tags: string[] = ['smoke', 'regression'];Dans la pratique, on écrit rarement les types explicitement : TypeScript les déduit. On les écrit là où ils documentent une intention.
2. interface et type : décrire tes données de test
C'est l'outil le plus rentable pour un QA. Une interface décrit la forme d'un objet.
interface Utilisateur {
email: string;
motDePasse: string;
role: 'admin' | 'client';
}
const clientStandard: Utilisateur = {
email: 'client@exemple.fr',
motDePasse: 'secret',
role: 'client',
};Le type 'admin' | 'client' est une union : toute autre valeur déclenche une erreur avant l'exécution du test.
3. async / await : la clé de Playwright
Toutes les actions Playwright sont asynchrones. Oublier un await est la première cause de tests instables chez les débutants.
// Faux : le test continue sans attendre le clic
page.getByRole('button', { name: 'Valider' }).click();
// Correct
await page.getByRole('button', { name: 'Valider' }).click();Règle simple : si la ligne touche page, expect ou request, elle commence par await.
4. Fonctions et paramètres
Les fonctions servent à factoriser les étapes répétées.
async function seConnecter(page: Page, user: Utilisateur) {
await page.goto('/login');
await page.getByLabel('Email').fill(user.email);
await page.getByLabel('Mot de passe').fill(user.motDePasse);
await page.getByRole('button', { name: 'Se connecter' }).click();
}Note le type Page importé de @playwright/test : c'est ainsi que l'autocomplétion de ton éditeur devient utile.
5. Méthodes de tableaux pour les tests paramétrés
const roles: Utilisateur['role'][] = ['admin', 'client'];
for (const role of roles) {
test(`le menu s'adapte au rôle ${role}`, async ({ page }) => {
// ...
});
}map, filter et find suffisent pour 95 % des besoins en préparation de données.
6. Import / export : organiser ses fichiers
// fixtures/utilisateurs.ts
export const admin: Utilisateur = { email: 'admin@exemple.fr', motDePasse: 'secret', role: 'admin' };
// tests/connexion.spec.ts
import { admin } from '../fixtures/utilisateurs';C'est la base d'une architecture propre, préalable au Page Object Model.
7. Types optionnels et valeurs nulles
interface Commande {
reference: string;
remise?: number; // optionnel
}
const total = commande.remise ?? 0;L'opérateur ?? évite les fameux undefined qui font échouer un test pour une mauvaise raison.
Ce que tu peux ignorer au début
- les génériques avancés
- les décorateurs
- les classes abstraites et l'héritage complexe
- la configuration fine de
tsconfig.json
Tu y viendras plus tard, si le projet l'exige.
Un plan de travail sur deux semaines
| Jour | Sujet |
|---|---|
| 1-2 | types de base, interface |
| 3-4 | fonctions, async / await |
| 5-6 | tableaux et unions |
| 7-8 | import / export, structure de dossiers |
| 9-10 | réécrire 3 tests existants avec des types propres |
Deux semaines suffisent : c'est d'ailleurs la durée consacrée à TypeScript dans le plan de formation Playwright en 12 semaines.
Étape suivante
Une fois ces bases acquises, enchaîne sur tes premiers tests Playwright, puis sur l'exécution en CI/CD avec GitHub Actions.
Et si tu veux être relu sur du vrai code plutôt que d'avancer seul, regarde le programme d'accompagnement sur la page d'accueil.