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

// Chemin du fichier : tests/first-test.spec.ts
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

import { test, expect } from '@playwright/test';

// 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ètreTypeDescription
Premier paramètre (nom du test)stringLe 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 :

fixtureTypeDescription
pageObjet PageOnglet de navigateur indépendant, utilisé pour la navigation, les actions et les assertions
contextObjet BrowserContextContexte de navigateur, gère les cookies, le stockage, etc.
browserObjet BrowserInstance de navigateur, rarement utilisée directement
requestObjet APIRequestContextUtilisé 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

// Utilisation de base
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 :

ValeurSignificationScénario d'application
'load'Attendre que l'événement load se déclencheValeur par défaut, adaptée à la plupart des pages
'domcontentloaded'Attendre l'événement DOMContentLoadedIl 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

// Assertion sur le titre de la page
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

// Manière correcte
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'écrireawait, 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

// Chemin du fichier : tests/fail-demo.spec.ts
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