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).
| Concept | Analogie | Description |
|---|---|---|
| Navigateur (instance de navigateur) | Ouvre un programme de navigateur | Surcharge é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 navigateur | Surcharge faible ; un par test |
| Page (onglet) | Un onglet dans le navigateur | Ouvre 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'isolation | Description |
|---|---|
| Cookies | Chaque contexte dispose d'un stockage de cookies indépendant |
| localStorage | Le stockage local est complètement isolé |
| sessionStorage | Le stockage de session est complètement isolé |
| IndexedDB | Isolation de la base de données du navigateur |
| Cache | Isolation du cache HTTP |
Exemple
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
// 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
// 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.
Autres extensionsL'isolation des tests est le comportement par défaut de Playwright ; chaque
test()`test` obtient automatiquement une instance indépendante depageetcontext`BrowserContext`, sans nécessiter de configuration supplémentaire.