Boostez vos ETests avec l'intégration de Playwright et Cucumber

Introduction

Dans cet article, je vais vous expliquer pourquoi Playwright et Cucumber sont des outils exceptionnels pour les tests de bout en bout (E2E). Nous aborderons ensuite les étapes d'intégration de Playwright pour une utilisation transparente dans une application frontale JavaScript. Enfin, je partagerai quelques conseils de pro pour maximiser votre efficacité avec Playwright.

Pourquoi Dramaturge et Concombre ?

Bien qu'il existe de nombreux outils performants pour créer des suites de tests E2E, aucun n'égale la synergie de Playwright et Cucumber.

Voici pourquoi Playwright se démarque sur le marché pour écrire des tests E2E, pour n'en nommer que quelques-uns :

• 1. N'importe quel navigateur, n'importe quelle plateforme, une seule API
  • a. Multi-navigateur. Playwright prend en charge tous les moteurs de rendu modernes, notamment Chromium, WebKit et Firefox.
  • b. Multiplateforme. Testez sur Windows, Linux et macOS, localement ou sur CI, sans tête ou avec tête.
  • c. Multilingue. Utilisez l'API Playwright dans TypeScript, JavaScript, Python, .NET et Java.
• 2. Résilient, pas de tests floconneux
  • a. Attente automatique. Le dramaturge attend que les éléments soient exploitables avant d'effectuer des actions.
  • b. Affirmations axées sur le Web. Les affirmations du dramaturge sont créées spécifiquement pour le Web dynamique.
• 3. Outillage puissant
  • a. Codegen. Générez des tests en enregistrant vos actions. Enregistrez-les dans n'importe quelle langue.
  • b. Inspecteur dramaturge. Inspectez la page, générez des sélecteurs, parcourez l'exécution du test, consultez les points de clic et explorez les journaux d'exécution.

Cependant, sans Cucumber, la gestion du code de test peut devenir un cauchemar de maintenance. Cucumber facilite la rédaction des tests dans un langage simple et lisible par l'homme, les rendant accessibles même aux parties prenantes non techniques. En tant que pierre angulaire du développement piloté par le comportement (BDD), Cucumber fait office de documentation technique et accélère l'intégration des nouveaux ingénieurs.

Intégration du dramaturge et du concombre

Étape 1 : Installer les dépendances

Installez les packages nécessaires à l'aide de npm ou de fil.

npm install @playwright/test playwright-core @cucumber/cucumber cucumber-html-reporter concurrently

Étape 2 : Configurer la structure du projet

Organisez votre projet comme ceci :

cucumber.js
cucumber.report.js
/e2e
  /features
    example.feature
  /steps
    example.steps.js

Étape 3 : Configurer le concombre

Créez un fichier de configuration Cucumber - fichier concombre.js à la racine de votre projet avec le contenu suivant :

// filepath: /cucumber.js
module.exports = {
  default: {
    require: ["./steps/**/*.js"],
    format: ["pretty"],
    paths: ["./features/**/*.feature"],
  },
};

Étape 4 : Configurer les rapports de test

Créer concombre.report.js - Un fichier pour configurer le rapport de test. Les options de configuration peuvent être trouvées ici

// filepath: /cucumber.report.js
import reporter from 'cucumber-html-reporter

const options = {
  theme: 'bootstrap',
  output: report/report.html',
  jsonFile: 'report/report.json',
  brandTitle: 'E2E Test Report'
};

Étape 5 : écrire un fichier de fonctionnalités

Créez un fichier de fonctionnalités dans le répertoire des fonctionnalités, par exemple, example.feature :

npm install @playwright/test playwright-core @cucumber/cucumber cucumber-html-reporter concurrently

Étape 6 : Rédiger les définitions des étapes

Créez un fichier de définition d'étape dans le répertoire steps, par exemple, example.steps.js :

cucumber.js
cucumber.report.js
/e2e
  /features
    example.feature
  /steps
    example.steps.js

Étape 7 : Ajouter un script de test NPM

Ajoutez un script à votre package.json pour exécuter les tests :

// filepath: /cucumber.js
module.exports = {
  default: {
    require: ["./steps/**/*.js"],
    format: ["pretty"],
    paths: ["./features/**/*.feature"],
  },
};

simultanément, le package npm est un outil pratique qui vous permet d'exécuter deux processus lors du même test, car pour exécuter le test E2E, vous devrez également exécuter l'application, parfois localement et parfois à distance.

Étape 8 : Exécuter des tests

Exécuter des tests avec :

// filepath: /cucumber.report.js
import reporter from 'cucumber-html-reporter

const options = {
  theme: 'bootstrap',
  output: report/report.html',
  jsonFile: 'report/report.json',
  brandTitle: 'E2E Test Report'
};

Conseils de pro pour les dramaturges

• 1. Messages d'erreur : lisez-les attentivement : ils identifient souvent le problème.
• 2. Développement itératif – Testez de petits morceaux de code pour isoler et résoudre les problèmes.
• 3. Playwright Inspector - Il peut aider à enregistrer des actions et à générer automatiquement des scripts de test, il faudrait donc écrire simplement un morceau de code. Vous pouvez lancer Playwright Inspector comme ci-dessous

// filepath: /e2e/features/example.feature
Feature: Example feature

  Scenario: Open a webpage
    Given I open the "https://example.com" page
    Then the title should be "Example.com"

• 4. Messages de la console de journalisation - Imprimez le message de la console du navigateur en mode sans tête comme ci-dessous

// filepath: /e2e/steps/example.steps.js
import { Before, Given, Then, setDefaultTimeout, After } from '@cucumber/cucumber';
import { chromium, expect } from 'playwright';

setDefaultTimeout(30 * 1000); //milliseconds
let browser, page, context;

Before(async function(){
  browser = await chromium.launch({headless: true});
  context = await brwoser.newContext();
  page = await content.newPage();
});

Given('I open the {string} page', async function (url) {
  await page.goto(url);
});

Then('the title should be {string}', async function (title) {
  const pageTitle = await page.title();
  expect(pageTitle).toHaveText(title);
});

After(async function(){
  await context.close();
  await browser.close();
});

• 5. Gérer le chargement paresseux - Pour les éléments de chargement paresseux, utilisez les fonctions suivantes
  • a. waitForSelector ou waitFor
  • b. waitForTimeout
  • c. scrollIntoViewIfNeeded
• 6. Déboguer DOM - Utilisez document.querySelector ou un autre sélecteur de requête dans la console du navigateur pour localiser les éléments
• 7. Capturez une capture d'écran de l'échec

Si vous êtes arrivé ici, alors j'ai fait un effort satisfaisant pour vous continuer à lire. N'hésitez pas à laisser des commentaires ou à partager des corrections.

Mes autres blogs :

• Intégrer le composant Web/MFE avec du HTML statique simple
• Entretiens de génie logiciel de crackage
• Mon expérience directe avec les composants Web – apprentissages et limites
• Cadre de décision micro-frontend
• Tester le service Web SOAP à l'aide de Postman Tool

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!