TypeScript

TypeScript pour Playwright : les bases essentielles pour un QA

Pas besoin de devenir développeur. Voici le sous-ensemble de TypeScript réellement utilisé dans une suite de tests Playwright, avec des exemples issus de vrais projets.

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.

ts
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.

ts
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.

ts
// 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.

ts
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

ts
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

ts
// 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

ts
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

JourSujet
1-2types de base, interface
3-4fonctions, async / await
5-6tableaux et unions
7-8import / export, structure de dossiers
9-10réé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.