Isolation des tests Playwright et contexte de navigateur

Ce chapitre présente le mécanisme d'isolation des tests de Playwright et le concept de contexte de navigateur, une conception clé pour garantir des tests stables et fiables.


Qu'est-ce que l'isolation des tests

L'isolation des tests signifie que chaque cas de test s'exécute dans un environnementcomplètement indépendantet qu'ils ne s'affectent pas mutuellement.

Dans Playwright, chaque test obtient automatiquement un `BrowserContext` indépendantContexte de navigateur(contexte de navigateur).


Qu'est-ce qu'un contexte de navigateur

Un contexte de navigateur équivaut à unprofil de navigateur tout nouveau。

Créer un contexte revient à ouvrir une toute nouvelle fenêtre de navigateur, avec ses propres Cookie, localStorage et sessionStorage, mais avec une surcharge extrêmement faible (de l'ordre de la milliseconde).

ConceptAnalogieDescription
Navigateur (instance de navigateur)Ouvre un programme de navigateurSurcharge élevée ; généralement créé une seule fois pour l'ensemble de l'exécution des tests
Contexte de navigateur (contexte de navigateur)Un profil indépendant dans le navigateurSurcharge faible ; un par test
Page (onglet)Un onglet dans le navigateurOuvre des pages dans le contexte

La `page` dans chaque testpageetcontextest toute nouvelle, donc si un test modifie localStorage ou Cookie, cela n'affectera pas les autres tests.


Ce que le contexte isole

Le contenu suivant est complètement isolé entre chaque contexte de navigateur :

Élément d'isolationDescription
CookiesChaque contexte dispose d'un stockage de cookies indépendant
localStorageLe stockage local est complètement isolé
sessionStorageLe stockage de session est complètement isolé
IndexedDBIsolation de la base de données du navigateur
CacheIsolation du cache HTTP

Exemple

// Test A définit un cookie
test('Test A', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // Définir le cookie (prend effet uniquement dans le contexte actuel)
  await page.context().addCookies([{
    name: 'example_session',
    value: 'abc123',
    domain: 'www.example.com',
    path: '/',
  }]);

  // Les opérations suivantes utilisent ce cookie
});

// Test B reçoit un tout nouveau contexte, sans le cookie défini par Test A
test('Test B', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // context().cookies() renvoie un tableau vide
  const cookies = await page.context().cookies();
  console.log(cookies); // []
});

Utilisation de la fixture context

En plus de `page`page, la fonction de test peut également accéder à lacontextfixture `context` pour les opérations au niveau du Context.

Exemple

test('Utilisation de la fixture context', async ({ context, page }) => {
  // Définir les autorisations au niveau du Context
  await context.grantPermissions(['geolocation']);
  await context.setGeolocation({ latitude: 39.9, longitude: 116.4 });

  // Intercepter le trafic réseau au niveau du Context
  await context.route('**/*.{png,jpg,jpeg}', route => route.abort());

  // page est dans le même contexte et hérite des paramètres ci-dessus
  await page.goto('https://www.example.com/');
});

Scénarios multi-contextes

Lorsque vous devez simuler plusieurs utilisateurs indépendants dans le même test, vous pouvez créer manuellement des contextes.

Exemple

test('Deux utilisateurs opèrent indépendamment', async ({ browser }) => {
  // Créer des contextes indépendants pour les deux utilisateurs
  const userAContext = await browser.newContext();
  const userBContext = await browser.newContext();

  // Les pages des deux utilisateurs sont complètement isolées
  const pageA = await userAContext.newPage();
  const pageB = await userBContext.newPage();

  await pageA.goto('https://www.example.com/login');
  await pageB.goto('https://www.example.com/login');

  // L'utilisateur A se connecte
  await pageA.getByLabel('Identifiant').fill('user_a');
  await pageA.getByLabel('Mot de passe').fill('password_a');
  await pageA.getByRole('button', { name: 'Connexion' }).click();

  // L'utilisateur B se connecte (chacun a un Cookie/Session indépendant, sans s'affecter mutuellement)
  await pageB.getByLabel('Nom d’utilisateur').fill('user_b');
  await pageB.getByLabel('Mot de passe').fill('password_b');
  await pageB.getByRole('button', { name: 'Connexion' }).click();

  // Nettoyage
  await userAContext.close();
  await userBContext.close();
});

Avantages de l'isolation des tests

1. Reproductibilité

Chaque test démarre à partir du même état initial et produit des résultats cohérents quel que soit l'ordre d'exécution.

2. Prévient les défaillances en cascade

L'échec du test A n'entraînera pas l'échec du test B ; chaque test peut être débogué indépendamment.

3. Prend en charge l'exécution parallèle

Comme les tests sont complètement indépendants, Playwright peut les exécuter en parallèle en toute sécurité sur plusieurs workers.

L'isolation des tests est le comportement par défaut de Playwright ; chaquetest()`test` obtient automatiquement une instance indépendante depageetcontext`BrowserContext`, sans nécessiter de configuration supplémentaire.

Autres extensions