Tests Playwright
Ce chapitre vous guide dans l'écriture et l'exécution de votre premier test Playwright, en vous aidant à comprendre les composants de base et le flux d'exécution d'un test.
Exécuter le test d'exemple
Après avoir initialisé le projet, exécutez d'abord le test d'exemple généré automatiquement pour vous assurer que tout fonctionne :
# 运行所有测试 npx playwright test
Après l'avoir exécuté, vous verrez une sortie similaire à la suivante :
Running 6 tests using 4 workers ✓ 1 [chromium] › tests/example.spec.ts:3:1 › has title (2.1s) ✓ 2 [chromium] › tests/example.spec.ts:10:1 › get started link (1.8s) ✓ 3 [firefox] › tests/example.spec.ts:3:1 › has title (1.9s) ✓ 4 [firefox] › tests/example.spec.ts:10:1 › get started link (1.7s) ✓ 5 [webkit] › tests/example.spec.ts:3:1 › has title (2.3s) ✓ 6 [webkit] › tests/example.spec.ts:10:1 › get started link (2.0s) 6 passed (12s)
D'après la sortie, vous pouvez voir : les tests ont exécuté 2 tests sur chacun des 3 navigateurs, pour un total de 6 tests, tous réussis.
Créez votre premier fichier de test
Clairtests/example.spec.tsle contenu, et écrivons un test à partir de zéro.
Exemple
import { test, expect } from '@playwright/test';
// test(name, callback) définit un test
// name : le nom du test, affiché dans le rapport de test
// Le paramètre de callback { page } est une fixture fournie par Playwright
test('Visiter la page d'accueil EXAMPLE et vérifier le titre', async ({ page }) => {
// Naviguer vers l'URL spécifiée
await page.goto('https://www.example.com/');
// Assertion : le titre de la page contient "EXAMPLE"
await expect(page).toHaveTitle(/EXAMPLE/);
});
Exécuter ce test :
npx playwright test tests/first-test.spec.ts
Sortie attendue :
Running 1 test using 1 worker ✓ 1 [chromium] › tests/first-test.spec.ts:4:1 › 访问 EXAMPLE 首页并检查标题 (2.5s) 1 passed (2.5s)
Explication détaillée de la fonction test()
test()C'est la fonction principale de Playwright Test, utilisée pour définir un cas de test.
Syntaxe de base
Exemple
// test(test name, test function)
test('Nom descriptif du test', async ({ page }) => {
// Opérations dans le test
await page.goto('https://example.com');
// Assertions dans le test
await expect(page).toHaveTitle(/Example/);
});
Description des paramètres
| Paramètre | Type | Description |
|---|---|---|
| Premier paramètre (nom du test) | string | Le nom descriptif du test, affiché dans les rapports de test et les journaux. |
| Deuxième paramètre (fonction de test) | async (fixtures) => {} | Une fonction asynchrone contenant la logique de test réelle. |
Qu'est-ce que la fixture page ?
{ page }C'est celle qui se trouve dans les paramètres de la fonction de testaffectation par déstructurationelle est extraite de l'objet fixture fourni par Playwrightpage。
pageest unobjet Pagereprésentant un onglet de navigateur.
Chaque test a sa proprepageinstance indépendante :
| fixture | Type | Description |
|---|---|---|
page | Objet Page | Onglet de navigateur indépendant, utilisé pour la navigation, les actions et les assertions |
context | Objet BrowserContext | Contexte de navigateur, gère les cookies, le stockage, etc. |
browser | Objet Browser | Instance de navigateur, rarement utilisée directement |
request | Objet APIRequestContext | Utilisé pour envoyer des requêtes HTTP (pas via le navigateur) |
Le plus couramment utilisé estpage, la grande majorité des opérations sont effectuées via celui-ci.
navigation page.goto()
page.goto(url)Il s'agit de l'une des opérations les plus élémentaires de Playwright, utilisée pour naviguer vers une URL spécifiée.
Exemple
await page.goto('https://www.example.com/');
// Navigation avec options
await page.goto('https://www.example.com/', {
// Attendre que l'événement 'load' se déclenche (valeur par défaut)
waitUntil: 'load',
// Délai d'expiration de l'opération (millisecondes)
timeout: 30000,
// Référent (en-tête Referer)
referer: 'https://www.google.com/',
});
waitUntilL'option a trois valeurs possibles :
| Valeur | Signification | Scénario d'application |
|---|---|---|
'load' | Attendre que l'événement load se déclenche | Valeur par défaut, adaptée à la plupart des pages |
'domcontentloaded' | Attendre l'événement DOMContentLoaded | Il vous suffit que la structure de base de la page soit chargée |
'networkidle' | Attendez que le réseau soit inactif (aucune nouvelle requête pendant 500ms) | Lorsque vous devez attendre que toutes les données asynchrones soient chargées |
Dans la grande majorité des cas, utilisez la valeur par défaut
'load'et c'est tout. Le mécanisme d'attente automatique de Playwright gérera les problèmes de disponibilité des éléments suivants, il n'est donc pas nécessaire d'utiliser'networkidle'。
les assertions expect()
expect()Il s'agit de la méthode d'assertion de Playwright, utilisée pour vérifier si les résultats des tests correspondent aux attentes.
Exemple
await expect(page).toHaveTitle(/EXAMPLE/);
// Assertion sur l'URL de la page
await expect(page).toHaveURL('https://www.example.com/');
// Assertion de visibilité d'élément
await expect(page.getByText('EXAMPLE')).toBeVisible();
Les assertions de Playwright ont une caractéristique clé :le réessai automatique。
Si la condition d'assertion n'est pas satisfaite temporairement, Playwright continuera de réessayer jusqu'à ce que la condition soit satisfaite ou qu'un délai d'attente se produise.
Cela signifie que vous n'avez pas besoin d'écrirewaitForousleeppour attendre que la page soit prête.
Le modèle async/await dans les tests
Toutes les opérations Playwright sont asynchrones, donc les fonctions de test doivent être déclarées commeasync。
Toutes les opérations du navigateur (goto、click、filletc.) et les assertions (expect) doivent utiliserawaitle(s) mot(s)-clé(s).
Exemple
test('Exemple correct', async ({ page }) => {
await page.goto('https://www.example.com/');
await expect(page).toHaveTitle(/EXAMPLE/);
});
// Manière incorrecte (await manquant)
test('Exemple incorrect', async ({ page }) => {
page.goto('https://www.example.com/'); // Pas d'await !
expect(page).toHaveTitle(/EXAMPLE/); // Pas d'await !
});
Si vous oubliez d'écrire
await, le test peut effectuer une assertion au mauvais moment, ce qui peut causer de l'instabilité ou des réussites accidentelles. Assurez-vous de l'ajouter chaque fois que vous appelez l'API Playwrightawait。
Comprendre la sortie de test
Regardons un autre test avec une assertion en échec pour comprendre la sortie de test :
Exemple
import { test, expect } from '@playwright/test';
test('Un test délibérément en échec', async ({ page }) => {
await page.goto('https://www.example.com/');
// Vérifier que le titre contient un contenu inexistant ; l'échec est attendu
await expect(page).toHaveTitle(/non-existent text/);
});
Après l'exécution, la sortie ressemble à peu près à ceci :
Running 1 test using 1 worker
✘ 1 [chromium] › tests/fail-demo.spec.ts:4:1 › 一个故意失败的测试 (5.2s)
1 failed
tests/fail-demo.spec.ts:4:1 › 一个故意失败的测试
En même temps, un rapport HTML s'ouvrira automatiquement, affichant des informations détaillées sur l'échec et des captures d'écran d'erreur.
Autres extensions